ui-笔记编辑文本框注释

src/Notes-master/src/net/micode/notes/ui/NoteEditText.java

@@ -37,15 +37,22 @@ 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;
-    private int mSelectionStartBeforeDelete;
+    private int mIndex; // 当前编辑框在列表中的索引位置
+    private int mSelectionStartBeforeDelete; // 记录删除操作前的光标位置
 
+    // 支持的链接协议
     private static final String SCHEME_TEL = "tel:" ;
     private static final String SCHEME_HTTP = "http:" ;
     private static final String SCHEME_EMAIL = "mailto:" ;
 
+    // 链接协议与菜单项文本资源的映射
     private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();
     static {
         sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel);
@@ -54,38 +61,43 @@ 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;
+    private OnTextViewChangeListener mOnTextViewChangeListener; // 文本变化监听器
 
     public NoteEditText(Context context) {
         super(context, null);
         mIndex = 0;
     }
 
+    /**
+     * 设置编辑框在列表中的索引位置
+     */
     public void setIndex(int index) {
         mIndex = index;
     }
 
+    /**
+     * 设置文本视图变化监听器
+     */
     public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
         mOnTextViewChangeListener = listener;
     }
@@ -96,14 +108,13 @@ public class NoteEditText extends EditText {
 
     public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
         super(context, attrs, defStyle);
-        // TODO Auto-generated constructor stub
     }
 
     @Override
     public boolean onTouchEvent(MotionEvent event) {
         switch (event.getAction()) {
             case MotionEvent.ACTION_DOWN:
-
+                // 计算触摸位置对应的文本偏移量并设置光标位置
                 int x = (int) event.getX();
                 int y = (int) event.getY();
                 x -= getTotalPaddingLeft();
@@ -125,11 +136,13 @@ public class NoteEditText extends EditText {
     public boolean onKeyDown(int keyCode, KeyEvent event) {
         switch (keyCode) {
             case KeyEvent.KEYCODE_ENTER:
+                // 回车键事件处理，由监听器处理
                 if (mOnTextViewChangeListener != null) {
                     return false;
                 }
                 break;
             case KeyEvent.KEYCODE_DEL:
+                // 记录删除操作前的光标位置
                 mSelectionStartBeforeDelete = getSelectionStart();
                 break;
             default:
@@ -142,7 +155,9 @@ public class NoteEditText extends EditText {
     public boolean onKeyUp(int keyCode, KeyEvent event) {
         switch(keyCode) {
             case KeyEvent.KEYCODE_DEL:
+                // 删除键事件处理
                 if (mOnTextViewChangeListener != null) {
+                    // 如果光标在文本开头且不是第一个编辑框，则删除当前编辑框
                     if (0 == mSelectionStartBeforeDelete && mIndex != 0) {
                         mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());
                         return true;
@@ -152,7 +167,10 @@ public class NoteEditText extends EditText {
                 }
                 break;
             case KeyEvent.KEYCODE_ENTER:
+                // 回车键事件处理
                 if (mOnTextViewChangeListener != null) {
+                    // 获取光标位置之后的文本，将当前文本截断到光标位置
+                    // 并在后面添加新的编辑框
                     int selectionStart = getSelectionStart();
                     String text = getText().subSequence(selectionStart, length()).toString();
                     setText(getText().subSequence(0, selectionStart));
@@ -169,6 +187,7 @@ public class NoteEditText extends EditText {
 
     @Override
     protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
+        // 焦点变化时通知监听器文本状态
         if (mOnTextViewChangeListener != null) {
             if (!focused && TextUtils.isEmpty(getText())) {
                 mOnTextViewChangeListener.onTextChange(mIndex, false);
@@ -181,15 +200,19 @@ public class NoteEditText extends EditText {
 
     @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) {
+                // 根据URL协议设置菜单项文本
                 int defaultResId = 0;
                 for(String schema: sSchemaActionResMap.keySet()) {
                     if(urls[0].getURL().indexOf(schema) >= 0) {
@@ -202,10 +225,11 @@ public class NoteEditText extends EditText {
                     defaultResId = R.string.note_link_other;
                 }
 
+                // 添加菜单项并设置点击事件
                 menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener(
                         new OnMenuItemClickListener() {
                             public boolean onMenuItemClick(MenuItem item) {
-                                // goto a new intent
+                                // 打开链接
                                 urls[0].onClick(NoteEditText.this);
                                 return true;
                             }
@@ -214,4 +238,4 @@ public class NoteEditText extends EditText {
         }
         super.onCreateContextMenu(menu);
     }
-}
+}