From 39de0f69be4bd422b18019e4832fddfc17a70bcc Mon Sep 17 00:00:00 2001 From: gwx <2844905945@qq.com> Date: Thu, 7 Dec 2023 20:40:41 +0800 Subject: [PATCH] =?UTF-8?q?NoteEditActivity.java:=E5=89=8D=E4=B8=80?= =?UTF-8?q?=E6=AC=A1=E6=8F=90=E4=BA=A4=E5=A4=B1=E8=AF=AF=20doc/=E5=B0=8F?= =?UTF-8?q?=E7=B1=B3=E4=BE=BF=E7=AD=BEsrc=E4=BB=A3=E7=A0=81=E7=BB=93?= =?UTF-8?q?=E6=9E=84=E4=B8=8E=E5=8A=9F=E8=83=BD=E7=95=A5=E8=A1=A8.xlsx:?= =?UTF-8?q?=E6=BA=90=E4=BB=A3=E7=A0=81=E7=BB=93=E6=9E=84=E4=B8=8E=E5=8A=9F?= =?UTF-8?q?=E8=83=BD=E5=88=9D=E6=9E=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...便签src代码结构与功能略表.xlsx | Bin 0 -> 10691 bytes .../net/micode/notes/ui/NoteEditActivity.java | 204 ++++++++++++++---- 2 files changed, 167 insertions(+), 37 deletions(-) create mode 100644 doc/小米便签src代码结构与功能略表.xlsx diff --git a/doc/小米便签src代码结构与功能略表.xlsx b/doc/小米便签src代码结构与功能略表.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..ab80de34a883846ec4bec08de2c7241d8874b753 GIT binary patch literal 10691 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 literal 0 HcmV?d00001 diff --git a/src/src/net/micode/notes/ui/NoteEditActivity.java b/src/src/net/micode/notes/ui/NoteEditActivity.java index 96a9ff8..54394f0 100644 --- a/src/src/net/micode/notes/ui/NoteEditActivity.java +++ b/src/src/net/micode/notes/ui/NoteEditActivity.java @@ -74,6 +74,8 @@ import java.util.regex.Pattern; public class NoteEditActivity extends Activity implements OnClickListener, NoteSettingChangedListener, OnTextViewChangeListener { + //该类主要针对标签编辑 + //继承了系统内部和监听有关的类 private class HeadViewHolder { public TextView tvModified; @@ -86,11 +88,13 @@ public class NoteEditActivity extends Activity implements OnClickListener, private static final Map sBgSelectorBtnsMap = new HashMap(); static { + //使用Map实现数据存储 sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW); sBgSelectorBtnsMap.put(R.id.iv_bg_red, ResourceParser.RED); sBgSelectorBtnsMap.put(R.id.iv_bg_blue, ResourceParser.BLUE); sBgSelectorBtnsMap.put(R.id.iv_bg_green, ResourceParser.GREEN); sBgSelectorBtnsMap.put(R.id.iv_bg_white, ResourceParser.WHITE); + //put函数把指定值和指定键相连 } private static final Map sBgSelectorSelectionMap = new HashMap(); @@ -123,19 +127,27 @@ public class NoteEditActivity extends Activity implements OnClickListener, private HeadViewHolder mNoteHeaderHolder; private View mHeadViewPanel; + //私有化界面操作mHeadViewPanel（对表头的操作） private View mNoteBgColorSelector; + //私有化界面操作mNoteBgColorSelector（对背景颜色的操作） private View mFontSizeSelector; + //私有化界面操作mFontSizeSelector（对标签字体的操作） private EditText mNoteEditor; private View mNoteEditorPanel; + //私有化界面操作mNoteEditorPanel（文本编辑的控制板） private WorkingNote mWorkingNote; + //初始化模板WorkingNote private SharedPreferences mSharedPrefs; + //私有化SharedPreferences的数据存储方式 + //它的本质是基于XML文件存储key-value键值对数据 private int mFontSizeId; + //用于操作字体的大小 private static final String PREFERENCE_FONT_SIZE = "pref_font_size"; @@ -145,6 +157,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, public static final String TAG_UNCHECKED = String.valueOf('\u25A1'); private LinearLayout mEditTextList; + //线性布局 private String mUserQuery; private Pattern mPattern; @@ -153,7 +166,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); this.setContentView(R.layout.note_edit); - + //访问数据库 if (savedInstanceState == null && !initActivityState(getIntent())) { finish(); return; @@ -176,7 +189,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, return; } Log.d(TAG, "Restoring from killed activity"); - } + }//为防止内存不足时程序的终止，在此处保存现场 } private boolean initActivityState(Intent intent) { @@ -188,34 +201,40 @@ public class NoteEditActivity extends Activity implements OnClickListener, if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) { long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0); mUserQuery = ""; - + //如果用户实例化标签时，系统并未给出标签ID /** * Starting from the searched result */ + //根据键值查找ID if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) { noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY)); mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY); } - + //如果ID在数据库中未找到 if (!DataUtils.visibleInNoteDatabase(getContentResolver(), noteId, Notes.TYPE_NOTE)) { Intent jump = new Intent(this, NotesListActivity.class); - startActivity(jump); + startActivity(jump);//程序将跳转到上面声明的Intent jump showToast(R.string.error_note_not_exist); finish(); return false; - } else { + } //如果ID在数据库中找到 + else { mWorkingNote = WorkingNote.load(this, noteId); if (mWorkingNote == null) { - Log.e(TAG, "load note failed with note id" + noteId); + Log.e(TAG, "load note failed with note id" + noteId);//打印出红色的错误信息 finish(); return false; } } + //setSoftInputMode软键盘输入模式 getWindow().setSoftInputMode( WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN | WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE); } else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) { // New note + // intent.getAction() + // 大多用于broadcast时给intent设置一个action + // 用户可以通过receive intent，通过getAction得到的字符串，来决定操作 long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0); int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID); @@ -224,6 +243,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, ResourceParser.getDefaultBgId(this)); + // intent.getInt（Long、String）Extra是对各变量的语法分析 // Parse call-record note String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER); long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE, 0); @@ -240,15 +260,17 @@ public class NoteEditActivity extends Activity implements OnClickListener, finish(); return false; } - } else { + } //将电话号码与手机的号码簿相关 + else { mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, widgetType, bgResId); mWorkingNote.convertToCallNote(phoneNumber, callDate); } - } else { + } + else { mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, widgetType, bgResId); - } + }//创建一个新的WorkingNote getWindow().setSoftInputMode( WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE @@ -269,8 +291,10 @@ public class NoteEditActivity extends Activity implements OnClickListener, } private void initNoteScreen() { + //界面初始化 mNoteEditor.setTextAppearance(this, TextAppearanceResources .getTexAppearanceResource(mFontSizeId)); + //设置外观 if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { switchToListMode(mWorkingNote.getContent()); } else { @@ -294,18 +318,18 @@ public class NoteEditActivity extends Activity implements OnClickListener, */ showAlertHeader(); } - + //设置闹钟的显示 private void showAlertHeader() { if (mWorkingNote.hasClockAlert()) { long time = System.currentTimeMillis(); - if (time > mWorkingNote.getAlertDate()) { + if (time > mWorkingNote.getAlertDate()) { //如果系统时间大于闹钟设置时间，闹钟失效 mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired); } else { mNoteHeaderHolder.tvAlertDate.setText(DateUtils.getRelativeTimeSpanString( mWorkingNote.getAlertDate(), time, DateUtils.MINUTE_IN_MILLIS)); } mNoteHeaderHolder.tvAlertDate.setVisibility(View.VISIBLE); - mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE); + mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE);//显示闹钟开启的图标 } else { mNoteHeaderHolder.tvAlertDate.setVisibility(View.GONE); mNoteHeaderHolder.ivAlertIcon.setVisibility(View.GONE); @@ -326,6 +350,8 @@ public class NoteEditActivity extends Activity implements OnClickListener, * generate a id. If the editing note is not worth saving, there * is no id which is equivalent to create new note */ + //在创建新的标签时，先在数据库中匹配 + //如果不存在，那么在数据库中存储 if (!mWorkingNote.existInDatabase()) { saveNote(); } @@ -334,21 +360,23 @@ public class NoteEditActivity extends Activity implements OnClickListener, } @Override + //MotionEvent是对屏幕触控的传递机制 public boolean dispatchTouchEvent(MotionEvent ev) { if (mNoteBgColorSelector.getVisibility() == View.VISIBLE && !inRangeOfView(mNoteBgColorSelector, ev)) { mNoteBgColorSelector.setVisibility(View.GONE); return true; - } + }//颜色选择器在屏幕上可见 if (mFontSizeSelector.getVisibility() == View.VISIBLE && !inRangeOfView(mFontSizeSelector, ev)) { mFontSizeSelector.setVisibility(View.GONE); return true; - } + }//字体大小选择器在屏幕上可见 return super.dispatchTouchEvent(ev); } + //对屏幕触控的坐标进行操作 private boolean inRangeOfView(View view, MotionEvent ev) { int []location = new int[2]; view.getLocationOnScreen(location); @@ -357,7 +385,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, if (ev.getX() < x || ev.getX() > (x + view.getWidth()) || ev.getY() < y - || ev.getY() > (y + view.getHeight())) { + || ev.getY() > (y + view.getHeight())) {//如果触控的位置超出了给定的范围，返回false return false; } return true; @@ -377,13 +405,13 @@ public class NoteEditActivity extends Activity implements OnClickListener, for (int id : sBgSelectorBtnsMap.keySet()) { ImageView iv = (ImageView) findViewById(id); iv.setOnClickListener(this); - } + }//初始化标签属性内容 mFontSizeSelector = findViewById(R.id.font_size_selector); for (int id : sFontSizeBtnsMap.keySet()) { View view = findViewById(id); view.setOnClickListener(this); - }; + };//选择字体大小 mSharedPrefs = PreferenceManager.getDefaultSharedPreferences(this); mFontSizeId = mSharedPrefs.getInt(PREFERENCE_FONT_SIZE, ResourceParser.BG_DEFAULT_FONT_SIZE); /** @@ -406,6 +434,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, clearSettingState(); } + //和桌面小工具的同步 private void updateWidget() { Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE); if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) { @@ -481,6 +510,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, } @Override + //准备选择菜单 public boolean onPrepareOptionsMenu(Menu menu) { if (isFinishing()) { return true; @@ -489,6 +519,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, menu.clear(); if (mWorkingNote.getFolderId() == Notes.ID_CALL_RECORD_FOLDER) { getMenuInflater().inflate(R.menu.call_note_edit, menu); + // MenuInflater用来实例化Menu目录下的Menu布局文件 } else { getMenuInflater().inflate(R.menu.note_edit, menu); } @@ -506,45 +537,67 @@ public class NoteEditActivity extends Activity implements OnClickListener, } @Override + //动态改变菜单选项内容 public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { + //根据菜单id来编辑相关项目 case R.id.menu_new_note: + //创建便签 createNewNote(); break; case R.id.menu_delete: + //删除便签 AlertDialog.Builder builder = new AlertDialog.Builder(this); + //创建关于删除操作的对话框 builder.setTitle(getString(R.string.alert_title_delete)); + // 设置标签的标题为alert_title_delete builder.setIcon(android.R.drawable.ic_dialog_alert); + //设置对话框图标 builder.setMessage(getString(R.string.alert_message_delete_note)); + //设置对话框内容 builder.setPositiveButton(android.R.string.ok, - new DialogInterface.OnClickListener() { + new DialogInterface.OnClickListener()//建立按键监听器 + { public void onClick(DialogInterface dialog, int which) { + // 点击所触发事件 + // 删除当前便签 deleteCurrentNote(); finish(); } }); builder.setNegativeButton(android.R.string.cancel, null); + //添加否定按钮 builder.show(); + //显示对话框 break; case R.id.menu_font_size: + //字体大小的编辑 mFontSizeSelector.setVisibility(View.VISIBLE); + // 将字体选择器置为可见 findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE); + // 通过id找到相应的大小 break; case R.id.menu_list_mode: + //选择列表模式 mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ? TextNote.MODE_CHECK_LIST : 0); break; case R.id.menu_share: + //菜单共享 getWorkingText(); sendTo(this, mWorkingNote.getContent()); + // 用SendTo函数将运行文本发送到遍历的本文内 break; case R.id.menu_send_to_desktop: + //发送到桌面 sendToDesktop(); break; case R.id.menu_alert: + //创建提醒器 setReminder(); break; case R.id.menu_delete_remind: + //删除日期提醒 mWorkingNote.setAlertDate(0, false); break; default: @@ -553,13 +606,17 @@ public class NoteEditActivity extends Activity implements OnClickListener, return true; } + //建立事件提醒器 private void setReminder() { DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis()); + // 建立修改时间日期的对话框 d.setOnDateTimeSetListener(new OnDateTimeSetListener() { public void OnDateTimeSet(AlertDialog dialog, long date) { mWorkingNote.setAlertDate(date , true); + //选择提醒的日期 } }); + //建立时间日期的监听器 d.show(); } @@ -567,85 +624,112 @@ public class NoteEditActivity extends Activity implements OnClickListener, * Share note to apps that support {@link Intent#ACTION_SEND} action * and {@text/plain} type */ + //共享便签 private void sendTo(Context context, String info) { Intent intent = new Intent(Intent.ACTION_SEND); + //建立intent链接选项 intent.putExtra(Intent.EXTRA_TEXT, info); + //将需要传递的便签信息放入text文件中 intent.setType("text/plain"); + //编辑连接器的类型 context.startActivity(intent); + //在acti中进行链接 } + //创建一个新的便签 private void createNewNote() { // Firstly, save current editing notes + //保存当前便签 saveNote(); // For safety, start a new NoteEditActivity finish(); Intent intent = new Intent(this, NoteEditActivity.class); + //设置链接器 intent.setAction(Intent.ACTION_INSERT_OR_EDIT); + //该活动定义为创建或编辑 intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mWorkingNote.getFolderId()); + //将运行便签的id添加到INTENT_EXTRA_FOLDER_ID标记中 startActivity(intent); + //开始activity并链接 } + //删除当前便签 private void deleteCurrentNote() { - if (mWorkingNote.existInDatabase()) { + if (mWorkingNote.existInDatabase()) //假如当前运行的便签内存有数据 + { HashSet ids = new HashSet(); long id = mWorkingNote.getNoteId(); if (id != Notes.ID_ROOT_FOLDER) { - ids.add(id); + ids.add(id);//如果不是头文件夹建立一个hash表把便签id存起来 } else { - Log.d(TAG, "Wrong note id, should not happen"); + Log.d(TAG, "Wrong note id, should not happen");//否则报错 } if (!isSyncMode()) { + //非同步模式 + //删除操作 if (!DataUtils.batchDeleteNotes(getContentResolver(), ids)) { Log.e(TAG, "Delete Note error"); } } else { + //同步模式 + //移动至垃圾文件夹的操作 if (!DataUtils.batchMoveToFolder(getContentResolver(), ids, Notes.ID_TRASH_FOLER)) { Log.e(TAG, "Move notes to trash folder error, should not happens"); } } } mWorkingNote.markDeleted(true); + //将这些标签的删除标记置为true } - private boolean isSyncMode() { + //判断是否为同步模式 + private boolean isSyncMode() {//查看NotesPreferenceActivity中同步名称是否为空 return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0; } + //设置提醒时间 public void onClockAlertChanged(long date, boolean set) { /** * User could set clock to an unsaved note, so before setting the * alert clock, we should save the note first */ if (!mWorkingNote.existInDatabase()) { + //首先保存已有的便签 saveNote(); } if (mWorkingNote.getNoteId() > 0) { Intent intent = new Intent(this, AlarmReceiver.class); intent.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mWorkingNote.getNoteId())); + //若有有运行的便签就是建立一个链接器将标签id都存在uri中 PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0, intent, 0); AlarmManager alarmManager = ((AlarmManager) getSystemService(ALARM_SERVICE)); + //设置提醒管理器 showAlertHeader(); if(!set) { alarmManager.cancel(pendingIntent); } else { alarmManager.set(AlarmManager.RTC_WAKEUP, date, pendingIntent); } + //如果用户设置了时间，就通过提醒管理器设置一个监听事项 } else { /** * There is the condition that user has input nothing (the note is * not worthy saving), we have no note id, remind the user that he * should input something */ + //没有运行的便签就报错 Log.e(TAG, "Clock alert setting error"); showToast(R.string.error_note_empty_for_clock); } } + //Widget发生改变的所触发的事件 public void onWidgetChanged() { updateWidget(); - } + }//更新Widget + //删除编辑文本框所触发的事件 public void onEditTextDelete(int index, String text) { int childCount = mEditTextList.getChildCount(); if (childCount == 1) { @@ -654,10 +738,11 @@ public class NoteEditActivity extends Activity implements OnClickListener, for (int i = index + 1; i < childCount; i++) { ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text)) - .setIndex(i - 1); + .setIndex(i - 1);//通过id把编辑框存在便签编辑框中 } mEditTextList.removeViewAt(index); + //删除特定位置的视图 NoteEditText edit = null; if(index == 0) { edit = (NoteEditText) mEditTextList.getChildAt(0).findViewById( @@ -665,13 +750,14 @@ public class NoteEditActivity extends Activity implements OnClickListener, } else { edit = (NoteEditText) mEditTextList.getChildAt(index - 1).findViewById( R.id.et_edit_text); - } + }//通过id把编辑框存在空的NoteEditText中 int length = edit.length(); edit.append(text); - edit.requestFocus(); - edit.setSelection(length); + edit.requestFocus();//请求优先级 + edit.setSelection(length);//定位到length位置处的条目 } + //进入编辑文本框所触发的事件 public void onEditTextEnter(int index, String text) { /** * Should not happen, check for debug @@ -682,53 +768,66 @@ public class NoteEditActivity extends Activity implements OnClickListener, View view = getListItem(text, index); mEditTextList.addView(view, index); + //建立一个新的视图并添加到编辑文本框内 NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text); - edit.requestFocus(); - edit.setSelection(0); + edit.requestFocus();//请求优先操作 + edit.setSelection(0);//定位到起始位置 for (int i = index + 1; i < mEditTextList.getChildCount(); i++) { ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text)) - .setIndex(i); + .setIndex(i);//遍历子文本框并设置对应对下标 } } + //切换至列表模式 private void switchToListMode(String text) { mEditTextList.removeAllViews(); String[] items = text.split("\n"); int index = 0; + //清空所有视图，初始化下标 for (String item : items) { if(!TextUtils.isEmpty(item)) { mEditTextList.addView(getListItem(item, index)); index++; + //遍历所有文本单元并添加到文本框中 } } mEditTextList.addView(getListItem("", index)); mEditTextList.getChildAt(index).findViewById(R.id.et_edit_text).requestFocus(); - mNoteEditor.setVisibility(View.GONE); - mEditTextList.setVisibility(View.VISIBLE); + mNoteEditor.setVisibility(View.GONE);//便签编辑器不可见 + mEditTextList.setVisibility(View.VISIBLE);//将文本编辑框置为可见 } + //获取高亮效果的反馈情况 private Spannable getHighlightQueryResult(String fullText, String userQuery) { SpannableString spannable = new SpannableString(fullText == null ? "" : fullText); + //新建效果选项 if (!TextUtils.isEmpty(userQuery)) { mPattern = Pattern.compile(userQuery); + //将用户的询问进行解析 Matcher m = mPattern.matcher(fullText); + //建立一个状态机检查Pattern并进行匹配 int start = 0; while (m.find(start)) { spannable.setSpan( new BackgroundColorSpan(this.getResources().getColor( R.color.user_query_highlight)), m.start(), m.end(), Spannable.SPAN_INCLUSIVE_EXCLUSIVE); + //设置背景颜色 start = m.end(); + //跟新起始位置 } } return spannable; } + //获取列表项 private View getListItem(String item, int index) { View view = LayoutInflater.from(this).inflate(R.layout.note_edit_list_item, null); + //创建一个视图 final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text); edit.setTextAppearance(this, TextAppearanceResources.getTexAppearanceResource(mFontSizeId)); + //创建一个文本编辑框并设置可见性 CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item)); cb.setOnCheckedChangeListener(new OnCheckedChangeListener() { public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { @@ -739,8 +838,10 @@ public class NoteEditActivity extends Activity implements OnClickListener, } } }); + //建立一个打钩框并设置监听器 if (item.startsWith(TAG_CHECKED)) { + //选择勾选 cb.setChecked(true); edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG); item = item.substring(TAG_CHECKED.length(), item.length()).trim(); @@ -753,61 +854,79 @@ public class NoteEditActivity extends Activity implements OnClickListener, edit.setOnTextViewChangeListener(this); edit.setIndex(index); edit.setText(getHighlightQueryResult(item, mUserQuery)); + //运行编辑框的监听器对该行为作出反应，并设置下标及文本内容 return view; } + //便签内容发生改变所触发的事件 public void onTextChange(int index, boolean hasText) { if (index >= mEditTextList.getChildCount()) { - Log.e(TAG, "Wrong index, should not happen"); + Log.e(TAG, "Wrong index, should not happen");//越界报错 return; } if(hasText) { mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.VISIBLE); } else { mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.GONE); + //如果内容不为空则将其子编辑框可见性置为可见，否则不可见 } } + //检查模式和列表模式的切换 public void onCheckListModeChanged(int oldMode, int newMode) { if (newMode == TextNote.MODE_CHECK_LIST) { switchToListMode(mNoteEditor.getText().toString()); + //检查模式切换到列表模式 } else { if (!getWorkingText()) { mWorkingNote.setWorkingText(mWorkingNote.getContent().replace(TAG_UNCHECKED + " ", "")); } + //若是获取到文本就改变其检查标记 mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery)); mEditTextList.setVisibility(View.GONE); mNoteEditor.setVisibility(View.VISIBLE); + //修改文本编辑器的内容和可见性 } } + //设置勾选选项表并返回是否勾选的标记 private boolean getWorkingText() { boolean hasChecked = false; + //初始化check标记,默认为false if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { + // 若模式为CHECK_LIST StringBuilder sb = new StringBuilder(); + //创建可变字符串 for (int i = 0; i < mEditTextList.getChildCount(); i++) { View view = mEditTextList.getChildAt(i); + //遍历所有子编辑框的视图 NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text); - if (!TextUtils.isEmpty(edit.getText())) { + if (!TextUtils.isEmpty(edit.getText())) {//若文本不为空 if (((CheckBox) view.findViewById(R.id.cb_edit_item)).isChecked()) { + //该选项框已打钩 sb.append(TAG_CHECKED).append(" ").append(edit.getText()).append("\n"); - hasChecked = true; + hasChecked = true;//扩展字符串为已打钩并把标记置true } else { sb.append(TAG_UNCHECKED).append(" ").append(edit.getText()).append("\n"); + //扩展字符串添加未打钩 } } } mWorkingNote.setWorkingText(sb.toString()); + //利用编辑好的字符串设置运行便签的内容 } else { mWorkingNote.setWorkingText(mNoteEditor.getText().toString()); + // 若不是该模式直接用编辑器中的内容设置运行中标签的内容 } return hasChecked; } + //保存便签 private boolean saveNote() { getWorkingText(); boolean saved = mWorkingNote.saveNote(); + //运行 getWorkingText()之后保存 if (saved) { /** * There are two modes from List view to edit view, open one note, @@ -816,11 +935,13 @@ public class NoteEditActivity extends Activity implements OnClickListener, * new node requires to the top of the list. This code * {@link #RESULT_OK} is used to identify the create/edit state */ + //RESULT_OK是为了识别保存的情况:一是创建后保存，二是修改后保存 setResult(RESULT_OK); } return saved; } + //将便签发送至桌面 private void sendToDesktop() { /** * Before send message to home, we should make sure that current @@ -828,13 +949,15 @@ public class NoteEditActivity extends Activity implements OnClickListener, * save it */ if (!mWorkingNote.existInDatabase()) { - saveNote(); + saveNote();//若不存在数据(新标签)就保存 } if (mWorkingNote.getNoteId() > 0) { Intent sender = new Intent(); Intent shortcutIntent = new Intent(this, NoteEditActivity.class); + //建立发送到桌面的连接器 shortcutIntent.setAction(Intent.ACTION_VIEW); + //链接为一个视图 shortcutIntent.putExtra(Intent.EXTRA_UID, mWorkingNote.getNoteId()); sender.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent); sender.putExtra(Intent.EXTRA_SHORTCUT_NAME, @@ -842,9 +965,12 @@ public class NoteEditActivity extends Activity implements OnClickListener, sender.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, Intent.ShortcutIconResource.fromContext(this, R.drawable.icon_app)); sender.putExtra("duplicate", true); + //将便签的相关信息都添加到要发送的文件里 sender.setAction("com.android.launcher.action.INSTALL_SHORTCUT"); + //设置sneder的行为是发送 showToast(R.string.info_note_enter_desktop); sendBroadcast(sender); + //显示到桌面 } else { /** * There is the condition that user has input nothing (the note is @@ -856,17 +982,21 @@ public class NoteEditActivity extends Activity implements OnClickListener, } } + //编辑小图标的标题 private String makeShortcutIconTitle(String content) { content = content.replace(TAG_CHECKED, ""); content = content.replace(TAG_UNCHECKED, ""); return content.length() > SHORTCUT_ICON_TITLE_MAX_LEN ? content.substring(0, SHORTCUT_ICON_TITLE_MAX_LEN) : content; + //直接设置为content中的内容并返回，有勾选和未勾选2种 } + //显示提示的视图(根据下标显示对应的提示) private void showToast(int resId) { showToast(resId, Toast.LENGTH_SHORT); } + //持续显示提示的视图(根据下标和持续的时间（duration）编辑提示视图并显示) private void showToast(int resId, int duration) { Toast.makeText(this, resId, duration).show(); }