From 3094dd7343092bdff9ab8e7d4243563cd1faa617 Mon Sep 17 00:00:00 2001 From: fxk <1526369056@qq.com> Date: Sun, 16 Apr 2023 09:12:42 +0800 Subject: [PATCH] =?UTF-8?q?=E9=83=A8=E5=88=86=E4=BB=A3=E7=A0=81=E6=B3=A8?= =?UTF-8?q?=E9=87=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../net/micode/notes/ui/NoteEditText.java | 71 ++++++++++++++++--- .../notes/widget/NoteWidgetProvider.java | 10 ++- 2 files changed, 70 insertions(+), 11 deletions(-) diff --git a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NoteEditText.java b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NoteEditText.java index 2afe2a8..ff72da5 100644 --- a/src/Notes-master/app/src/main/java/net/micode/notes/ui/NoteEditText.java +++ b/src/Notes-master/app/src/main/java/net/micode/notes/ui/NoteEditText.java @@ -36,7 +36,7 @@ import net.micode.notes.R; import java.util.HashMap; import java.util.Map; - +//继承edittext，设置便签设置文本框 public class NoteEditText extends EditText { private static final String TAG = "NoteEditText"; private int mIndex; @@ -46,6 +46,8 @@ public class NoteEditText extends EditText { private static final String SCHEME_HTTP = "http:" ; private static final String SCHEME_EMAIL = "mailto:" ; +//定义了一个名为sSchemaActionResMap的静态常量map,构成字符串与整数的映射 +//用于存储电话网站还有邮箱 private static final Map sSchemaActionResMap = new HashMap(); static { sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel); @@ -56,54 +58,69 @@ public class NoteEditText extends EditText { /** * Call by the {@link NoteEditActivity} to delete or add edit text */ + +//在NoteEditActivity中删除或添加文本的操作，可以看做是一个文本是否被变的标记 public interface OnTextViewChangeListener { /** * Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens * and the text is null */ + //在按下删除键且文本为空时删除当前编辑文本 void onEditTextDelete(int index, String text); /** * Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER} * happen */ + //在按下回车键时在当前编辑文本后添加编辑文本 void onEditTextEnter(int index, String text); /** * Hide or show item option when text change - */ + */ + //在文本更改时隐藏或显示项目选项 void onTextChange(int index, boolean hasText); } private OnTextViewChangeListener mOnTextViewChangeListener; + + //根据context设置文本 public NoteEditText(Context context) { super(context, null); + //用super引用父类变量 mIndex = 0; } + //光标设置 public void setIndex(int index) { mIndex = index; } + //初始化文本修改标记 public void setOnTextViewChangeListener(OnTextViewChangeListener listener) { mOnTextViewChangeListener = listener; } + //初始化便签 public NoteEditText(Context context, AttributeSet attrs) { super(context, attrs, android.R.attr.editTextStyle); } + // 根据defstyle自动初始化 public NoteEditText(Context context, AttributeSet attrs, int defStyle) { super(context, attrs, defStyle); // TODO Auto-generated constructor stub } - @Override + @Override + //重写函数 + //view里的函数 public boolean onTouchEvent(MotionEvent event) { - switch (event.getAction()) { + switch (event.getAction()) { + //重写了需要处理屏幕被按下的事 + //改变坐标值 case MotionEvent.ACTION_DOWN: - int x = (int) event.getX(); int y = (int) event.getY(); x -= getTotalPaddingLeft(); @@ -111,9 +128,12 @@ public class NoteEditText extends EditText { x += getScrollX(); y += getScrollY(); + //用布局控件layout根据x,y的新值设置新的位置 Layout layout = getLayout(); int line = layout.getLineForVertical(y); int off = layout.getOffsetForHorizontal(line, x); + + //光标位置更新 Selection.setSelection(getText(), off); break; } @@ -123,7 +143,9 @@ public class NoteEditText extends EditText { @Override public boolean onKeyDown(int keyCode, KeyEvent event) { + //根据按键的 Unicode 编码值来处理 switch (keyCode) { + //更具用户按下的keyCode是进入还是删除来处理事件 case KeyEvent.KEYCODE_ENTER: if (mOnTextViewChangeListener != null) { return false; @@ -135,30 +157,40 @@ public class NoteEditText extends EditText { default: break; } + //继续执行父类的其他点击事件 return super.onKeyDown(keyCode, event); } @Override public boolean onKeyUp(int keyCode, KeyEvent event) { + //根据按键的 Unicode 编码值来处理，有删除和进入2种操作 switch(keyCode) { - case KeyEvent.KEYCODE_DEL: + case KeyEvent.KEYCODE_DEL: + //当按键为删除键时，如果 mOnTextViewChangeListener 不为 null，则会检查当前光标位置是否为0且 mIndex不为0，则调用 if (mOnTextViewChangeListener != null) { if (0 == mSelectionStartBeforeDelete && mIndex != 0) { mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString()); + //利用上文OnTextViewChangeListener对KEYCODE_DEL按键情况的删除函数进行删除 return true; } } else { + //否则，会在日志中输出一条信息，表示文本视图更改监听器未设置。 Log.d(TAG, "OnTextViewChangeListener was not seted"); } break; - case KeyEvent.KEYCODE_ENTER: + case KeyEvent.KEYCODE_ENTER: + //当按键为进入键时 if (mOnTextViewChangeListener != null) { int selectionStart = getSelectionStart(); + //获取当前位置 String text = getText().subSequence(selectionStart, length()).toString(); + //获取当前文本 setText(getText().subSequence(0, selectionStart)); + //根据获取位置设置当前文本 mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text); } else { Log.d(TAG, "OnTextViewChangeListener was not seted"); + //其他情况报错，并输出文档的改动监听器并没有建立 } break; default: @@ -168,30 +200,48 @@ public class NoteEditText extends EditText { } @Override + //焦点变化时处理事件 + //focused表示是否获得焦点 + //direction表示焦点变化的方向 + //previouslyFocusedRect表示之前获得焦点视图的位置 protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) { + if (mOnTextViewChangeListener != null) { + //监听器已经建立 if (!focused && TextUtils.isEmpty(getText())) { + //获取到焦点并且文本不为空 mOnTextViewChangeListener.onTextChange(mIndex, false); + //false则隐藏事件选项 } else { mOnTextViewChangeListener.onTextChange(mIndex, true); + //true则显示事件选项 } } + //继续执行父类的其他焦点变化的事件 super.onFocusChanged(focused, direction, previouslyFocusedRect); } - @Override + @Override + //用于生成上下文菜单 protected void onCreateContextMenu(ContextMenu menu) { + //检查文本 if (getText() instanceof Spanned) { + // 获取选定文本的起始和结束位置 int selStart = getSelectionStart(); int selEnd = getSelectionEnd(); + // 计算选定文本的最小和最大位置 int min = Math.min(selStart, selEnd); int max = Math.max(selStart, selEnd); + // 获取选定文本中的所有 URLSpan final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class); - if (urls.length == 1) { + //如果只有一个URLSpan + if (urls.length == 1) { int defaultResId = 0; + //获取计划表中所有的key值 for(String schema: sSchemaActionResMap.keySet()) { + //若url可以添加则在添加后将defaultResId置为key所映射的值 if(urls[0].getURL().indexOf(schema) >= 0) { defaultResId = sSchemaActionResMap.get(schema); break; @@ -201,7 +251,7 @@ public class NoteEditText extends EditText { if (defaultResId == 0) { defaultResId = R.string.note_link_other; } - + //在菜单中增加选项 menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener( new OnMenuItemClickListener() { public boolean onMenuItemClick(MenuItem item) { @@ -212,6 +262,7 @@ public class NoteEditText extends EditText { }); } } + //执行父类的其他菜单创建事件 super.onCreateContextMenu(menu); } } diff --git a/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider.java b/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider.java index ec6f819..8a1bb35 100644 --- a/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider.java +++ b/src/Notes-master/app/src/main/java/net/micode/notes/widget/NoteWidgetProvider.java @@ -14,6 +14,7 @@ * limitations under the License. */ +// 可以修改 package net.micode.notes.widget; import android.app.PendingIntent; import android.appwidget.AppWidgetManager; @@ -32,6 +33,10 @@ import net.micode.notes.tool.ResourceParser; import net.micode.notes.ui.NoteEditActivity; import net.micode.notes.ui.NotesListActivity; + +//这段代码定义了一个名为NoteWidgetProvider的抽象类，它继承自AppWidgetProvider类。 +//NoteWidgetProvider类定义了一个名为PROJECTION的静态字符串数组，它包含三个元素：NoteColumns.ID、NoteColumns.BG_COLOR_ID和NoteColumns.SNIPPET。 +//这些元素可能用于定义查询数据库时需要返回的列。 public abstract class NoteWidgetProvider extends AppWidgetProvider { public static final String [] PROJECTION = new String [] { NoteColumns.ID, @@ -39,10 +44,13 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider { NoteColumns.SNIPPET }; +//这段代码定义了四个静态常量。前三个常量COLUMN_ID、COLUMN_BG_COLOR_ID和COLUMN_SNIPPET分别被赋值为0、1和2。 +//这些常量可能用于定义查询数据库时需要返回的列的索引。 +//第四个常量TAG被赋值为字符串"NoteWidgetProvider"，它可能用于记录日志时标识日志来源。 public static final int COLUMN_ID = 0; public static final int COLUMN_BG_COLOR_ID = 1; public static final int COLUMN_SNIPPET = 2; - + private static final String TAG = "NoteWidgetProvider"; @Override