diff --git a/src/标注_杜金洲/NoteEditActivity.java b/src/标注_杜金洲/NoteEditActivity.java index 6be75a1..537dc20 100644 --- a/src/标注_杜金洲/NoteEditActivity.java +++ b/src/标注_杜金洲/NoteEditActivity.java @@ -73,8 +73,8 @@ import java.util.regex.Pattern; public class NoteEditActivity extends Activity implements OnClickListener, -//-̳Activity࣬ӿ3Java޶ؼ̳У -//ҪԱǩı༭ +//-继承Activity类,接口3个方法(Java无多重继承) +//该类主要是针对标签的编辑 NoteSettingChangedListener, OnTextViewChangeListener { private class HeadViewHolder { public TextView tvModified; @@ -85,17 +85,17 @@ public class NoteEditActivity extends Activity implements OnClickListener, public ImageView ibSetBgColor; } -//̳ϵͳڲͼйص +//继承了系统内部许多和监听有关的类 private static final Map sBgSelectorBtnsMap = new HashMap(); - //mapһǼͣڶֵͣinteger + //map其中一个是键的类型,第二个是值的类型,integer类型 static { sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW); - //put() ָļ/ֵԲ뵽 Map Сֵָָ + //put() 方法将指定的键/值对插入到 Map 中。将指定值和指定键相连 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);//Դ. + sBgSelectorBtnsMap.put(R.id.iv_bg_white, ResourceParser.WHITE);//资源解析器.白 } private static final Map sBgSelectorSelectionMap = new HashMap(); @@ -105,7 +105,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, sBgSelectorSelectionMap.put(ResourceParser.BLUE, R.id.iv_bg_blue_select); sBgSelectorSelectionMap.put(ResourceParser.GREEN, R.id.iv_bg_green_select); sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select); - }//ͬ parserselect + }//同上 ,将parser和select 相连 private static final Map sFontSizeBtnsMap = new HashMap(); static { @@ -113,7 +113,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, sFontSizeBtnsMap.put(R.id.ll_font_small, ResourceParser.TEXT_SMALL); sFontSizeBtnsMap.put(R.id.ll_font_normal, ResourceParser.TEXT_MEDIUM); sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER); - }//ͬ + }//同上 private static final Map sFontSelectorSelectionMap = new HashMap(); static { @@ -121,36 +121,36 @@ public class NoteEditActivity extends Activity implements OnClickListener, sFontSelectorSelectionMap.put(ResourceParser.TEXT_SMALL, R.id.iv_small_select); sFontSelectorSelectionMap.put(ResourceParser.TEXT_MEDIUM, R.id.iv_medium_select); sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select); - }//ͬ + }//同上 private static final String TAG = "NoteEditActivity"; private HeadViewHolder mNoteHeaderHolder; - private View mHeadViewPanel;//Viewһǿ϶ԼĿؼViewû(ButtonTextfieldsȵ)Ļࡣ - //˽лһmNoteBgColorSelectorԱɫIJ + private View mHeadViewPanel;//View是一个矩形区域,我们可以在这个区域上定义自己的控件。View是用来构建用户界面组件(Button,Textfields等等)的基类。 + //私有化一个界面操作mNoteBgColorSelector,对背景颜色的操作 private View mFontSizeSelector; - //˽лһmFontSizeSelectorԱǩIJ + //私有化一个界面操作mFontSizeSelector,对标签字体的操作 private EditText mNoteEditor; - //༭ؼı + //声明编辑控件,对文本操作 private View mNoteEditorPanel; - //˽лһmNoteEditorPanelı༭Ŀư + //私有化一个界面操作mNoteEditorPanel,文本编辑的控制板 public WorkingNote mWorkingNote; - //ģWorkingNoteijʼ + //对模板WorkingNote的初始化 private SharedPreferences mSharedPrefs; - //˽лSharedPreferencesݴ洢ʽ + //私有化SharedPreferences的数据存储方式 private int mFontSizeId; - //ڲĴС + //用于操作字体的大小 private static final String PREFERENCE_FONT_SIZE = "pref_font_size"; private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10; - public static final String TAG_CHECKED = String.valueOf('\u221A');//һ - public static final String TAG_UNCHECKED = String.valueOf('\u25A1');// + public static final String TAG_CHECKED = String.valueOf('\u221A');//一个勾 + public static final String TAG_UNCHECKED = String.valueOf('\u25A1');//空心正方形 private LinearLayout mEditTextList; -//Բֻ֣ὫĿؼԷС +//线性布局,这个布局会将它所包含的控件在线性方向上依次排列。 private String mUserQuery; private Pattern mPattern; @@ -158,7 +158,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; @@ -170,20 +170,20 @@ public class NoteEditActivity extends Activity implements OnClickListener, * Current activity may be killed when the memory is low. Once it is killed, for another time * user load this activity, we should restore the former state */ - //ڴ治ʱǰĻܱɱһɱһʱ䣬ûӦûָǰ״̬ + //当内存不足时,当前的活动可能被杀死。一旦它被杀死,对于另一个时间,用户加载这个活动,我们应该恢复以前的状态 @Override protected void onRestoreInstanceState(Bundle savedInstanceState) { super.onRestoreInstanceState(savedInstanceState); if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) { Intent intent = new Intent(Intent.ACTION_VIEW); - //IntentĽ + //Intent用于组件的交互 intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID)); if (!initActivityState(intent)) { finish(); return; } Log.d(TAG, "Restoring from killed activity"); - }//Ϊֹڴ治ʱֹһֳĺ + }//为防止内存不足时程序的终止,在这里有一个保存现场的函数 } private boolean initActivityState(Intent intent) { @@ -191,7 +191,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, * If the user specified the {@link Intent#ACTION_VIEW} but not provided with id, * then jump to the NotesListActivity */ - //ûṩid תNotesListActivity + //没有提供id, 则跳转到NotesListActivity mWorkingNote = null; if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) { long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0); @@ -200,7 +200,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, /** * Starting from the searched result */ - /*ֵIDûҵʾ*/ + /*根据输入键值查找ID,如果没有找到,就显示错误*/ if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) { noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY)); mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY); @@ -223,9 +223,9 @@ public class NoteEditActivity extends Activity implements OnClickListener, getWindow().setSoftInputMode( WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN | WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE); - //|ORһλ1Ϊ1ȫ0Ϊ0 + //|是OR运算符,是一种位符。有1为1,全0为0 } else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) { - // intent.getAction()ͨ getActionõַʲô + // intent.getAction(),通过 getAction得到的字符串,来决定做什么 long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0); int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID); @@ -250,7 +250,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, finish(); return false; } - //绰ֻĺ벾أ mWorkingNote == nullʱʧܣʹһµmworkingnote + //将电话号码与手机的号码簿相关, 当mWorkingNote == null时,加载失败,下面就创建一个新的mworkingnote } else { mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, widgetType, bgResId); @@ -278,7 +278,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, super.onResume(); initNoteScreen(); } -//Խijʼ,۵ +//对界面的初始化操作,设置外观等 private void initNoteScreen() { mNoteEditor.setTextAppearance(this, TextAppearanceResources .getTexAppearanceResource(mFontSizeId)); @@ -303,7 +303,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, * TODO: Add the menu for setting alert. Currently disable it because the DateTimePicker * is not ready */ - //ӵIJ˵ĿǰΪDateTimePickerû׼ + //添加设置闹钟的菜单。目前禁用它是因为DateTimePicker还没有准备好 showAlertHeader(); } @@ -313,7 +313,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, 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)); @@ -323,7 +323,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, } else { mNoteHeaderHolder.tvAlertDate.setVisibility(View.GONE); mNoteHeaderHolder.ivAlertIcon.setVisibility(View.GONE); - };//ӿͼ + };//闹钟开启的图标 } @Override @@ -340,34 +340,34 @@ 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 */ - /*ûбʼID±ʼǣӦȱһID༭ıʼDzֵñ棬 - ൱ڴyһûIDµıʼ*/ + /*对于没有笔记ID的新笔记,我们应该首先保存它以生成一个ID。如果编辑的笔记不值得保存, + 这就相当于创建y一个没有ID新的笔记*/ if (!mWorkingNote.existInDatabase()) { saveNote(); } outState.putLong(Intent.EXTRA_UID, mWorkingNote.getNoteId()); Log.d(TAG, "Save working note id: " + mWorkingNote.getNoteId() + " onSaveInstanceState"); } - //ڴһµıǩʱݿƥ - //ڣôݿд洢 + //在创建一个新的标签时,先在数据库中匹配 + //如果不存在,那么先在数据库中存储 @Override - //MotionEventǶĻصĴݻ + //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); @@ -381,7 +381,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, } return true; } -//صλó˸ķΧfalse +//如果触控的位置超出了给定的范围,返回false private void initResources() { mHeadViewPanel = findViewById(R.id.note_title); mNoteHeaderHolder = new HeadViewHolder(); @@ -396,13 +396,13 @@ public class NoteEditActivity extends Activity implements OnClickListener, for (int id : sBgSelectorBtnsMap.keySet()) { ImageView iv = (ImageView) findViewById(id); iv.setOnClickListener(this); - }//Աǩݵijʼ + }//对标签各项属性内容的初始化 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); /** @@ -410,7 +410,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, * The id may larger than the length of resources, in this case, * return the {@link ResourceParser#BG_DEFAULT_FONT_SIZE} */ - //ƺһ޸idbug + //似乎是一个修复id过长的bug if(mFontSizeId >= TextAppearanceResources.getResourcesSize()) { mFontSizeId = ResourceParser.BG_DEFAULT_FONT_SIZE; } @@ -425,7 +425,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, } clearSettingState(); } - //Сߵͬ + //和桌面小工具的同步 private void updateWidget() { Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE); @@ -490,11 +490,11 @@ public class NoteEditActivity extends Activity implements OnClickListener, } else if (mFontSizeSelector.getVisibility() == View.VISIBLE) { mFontSizeSelector.setVisibility(View.GONE); return true; - }//״̬ɫС + }//清除设置状态,颜色、大小的设置 return false; } - //ѡ˵׼ + //对选择菜单的准备 public void onBackgroundColorChanged() { findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility( View.VISIBLE); @@ -511,7 +511,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ļ + // MenuInflater是用来实例化Menu目录下的Menu布局文件的 } else { getMenuInflater().inflate(R.menu.note_edit, menu); @@ -530,153 +530,153 @@ public class NoteEditActivity extends Activity implements OnClickListener, } @Override - //ܣ̬ı˵ѡ + //函数功能:动态改变菜单选项内容 public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { - //ݲ˵id༭Ŀ + //根据菜单的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_delet + // 设置标签的标题为alert_title_delet 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() { - // + //建立按键监听器 public void onClick(DialogInterface dialog, int which) { - //¼ + //点击所触发事件 deleteCurrentNote(); - // ɾǩǩ + // 删除单签便签 finish(); } }); - builder.setNegativeButton(android.R.string.cancel, null);//yesnoİť - builder.show(); //ʾԻ + builder.setNegativeButton(android.R.string.cancel, null);//添加yes和no的按钮 + builder.show(); //显示对话框 break; - case R.id.menu_font_size: //Сı༭ - mFontSizeSelector.setVisibility(View.VISIBLE);// ѡΪɼ + case R.id.menu_font_size: //字体大小的编辑 + mFontSizeSelector.setVisibility(View.VISIBLE);// 将字体选择器置为可见 findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE); - break; // ͨidҵӦĴС - case R.id.menu_list_mode://ѡбģʽ + break; // 通过id找到相应的大小 + case R.id.menu_list_mode://选择列表模式 mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ? TextNote.MODE_CHECK_LIST : 0); - break;//˵ + break;//菜单共享 case R.id.menu_share: getWorkingText(); sendTo(this, mWorkingNote.getContent()); - // sendtoı͵ı + // 用sendto函数将运行文本发送到遍历的本文内 break; case R.id.menu_send_to_desktop: - sendToDesktop();//͵ + sendToDesktop();//发送到桌面 break; case R.id.menu_alert: - setReminder();// + setReminder();//创建提醒器 break; case R.id.menu_delete_remind: - mWorkingNote.setAlertDate(0, false);//ɾ + mWorkingNote.setAlertDate(0, false);//删除日期提醒 break; default: break; } 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();//ʾԻ + }); //建立时间日期的监听器 + d.show();//显示对话框 } /** * Share note to apps that support {@link Intent#ACTION_SEND} action * and {@text/plain} type */ - //ܣǩ + //函数功能:共享便签 private void sendTo(Context context, String info) { - //intentѡ + //建立intent链接选项 Intent intent = new Intent(Intent.ACTION_SEND); - //ҪݵıǩϢtextļ + //将需要传递的便签信息放入text文件中 intent.putExtra(Intent.EXTRA_TEXT, info); - //༭ + //编辑连接器的类型 intent.setType("text/plain"); - //actiн + //在acti中进行链接 context.startActivity(intent); } -//ܣһµıǩ +//函数功能:创建一个新的便签 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 + //将运行便签的id添加到INTENT_EXTRA_FOLDER_ID标记中 startActivity(intent); - //ʼactivity + //开始activity并链接 } /* - * ܣɾǰǩ - * ʵ֣ע + * 函数功能:删除当前便签 + * 函数实现:如下注释 */ private void deleteCurrentNote() { if (mWorkingNote.existInDatabase()) { - //統ǰеıǩڴ + //假如当前运行的便签内存有数据 HashSet ids = new HashSet(); long id = mWorkingNote.getNoteId(); if (id != Notes.ID_ROOT_FOLDER) { ids.add(id); - //ͷļнһhashѱǩid + //如果不是头文件夹建立一个hash表把便签id存起来 } else { Log.d(TAG, "Wrong note id, should not happen"); - //򱨴 + //否则报错 } if (!isSyncMode()) { - //ڷͬģʽ - //ɾ + //在非同步模式情况下 + //删除操作 if (!DataUtils.batchDeleteNotes(getContentResolver(), ids)) { Log.e(TAG, "Delete Note error"); } } else { - //ͬģʽ - //ƶļеIJ + //同步模式 + //移动至垃圾文件夹的操作 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 + //将这些标签的删除标记置为true } /* - * ܣжǷΪͬģʽ - * ʵֱ֣ӿNotesPreferenceActivityͬǷΪ + * 函数功能:判断是否为同步模式 + * 函数实现:直接看NotesPreferenceActivity中同步名称是否为空 */ private boolean isSyncMode() { return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0; } /* - * ܣʱ - * ʵ֣ע + * 函数功能:设置提醒时间 + * 函数实现:如下注释 */ public void onClockAlertChanged(long date, boolean set) { /** @@ -684,60 +684,60 @@ public class NoteEditActivity extends Activity implements OnClickListener, * 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())); - //еıǩǽһǩiduri + //若有有运行的便签就是建立一个链接器将标签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ı¼ + * 函数功能:Widget发生改变的所触发的事件 */ public void onWidgetChanged() { - updateWidget();//Widget + updateWidget();//更新Widget } /* - * ܣ ɾ༭ı¼ - * ʵ֣ע + * 函数功能: 删除编辑文本框所触发的事件 + * 函数实现:如下注释 */ public void onEditTextDelete(int index, String text) { int childCount = mEditTextList.getChildCount(); if (childCount == 1) { return; } - //ûб༭Ļֱӷ + //没有编辑框的话直接返回 for (int i = index + 1; i < childCount; i++) { ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text)) .setIndex(i - 1); - //ͨidѱ༭ڱǩ༭ + //通过id把编辑框存在便签编辑框中 } mEditTextList.removeViewAt(index); - //ɾضλõͼ + //删除特定位置的视图 NoteEditText edit = null; if(index == 0) { edit = (NoteEditText) mEditTextList.getChildAt(0).findViewById( @@ -746,16 +746,16 @@ public class NoteEditActivity extends Activity implements OnClickListener, edit = (NoteEditText) mEditTextList.getChildAt(index - 1).findViewById( R.id.et_edit_text); } - //ͨidѱ༭ڿյNoteEditText + //通过id把编辑框存在空的NoteEditText中 int length = edit.length(); edit.append(text); - edit.requestFocus();//ɸô ༭ - edit.setSelection(length);//λlengthλôĿ + edit.requestFocus();//请求优先完成该此 编辑 + edit.setSelection(length);//定位到length位置处的条目 } /* - * ܣ༭ı¼ - * ʵ֣ע + * 函数功能:进入编辑文本框所触发的事件 + * 函数实现:如下注释 */ public void onEditTextEnter(int index, String text) { /** @@ -763,84 +763,84 @@ public class NoteEditActivity extends Activity implements OnClickListener, */ if(index > mEditTextList.getChildCount()) { Log.e(TAG, "Index out of mEditTextList boundrary, should not happen"); - //Խżż + //越界把偶偶 } 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); - //ıöӦ± + //遍历子文本框并设置对应对下标 } } /* - * ܣлбģʽ - * ʵ֣ע + * 函数功能:切换至列表模式 + * 函数实现:如下注释 */ 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); - //ı༭Ϊɼ + //将文本编辑框置为可见 } /* - * ܣȡЧķ - * ʵ֣ע + * 函数功能:获取高亮效果的反馈情况 + * 函数实现:如下注释 */ 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ƥ + //建立一个状态机检查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) { @@ -851,15 +851,15 @@ 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(); } else if (item.startsWith(TAG_UNCHECKED)) { - //ѡ񲻹ѡ + //选择不勾选 cb.setChecked(false); edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG); item = item.substring(TAG_UNCHECKED.length(), item.length()).trim(); @@ -868,94 +868,94 @@ 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"); 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 + //初始化check标记 if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { - // ģʽΪ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 (((CheckBox) view.findViewById(R.id.cb_edit_item)).isChecked()) { - //ѡѴ + //该选项框已打钩 sb.append(TAG_CHECKED).append(" ").append(edit.getText()).append("\n"); hasChecked = true; - //չַΪѴ򹳲ѱ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()֮󱣴 + //运行 getWorkingText()之后保存 if (saved) { /** * There are two modes from List view to edit view, open one note, @@ -964,15 +964,15 @@ 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Ϊʶ𱣴2һǴ󱣴棬޸ĺ󱣴 + //如英文注释所说链接RESULT_OK是为了识别保存的2种情况,一是创建后保存,二是修改后保存 setResult(RESULT_OK); } return saved; } /* - * ܣǩ - * ʵ֣ע + * 函数功能:将便签发送至桌面 + * 函数实现:如下注释 */ private void sendToDesktop() { /** @@ -982,16 +982,16 @@ public class NoteEditActivity extends Activity implements OnClickListener, */ if (!mWorkingNote.existInDatabase()) { 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, @@ -999,12 +999,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ΪǷ + //设置sneder的行为是发送 showToast(R.string.info_note_enter_desktop); sendBroadcast(sender); - //ʾ + //显示到桌面 } else { /** * There is the condition that user has input nothing (the note is @@ -1013,36 +1013,35 @@ public class NoteEditActivity extends Activity implements OnClickListener, */ Log.e(TAG, "Send to desktop error"); showToast(R.string.error_note_empty_for_send_to_desktop); - //ձǩֱӱ + //空便签直接报错 } } /* - * ܣ༭Сͼı - * ʵ֣ע + * 函数功能:编辑小图标的标题 + * 函数实现:如下注释 */ 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 + //直接设置为content中的内容并返回,有勾选和未勾选2种 } /* - * ܣʾʾͼ - * ʵ֣±ʾӦʾ + * 函数功能:显示提示的视图 + * 函数实现:根据下标显示对应的提示 */ private void showToast(int resId) { showToast(resId, Toast.LENGTH_SHORT); } /* - * ܣʾʾͼ - * ʵ֣±ͳʱ䣨duration༭ʾͼʾ + * 函数功能:持续显示提示的视图 + * 函数实现:根据下标和持续的时间(duration)编辑提示视图并显示 */ private void showToast(int resId, int duration) { Toast.makeText(this, resId, duration).show(); } } - diff --git a/src/标注_杜金洲/NotesListItem.java b/src/标注_杜金洲/NotesListItem.java index 05062c9..08a8017 100644 --- a/src/标注_杜金洲/NotesListItem.java +++ b/src/标注_杜金洲/NotesListItem.java @@ -14,43 +14,43 @@ import net.micode.notes.tool.DataUtils; import net.micode.notes.tool.ResourceParser.NoteItemBgResources; -//ǩбĿѡ +//创建便签列表项目选项 public class NotesListItem extends LinearLayout { - private ImageView mAlert;//ͼƬ - private TextView mTitle; // - private TextView mTime; //ʱ + private ImageView mAlert;//闹钟图片 + private TextView mTitle; //标题 + private TextView mTime; //时间 private TextView mCallName; // - private NoteItemData mItemData; //ǩ - private CheckBox mCheckBox; //򹳿 + private NoteItemData mItemData; //标签数据 + private CheckBox mCheckBox; //打钩框 - /*ʼϢ*/ + /*初始化基本信息*/ public NotesListItem(Context context) { - super(context); //super()Ҫǵø๹캯˳ - inflate(context, R.layout.note_item, this);//InflateڽһxmlжIJֿؼҳ,xmlrlayout - //findViewByIdڴcontentViewвָIDViewתʽҪ; + super(context); //super()它的主要作用是调整调用父类构造函数的顺序 + inflate(context, R.layout.note_item, this);//Inflate可用于将一个xml中定义的布局控件找出来,这里的xml是r。layout + //findViewById用于从contentView中查找指定ID的View,转换出来的形式根据需要而定; mAlert = (ImageView) findViewById(R.id.iv_alert_icon); mTitle = (TextView) findViewById(R.id.tv_title); mTime = (TextView) findViewById(R.id.tv_time); mCallName = (TextView) findViewById(R.id.tv_name); mCheckBox = (CheckBox) findViewById(android.R.id.checkbox); } - ///dataԶԸؼԵĿƣҪǿɼVisibilitysetTextʽsetTextAppearance + ///根据data的属性对各个控件的属性的控制,主要是可见性Visibility,内容setText,格式setTextAppearance public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) { if (choiceMode && data.getType() == Notes.TYPE_NOTE) { - mCheckBox.setVisibility(View.VISIBLE); ///ÿɼΪɼ - mCheckBox.setChecked(checked); ///Ӵ + mCheckBox.setVisibility(View.VISIBLE); ///设置可见行为可见 + mCheckBox.setChecked(checked); ///格子打钩 } else { mCheckBox.setVisibility(View.GONE); } mItemData = data; - ///ÿؼԣһdataid͸idǷ뱣浽ļеidһ + ///设置控件属性,一共三种情况,由data的id和父id是否与保存到文件夹的id一致来决定 if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) { mCallName.setVisibility(View.GONE); mAlert.setVisibility(View.VISIBLE); - //øtextviewstyle + //设置该textview的style mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem); - //settextΪ + //settext为设置内容 mTitle.setText(context.getString(R.string.call_record_folder_name) + context.getString(R.string.format_folder_files_count, data.getNotesCount())); mAlert.setImageResource(R.drawable.call_record); @@ -59,9 +59,9 @@ public class NotesListItem extends LinearLayout { mCallName.setText(data.getCallName()); mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem); mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); - ///ӵ + ///关于闹钟的设置 if (data.hasAlert()) { - mAlert.setImageResource(R.drawable.clock);//ͼƬԴ + mAlert.setImageResource(R.drawable.clock);//图片来源的设置 mAlert.setVisibility(View.VISIBLE); } else { mAlert.setVisibility(View.GONE); @@ -69,7 +69,7 @@ public class NotesListItem extends LinearLayout { } else { mCallName.setVisibility(View.GONE); mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem); - ///titleʽ + ///设置title格式 if (data.getType() == Notes.TYPE_FOLDER) { mTitle.setText(data.getSnippet() + context.getString(R.string.format_folder_files_count, @@ -78,39 +78,39 @@ public class NotesListItem extends LinearLayout { } else { mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); if (data.hasAlert()) { - mAlert.setImageResource(R.drawable.clock);///ͼƬԴ + mAlert.setImageResource(R.drawable.clock);///设置图片来源 mAlert.setVisibility(View.VISIBLE); } else { mAlert.setVisibility(View.GONE); } } } - ///ݣȡʱ䣬data༭лȡ + ///设置内容,获取相关时间,从data里编辑的日期中获取 mTime. setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate())); setBackground(data); } - //dataļñ + //根据data的文件属性来设置背景 private void setBackground(NoteItemData data) { int id = data.getBgColorId(); - //noteļ44ֲͬıԴ + //,若是note型文件,则4种情况,对于4种不同情况的背景来源 if (data.getType() == Notes.TYPE_NOTE) { - //ݲֻһļ + //单个数据并且只有一个子文件夹 if (data.isSingle() || data.isOneFollowingFolder()) { setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id)); - } else if (data.isLast()) {//һ + } else if (data.isLast()) {//是最后一个数据 setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id)); - } else if (data.isFirst() || data.isMultiFollowingFolder()) {//һݲжļ + } else if (data.isFirst() || data.isMultiFollowingFolder()) {//是一个数据并有多个子文件夹 setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id)); } else { setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id)); } } else { - //noteֱӵļеıԴ + //若不是note直接调用文件夹的背景来源 setBackgroundResource(NoteItemBgResources.getFolderBgRes()); } } public NoteItemData getItemData() { return mItemData; } -} +} \ No newline at end of file