From 35994ace47214bf8b749c0d1a6dc296b040f6830 Mon Sep 17 00:00:00 2001 From: weichunyi <2948523237@qq.com> Date: Mon, 26 May 2025 14:29:52 +0800 Subject: [PATCH] =?UTF-8?q?ui-=E7=AC=94=E8=AE=B0=E7=BC=96=E8=BE=91?= =?UTF-8?q?=E6=96=87=E6=9C=AC=E6=A1=86=E6=B3=A8=E9=87=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../src/net/micode/notes/ui/NoteEditText.java | 50 ++++++++++++++----- 1 file changed, 37 insertions(+), 13 deletions(-) diff --git a/src/Notes-master/src/net/micode/notes/ui/NoteEditText.java b/src/Notes-master/src/net/micode/notes/ui/NoteEditText.java index 2afe2a8..5f8fb21 100644 --- a/src/Notes-master/src/net/micode/notes/ui/NoteEditText.java +++ b/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 sSchemaActionResMap = new HashMap(); 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); } -} +} \ No newline at end of file