吴堃玮

src/ui/NoteEditText.java

@@ -0,0 +1,214 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.content.Context;
+import android.graphics.Rect;
+import android.text.Layout;
+import android.text.Selection;
+import android.text.Spanned;
+import android.text.TextUtils;
+import android.text.style.URLSpan;
+import android.util.AttributeSet;
+import android.util.Log;
+import android.view.ContextMenu;
+import android.view.KeyEvent;
+import android.view.MenuItem;
+import android.view.MenuItem.OnMenuItemClickListener;
+import android.view.MotionEvent;
+import android.widget.EditText;
+
+import net.micode.notes.R;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public class NoteEditText extends EditText {//继承EditText，设置便签设置文本框
+    private static final String TAG = "NoteEditText";//类的名称，可以用来输出日志文件
+    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);
+        sSchemaActionResMap.put(SCHEME_HTTP, R.string.note_link_web);
+        sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email);
+    }//在NoteEditActivity进行文本的操作，删除，进入，编辑
+
+    /**
+     * Call by the {@link NoteEditActivity} to delete or add edit text
+     */
+    public interface OnTextViewChangeListener {//接口OnTextViewChangeListener，会被NoteEditActivity大量调用，其中定义了在编辑文本中delete、点击enter、text改变时的方法
+        /**
+         * Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens
+         * and the text is null
+         */
+        void onEditTextDelete(int index, String text);//当delete键按下时删除当前编辑的文字块
+
+        /**
+         * Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER}
+         * happen
+         */
+        void onEditTextEnter(int index, String text);//当触发输入文本KeyEvent时增添文本
+
+        /**
+         * Hide or show item option when text change
+         */
+        void onTextChange(int index, boolean hasText);//文字更改时隐藏或显示项目选项
+    }
+
+    private OnTextViewChangeListener mOnTextViewChangeListener;//新建私有变量：文本改变的监听器
+
+    public NoteEditText(Context 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);
+    }
+
+//    public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
+        super(context, attrs, defStyle);\
+        // TODO Auto-generated constructor stub
+    }//自定义控件，用于维护便签动态变化的属性。初始化便签
+
+    @Override
+    public boolean onTouchEvent(MotionEvent event) {//view里的函数，处理手机屏幕的所有事件。参数event为手机屏幕触摸事件封装类的对象，其中封装了该事件的所有信息，例如触摸的位置、触摸的类型以及触摸的时间等。该对象会在用户触摸手机屏幕时被创建。
+        switch (event.getAction()) {//重写屏幕触发事件
+            case MotionEvent.ACTION_DOWN://更新坐标
+
+                int x = (int) event.getX();//更新x值为当前触摸处的x值
+                int y = (int) event.getY();//更新y值为当前触摸处的y值
+                x -= getTotalPaddingLeft();//减去左边控件的距离
+                y -= getTotalPaddingTop();//减去上方控件的距离
+                x += getScrollX();
+                y += getScrollY();//加上滚轮滚过的距离
+
+                Layout layout = getLayout();//用布局控件layout根据x,y的新值设置新的位置
+                int line = layout.getLineForVertical(y);//获取纵向行数
+                int off = layout.getOffsetForHorizontal(line, x);//获取横向偏移量
+                Selection.setSelection(getText(), off);//更新光标位置
+                break;
+        }
+
+        return super.onTouchEvent(event);//调用父类，当屏幕有Touch事件时，此方法就会被调用。
+    }
+
+    @Override
+    public boolean onKeyDown(int keyCode, KeyEvent event) {//处理用户按下一个键盘按键时会触发 的事件
+        switch (keyCode) {//根据按键的KeyCode来处理
+            case KeyEvent.KEYCODE_ENTER://按下回车时,如果mOnTextViewChangeListener存在则返回false
+                if (mOnTextViewChangeListener != null) {
+                    return false;
+                }
+                break;
+            case KeyEvent.KEYCODE_DEL://删除按键
+                mSelectionStartBeforeDelete = getSelectionStart();//获取删除文本开始位置
+                break;
+            default://其他情况,返回父类的onKeyDown值
+                break;
+        }
+        return super.onKeyDown(keyCode, event);//继续执行父类的其他点击事件
+    }
+
+    @Override
+    public boolean onKeyUp(int keyCode, KeyEvent event) {//处理用户松开一个键盘按键时会触发的事件
+        switch(keyCode) {//根据按键的 Unicode 编码值来处理，有删除和进入2种操作
+            case KeyEvent.KEYCODE_DEL://若触发修改且文档不为空，则调用前面代码的onEditTextDelete函数进行文本删除
+                if (mOnTextViewChangeListener != null) {
+                    if (0 == mSelectionStartBeforeDelete && mIndex != 0) {
+                        mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());
+                        return true;//利用上文OnTextViewChangeListener对KEYCODE_DEL按键情况的删除函数进行删除
+                    }
+                } else {
+                    Log.d(TAG, "OnTextViewChangeListener was not seted");//其他情况报错，文档的改动监听器并没有建立
+                }
+                break;
+            case KeyEvent.KEYCODE_ENTER://若文档改动监听器已建立，则获取当前位置和文本，并根据获取的信息调用onEditTextEnter函数进行文本增添
+                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");//其他情况报错，监听器OnTextViewChangeListener并没有建立。
+                }
+                break;
+            default:
+                break;
+        }
+        return super.onKeyUp(keyCode, event);//继续执行父类的其他按键弹起的事件
+    }
+
+    @Override
+    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
+    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);//获取开始到结尾的最大、最小值
+            final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);//设置url的信息的范围值
+            if (urls.length == 1) {
+                int defaultResId = 0;// 默认的资源ID值为0
+                for(String schema: sSchemaActionResMap.keySet()) {//获取计划表中所有的key值
+                    if(urls[0].getURL().indexOf(schema) >= 0) {
+                        defaultResId = sSchemaActionResMap.get(schema);
+                        break;
+                    }//若url可以添加则在添加后将defaultResId置为key所映射的值
+                }
+                if (defaultResId == 0) {
+                    defaultResId = R.string.note_link_other;
+                }//defaultResId == 0则说明url并没有添加任何东西，所以置为连接其他SchemaActionResMap的值
+                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;
+                            }
+                        });
+            }
+        }
+        super.onCreateContextMenu(menu);//创建文本菜单
+    }
+}

src/ui/NoteItemData.java

@@ -0,0 +1,223 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.content.Context;
+import android.database.Cursor;
+import android.text.TextUtils;
+
+import net.micode.notes.data.Contact;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.tool.DataUtils;
+
+
+public class NoteItemData {//便签数据的记录，包括各种常量，参数
+    static final String [] PROJECTION = new String [] {//将便签id，提醒时间，背景颜色id，创建时间，关联桌面挂件，修改时间，便签数量，父文件夹id，文件夹id（便签的一段内容），便签的种类，桌面挂件的id，桌面挂件的类型的名称放在一个PROJECTION的字符串数组里
+        NoteColumns.ID,//每个便签的序号ID
+        NoteColumns.ALERTED_DATE,//提醒日期
+        NoteColumns.BG_COLOR_ID,//背景颜色的序号id
+        NoteColumns.CREATED_DATE,//创建日期
+        NoteColumns.HAS_ATTACHMENT,//是否含有附件
+        NoteColumns.MODIFIED_DATE,//修改日期
+        NoteColumns.NOTES_COUNT,//便签数量
+        NoteColumns.PARENT_ID,
+        NoteColumns.SNIPPET,//文件夹名称或者文本注释内容
+        NoteColumns.TYPE,//note的种类
+        NoteColumns.WIDGET_ID,//挂件id
+        NoteColumns.WIDGET_TYPE,//挂件的类型
+    };
+
+    private static final int ID_COLUMN                    = 0;
+    private static final int ALERTED_DATE_COLUMN          = 1;
+    private static final int BG_COLOR_ID_COLUMN           = 2;
+    private static final int CREATED_DATE_COLUMN          = 3;
+    private static final int HAS_ATTACHMENT_COLUMN        = 4;
+    private static final int MODIFIED_DATE_COLUMN         = 5;
+    private static final int NOTES_COUNT_COLUMN           = 6;
+    private static final int PARENT_ID_COLUMN             = 7;
+    private static final int SNIPPET_COLUMN               = 8;
+    private static final int TYPE_COLUMN                  = 9;
+    private static final int WIDGET_ID_COLUMN             = 10;
+    private static final int WIDGET_TYPE_COLUMN           = 11;
+
+    private long mId;//PROJECT的字符串名称对应的值
+    private long mAlertDate;
+    private int mBgColorId;
+    private long mCreatedDate;
+    private boolean mHasAttachment;
+    private long mModifiedDate;
+    private int mNotesCount;
+    private long mParentId;//对方ID
+    private String mSnippet;
+    private int mType;
+    private int mWidgetId;//宽度
+    private int mWidgetType;//宽度形式
+    private String mName;
+    private String mPhoneNumber;
+
+    private boolean mIsLastItem;//判断是否为最后一项
+    private boolean mIsFirstItem;
+    private boolean mIsOnlyOneItem;//判断文件夹下是否只有一个便签
+    private boolean mIsOneNoteFollowingFolder;
+    private boolean mIsMultiNotesFollowingFolder;//判断文件夹下是否有多个便签
+
+    public NoteItemData(Context context, Cursor cursor) {//初始化NoteItemData,利用光标和context获取的内容
+        mId = cursor.getLong(ID_COLUMN);//获取指定数据，并以type类型传回
+        mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
+        mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN);
+        mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN);
+        mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0) ? true : false;//判断行列
+        mModifiedDate = cursor.getLong(MODIFIED_DATE_COLUMN);
+        mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN);
+        mParentId = cursor.getLong(PARENT_ID_COLUMN);
+        mSnippet = cursor.getString(SNIPPET_COLUMN);//获得字符串
+        mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace(//把每项前的方框符号和✔符号去掉
+                NoteEditActivity.TAG_UNCHECKED, "");
+        mType = cursor.getInt(TYPE_COLUMN);
+        mWidgetId = cursor.getInt(WIDGET_ID_COLUMN);
+        mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
+
+        mPhoneNumber = "";//初始化电话号码的信息
+        if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {//如果父文件的id是call_record_folder
+            mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);//使用DataUtils类中定义的函数获取电话号码信息
+            if (!TextUtils.isEmpty(mPhoneNumber)) {//若mphonenumber里有符合字符串，则用contart功能连接
+                mName = Contact.getContact(context, mPhoneNumber);//通过phonenumber，调用getContact，利用键值对获取对应的name
+                if (mName == null) {
+                    mName = mPhoneNumber;//若未保存名字，以号码命名
+                }
+            }
+        }
+
+        if (mName == null) {
+            mName = "";
+        }//若没有对name复制成功，则把name设置为空值
+        checkPostion(cursor);//检查光标位置
+    }
+
+    private void checkPostion(Cursor cursor) {//根据光标位置设置标记
+        mIsLastItem = cursor.isLast() ? true : false;//分别为各种描述状态的变量进行赋值
+        mIsFirstItem = cursor.isFirst() ? true : false;
+        mIsOnlyOneItem = (cursor.getCount() == 1);
+        mIsMultiNotesFollowingFolder = false;
+        mIsOneNoteFollowingFolder = false;//初始化“多重子文件”“单一子文件”2个标记
+
+        if (mType == Notes.TYPE_NOTE && !mIsFirstItem) {//如果对象的类型为便签且不为第一个项
+            int position = cursor.getPosition();//获得光标位置
+            if (cursor.moveToPrevious()) {//如果光标移动
+                if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER//若光标满足SYSTEM或FOLDER格式
+                        || cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {
+                    if (cursor.getCount() > (position + 1)) {//若光标位置大于当前位置，置多便签子文件夹标记为真
+                        mIsMultiNotesFollowingFolder = true;//设置为多重便签
+                    } else {
+                        mIsOneNoteFollowingFolder = true;
+                    }
+                }
+                if (!cursor.moveToNext()) {//若光标不能重新向下走则报错
+                    throw new IllegalStateException("cursor move to previous but can't move back");
+                }
+            }
+        }
+    }
+
+    public boolean isOneFollowingFolder() {
+        return mIsOneNoteFollowingFolder;
+    }//判断是否只有一个便签
+
+    public boolean isMultiFollowingFolder() {
+        return mIsMultiNotesFollowingFolder;
+    }//若数据父id为保存至文件夹模式的id且满足电话号码单元不为空，则isCallRecord为true
+
+    public boolean isLast() {
+        return mIsLastItem;
+    }//判断是否为最后一个项
+
+    public String getCallName() {
+        return mName;
+    }//获得便签的姓名
+
+    public boolean isFirst() {
+        return mIsFirstItem;
+    }//判断是否是第一个项
+
+    public boolean isSingle() {
+        return mIsOnlyOneItem;
+    }//判断是否只有一个项
+
+    public long getId() {
+        return mId;
+    }//获得对应的ID值
+
+    public long getAlertDate() {
+        return mAlertDate;
+    }//获取设置的提醒时间
+
+    public long getCreatedDate() {
+        return mCreatedDate;
+    }//获取创建时间
+
+    public boolean hasAttachment() {
+        return mHasAttachment;
+    }//判断是否关联桌面挂件
+
+    public long getModifiedDate() {
+        return mModifiedDate;
+    }//获得修改后时间
+
+    public int getBgColorId() {
+        return mBgColorId;
+    }//获取背景颜色
+
+    public long getParentId() {
+        return mParentId;
+    }//获取父进程id
+
+    public int getNotesCount() {
+        return mNotesCount;
+    }//获取便签数量
+
+    public long getFolderId () {
+        return mParentId;
+    }//获取文件夹id
+
+    public int getType() {
+        return mType;
+    }//获得项的类型
+
+    public int getWidgetType() {
+        return mWidgetType;
+    }//获取挂件类型
+
+    public int getWidgetId() {
+        return mWidgetId;
+    }//获取挂件id
+
+    public String getSnippet(){
+        return mSnippet;
+    }//获取便签的外观片段
+    public boolean hasAlert() {
+        return (mAlertDate > 0);
+    }//判读此便签是否有提醒功能
+
+    public boolean isCallRecord() {
+        return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));
+    }//如果父类id保存至文件夹模式并且电话号码单元不为空
+
+    public static int getNoteType(Cursor cursor) {
+        return cursor.getInt(TYPE_COLUMN);
+    }//获取便签类型
+}

src/ui/NotesListActivity.java

@@ -0,0 +1,954 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.app.Activity;
+import android.app.AlertDialog;
+import android.app.Dialog;
+import android.appwidget.AppWidgetManager;
+import android.content.AsyncQueryHandler;
+import android.content.ContentResolver;
+import android.content.ContentValues;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.content.SharedPreferences;
+import android.database.Cursor;
+import android.os.AsyncTask;
+import android.os.Bundle;
+import android.preference.PreferenceManager;
+import android.text.Editable;
+import android.text.TextUtils;
+import android.text.TextWatcher;
+import android.util.Log;
+import android.view.ActionMode;
+import android.view.ContextMenu;
+import android.view.ContextMenu.ContextMenuInfo;
+import android.view.Display;
+import android.view.HapticFeedbackConstants;
+import android.view.LayoutInflater;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.MenuItem.OnMenuItemClickListener;
+import android.view.MotionEvent;
+import android.view.View;
+import android.view.View.OnClickListener;
+import android.view.View.OnCreateContextMenuListener;
+import android.view.View.OnTouchListener;
+import android.view.inputmethod.InputMethodManager;
+import android.widget.AdapterView;
+import android.widget.AdapterView.OnItemClickListener;
+import android.widget.AdapterView.OnItemLongClickListener;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.ListView;
+import android.widget.PopupMenu;
+import android.widget.TextView;
+import android.widget.Toast;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.remote.GTaskSyncService;
+import net.micode.notes.model.WorkingNote;
+import net.micode.notes.tool.BackupUtils;
+import net.micode.notes.tool.DataUtils;
+import net.micode.notes.tool.ResourceParser;
+import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute;
+import net.micode.notes.widget.NoteWidgetProvider_2x;
+import net.micode.notes.widget.NoteWidgetProvider_4x;
+
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.util.HashSet;
+
+public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener {//在类的声明中，通过关键字extends来创建一个类的子类。一个类通过关键字implements声明自己使用一个或者多个接口。
+    private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0;//声明并赋值一些不可更改的私有属性
+
+    private static final int FOLDER_LIST_QUERY_TOKEN      = 1;//查询记号
+
+    private static final int MENU_FOLDER_DELETE = 0;//删除菜单文件
+
+    private static final int MENU_FOLDER_VIEW = 1;//菜单中的查看文件夹对应值
+
+    private static final int MENU_FOLDER_CHANGE_NAME = 2;//修改菜单文件名称功能
+
+    private static final String PREFERENCE_ADD_INTRODUCTION = "net.micode.notes.introduction";//第一次使用小米便签时的介绍语句
+
+    private enum ListEditState {//列表编辑状态类
+        NOTE_LIST, SUB_FOLDER, CALL_RECORD_FOLDER
+    };
+
+    private ListEditState mState;
+
+    private BackgroundQueryHandler mBackgroundQueryHandler;//后台疑问处理功能
+
+    private NotesListAdapter mNotesListAdapter;//便签列表配适器
+
+    private ListView mNotesListView;//主界面的视图
+
+    private Button mAddNewNote;//最下方添加便签的按钮
+
+    private boolean mDispatch;//是否调度的判断变量
+
+    private int mOriginY;//首次触摸时屏幕上的垂直距离（y值）
+
+    private int mDispatchY;//重新调度时的触摸的在屏幕上的垂直距离
+
+    private TextView mTitleBar;//子文件夹下标头
+
+    private long mCurrentFolderId;//当前文件夹的ID
+
+    private ContentResolver mContentResolver;//提供内容分析
+
+    private ModeCallback mModeCallBack;//返回调用方法
+
+    private static final String TAG = "NotesListActivity";//名称（可用于日志文件调试）
+
+    public static final int NOTES_LISTVIEW_SCROLL_RATE = 30;//列表滚动速度
+
+    private NoteItemData mFocusNoteDataItem;//光标指向的物件的数据内容
+
+    private static final String NORMAL_SELECTION = NoteColumns.PARENT_ID + "=?";//用于表明处于非父文件夹的其他文件夹下
+
+    private static final String ROOT_FOLDER_SELECTION = "(" + NoteColumns.TYPE + "<>"//用于表明处于父文件夹下（主列表）
+            + Notes.TYPE_SYSTEM + " AND " + NoteColumns.PARENT_ID + "=?)" + " OR ("
+            + NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER + " AND "
+            + NoteColumns.NOTES_COUNT + ">0)";
+
+    private final static int REQUEST_CODE_OPEN_NODE = 102;//打开某个便签时，创建活动的请求码
+    private final static int REQUEST_CODE_NEW_NODE  = 103;//打开某个便签时，创建活动的请求码
+
+    @Override//功能为Activity生命周期开始时调用的函数，用来保存读取状态，设置界面
+    protected void onCreate(Bundle savedInstanceState) {//创建类
+        super.onCreate(savedInstanceState);//引用父类对象
+        setContentView(R.layout.note_list);//设置内容的视图
+        initResources();//初始化类的资源
+
+        /**
+         * Insert an introduction when user firstly use this application
+         */
+        setAppInfoFromRawRes();//当用户第一次访问APP时提供相关信息
+    }
+
+    @Override// 代表执行这个方法时，重写并调用了父类的方法
+    protected void onActivityResult(int requestCode, int resultCode, Intent data) {//返回一些子模块完成的数据交给主Activity处理
+        if (resultCode == RESULT_OK//当被销毁的活动是打开便签或者新建便签且结果码匹配时,把从编辑界面的光标数据删除
+                && (requestCode == REQUEST_CODE_OPEN_NODE || requestCode == REQUEST_CODE_NEW_NODE)) {
+            mNotesListAdapter.changeCursor(null);
+        } else {//如果条件不满足，则将数据返回给父类，即调用父类的onActivityResult()。
+            super.onActivityResult(requestCode, resultCode, data);//调用父类Activity的onActivityResult方法 将数据返回给父类处理
+        }
+    }
+
+    private void setAppInfoFromRawRes() {//利用原始资源文件设置APP的相关信息
+        SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this);//保存配置参数
+        if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) {//判断偏好，增加说明
+            StringBuilder sb = new StringBuilder();//读取原生资源信息
+            InputStream in = null;//输入流初始设置为空
+            try {//使用getResources获取资源后,以openRawResource方法（不带后缀的资源文件名）打开这个文件。
+                 in = getResources().openRawResource(R.raw.introduction);//加载Welcome to use MIUI notes
+                if (in != null) {//如果信息不为空
+                    InputStreamReader isr = new InputStreamReader(in);//使用指定的字符集读取字节并将它们解码为字符
+                    BufferedReader br = new BufferedReader(isr);//分配缓冲区读取空间
+                    char [] buf = new char[1024];
+                    int len = 0;
+                    while ((len = br.read(buf)) > 0) {//不断在buf中读取数据放入sb里
+                        sb.append(buf, 0, len);//使用append函数在指定元素的结尾插入内容
+                    }
+                } else {
+                    Log.e(TAG, "Read introduction file error");//报错，读取文件错误
+                    return;
+                }
+            } catch (IOException e) {//IO出错，打印异常信息
+                e.printStackTrace();//在命令行打印异常信息在程序中出错的位置及原因
+                return;
+            } finally {//必然执行部分
+                if(in != null) {
+                    try {
+                        in.close();
+                    } catch (IOException e) {
+                        // TODO Auto-generated catch block
+                        e.printStackTrace();//输出栈轨迹
+                    }
+                }
+            }
+
+            WorkingNote note = WorkingNote.createEmptyNote(this, Notes.ID_ROOT_FOLDER,//创建新便签
+                    AppWidgetManager.INVALID_APPWIDGET_ID, Notes.TYPE_WIDGET_INVALIDE,
+                    ResourceParser.RED);
+            note.setWorkingText(sb.toString());//设置文本数据
+            if (note.saveNote()) {//若存储条件成立，保存该便签
+                sp.edit().putBoolean(PREFERENCE_ADD_INTRODUCTION, true).commit();//更新保存note的信息
+            } else {
+                Log.e(TAG, "Save introduction note error");
+                return;
+            }//若便签保存不成功，则把错误信息打印到日志里
+        }
+    }
+
+    @Override
+    protected void onStart() {//代表activity生命周期开始
+        super.onStart();//调用父类，启动活动
+        startAsyncNotesListQuery();//同步列表中的便签信息
+    }
+
+    private void initResources() {//初始化资源
+        mContentResolver = this.getContentResolver();//获取应用程序的数据
+        mBackgroundQueryHandler = new BackgroundQueryHandler(this.getContentResolver());//动态创建后台请求处理器的实例
+        mCurrentFolderId = Notes.ID_ROOT_FOLDER;//设置当前文件夹ID是根目录ID
+        mNotesListView = (ListView) findViewById(R.id.notes_list);//根据R文件中的id值查询到相应的View,然后返回
+        mNotesListView.addFooterView(LayoutInflater.from(this).inflate(R.layout.note_list_footer, null),
+                null, false);
+        mNotesListView.setOnItemClickListener(new OnListItemClickListener());//设置项目点击监听
+        mNotesListView.setOnItemLongClickListener(this);//设置长按监听器
+        mNotesListAdapter = new NotesListAdapter(this);//创建便签视图配置器
+        mNotesListView.setAdapter(mNotesListAdapter);
+        mAddNewNote = (Button) findViewById(R.id.btn_new_note);//在activity中要获取该按钮
+        mAddNewNote.setOnClickListener(this);//点击监听
+        mAddNewNote.setOnTouchListener(new NewNoteOnTouchListener());//屏幕监听
+        mDispatch = false;//用于新建便签模块
+        mDispatchY = 0;//初始y值设置为0
+        mOriginY = 0;//加载文件夹下的标头资源
+        mTitleBar = (TextView) findViewById(R.id.tv_title_bar);//加载文件夹下的标头资源
+        mState = ListEditState.NOTE_LIST;//设置状态为主界面
+        mModeCallBack = new ModeCallback();//对便签的方法调用，包括删除和移动
+    }
+
+    private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuItemClickListener {//implements声明自己使用一个或多个接口
+        private DropdownMenu mDropDownMenu;//下拉菜单
+        private ActionMode mActionMode;//动作方式
+        private MenuItem mMoveMenu;//移动菜单
+
+        public boolean onCreateActionMode(ActionMode mode, Menu menu) {//根据菜单和动作创建新动作
+            getMenuInflater().inflate(R.menu.note_list_options, menu);//配置menu的布局
+            menu.findItem(R.id.delete).setOnMenuItemClickListener(this);//为便签删除模块设定监听器
+            mMoveMenu = menu.findItem(R.id.move);//获取菜单项目
+            if (mFocusNoteDataItem.getParentId() == Notes.ID_CALL_RECORD_FOLDER//若父类id在文件夹中保存或者用户文件数量为零，设置移动菜单为不可见，否者设为可见
+                    || DataUtils.getUserFolderCount(mContentResolver) == 0) {
+                mMoveMenu.setVisible(false);
+            } else {
+                mMoveMenu.setVisible(true);
+                mMoveMenu.setOnMenuItemClickListener(this);//长按某一标签时，执行这个移动到文件夹按键变得可见
+            }
+            mActionMode = mode;
+            mNotesListAdapter.setChoiceMode(true);//进入选择模式
+            mNotesListView.setLongClickable(false);//关闭长按列表项发生事件功能
+            mAddNewNote.setVisibility(View.GONE);//隐藏了新增便签按钮
+
+            View customView = LayoutInflater.from(NotesListActivity.this).inflate(//设置用户可视化界面
+                    R.layout.note_list_dropdown_menu, null);//加载下拉菜单的布局
+            mode.setCustomView(customView);
+            mDropDownMenu = new DropdownMenu(NotesListActivity.this,//创建下拉菜单的实例对象
+                    (Button) customView.findViewById(R.id.selection_menu),
+                    R.menu.note_list_dropdown);//为view添加dropDownMenu
+            mDropDownMenu.setOnDropdownMenuItemClickListener(new PopupMenu.OnMenuItemClickListener(){
+                public boolean onMenuItemClick(MenuItem item) {//点击菜单时，设置为全选并更新菜单
+                    mNotesListAdapter.selectAll(!mNotesListAdapter.isAllSelected());//对应下拉菜单里的全选按键
+                    updateMenu();//更新菜单
+                    return true;
+                }
+
+            });
+            return true;
+        }
+
+        private void updateMenu() {//用于用户在进行了勾选之后，更新列表
+            int selectedCount = mNotesListAdapter.getSelectedCount();//获取被勾选的条目数量
+            // Update dropdown menu
+            String format = getResources().getString(R.string.menu_select_title, selectedCount);//从原始资源中读取信息更改下拉菜单内容
+            mDropDownMenu.setTitle(format);//更改标题
+            MenuItem item = mDropDownMenu.findItem(R.id.action_select_all);//全选操作
+            if (item != null) {//当全选成功，则将“全选”菜单项改为“取消全选”菜单，否则仍保持“全选”菜单项
+                if (mNotesListAdapter.isAllSelected()) {//如果便签列表适配器处于全选状态，设置为已勾选，并提供取消全选操作；否则设置为未勾选，提供全选操作
+                    item.setChecked(true);//取消全选
+                    item.setTitle(R.string.menu_deselect_all);
+                } else {
+                    item.setChecked(false);
+                    item.setTitle(R.string.menu_select_all);
+                }
+            }
+        }
+
+        public boolean onPrepareActionMode(ActionMode mode, Menu menu) {//准备活动模式
+            // TODO Auto-generated method stub
+            return false;
+        }
+
+        public boolean onActionItemClicked(ActionMode mode, MenuItem item) {//菜单动作触发标记
+            // TODO Auto-generated method stub
+            return false;
+        }
+
+        public void onDestroyActionMode(ActionMode mode) {//销毁动作模式，设置便签可见
+            mNotesListAdapter.setChoiceMode(false);//设置笔记列表适配器选择方式
+            mNotesListView.setLongClickable(true);//长按操作
+            mAddNewNote.setVisibility(View.VISIBLE);//设置新建的笔记为可见
+        }
+
+        public void finishActionMode() {
+            mActionMode.finish();
+        }//动作模式结束,菜单勾选状态改变
+
+        public void onItemCheckedStateChanged(ActionMode mode, int position, long id,//勾选状态改变时，更改勾选标志，更新菜单
+                boolean checked) {//点击菜单选项触发操作
+            mNotesListAdapter.setCheckedItem(position, checked);//改变勾选的状态
+            updateMenu();//更新菜单
+        }
+
+        public boolean onMenuItemClick(MenuItem item) {//判断菜单是否被点击
+            if (mNotesListAdapter.getSelectedCount() == 0) {// 当勾选数为零时（即未点击），创建文本并显示
+                Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none),
+                        Toast.LENGTH_SHORT).show();
+                return true;
+            }
+
+            switch (item.getItemId()) {//根据id号判断是删除还是移动
+                case R.id.delete://删除菜单项
+                    AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);//警告对话框
+                    builder.setTitle(getString(R.string.alert_title_delete));//设置“删除选中的便签”的title
+                    builder.setIcon(android.R.drawable.ic_dialog_alert);//设置提醒删除的图片
+                    builder.setMessage(getString(R.string.alert_message_delete_notes,
+                                             mNotesListAdapter.getSelectedCount()));//设置警告对话框的图标
+                    builder.setPositiveButton(android.R.string.ok,//设置否定按钮
+                                             new DialogInterface.OnClickListener() {
+                                                 public void onClick(DialogInterface dialog,
+                                                         int which) {
+                                                     batchDelete();//执行批量删除操作
+                                                 }
+                                             });
+                    builder.setNegativeButton(android.R.string.cancel, null);//取消按键的视图
+                    builder.show();
+                    break;
+                case R.id.move://移动便签到文件夹
+                    startQueryDestinationFolders();//开始查询目标文件
+                    break;
+                default:
+                    return false;
+            }
+            return true;
+        }
+    }
+
+    private class NewNoteOnTouchListener implements OnTouchListener {//触摸便签监听器
+
+        public boolean onTouch(View v, MotionEvent event) {//触摸处理函数
+            switch (event.getAction()) {//事件调用获取行为函数，根据不同动作，对应不同操作
+                case MotionEvent.ACTION_DOWN: {//若是创建新便签，通过计算调整界面大小
+                    Display display = getWindowManager().getDefaultDisplay();
+                    int screenHeight = display.getHeight();//获取屏幕高度
+                    int newNoteViewHeight = mAddNewNote.getHeight();//获取新增便签的高度
+                    int start = screenHeight - newNoteViewHeight;
+                    int eventY = start + (int) event.getY();
+                    /**
+                     * Minus TitleBar's height
+                     */
+                    if (mState == ListEditState.SUB_FOLDER) {
+                        eventY -= mTitleBar.getHeight();
+                        start -= mTitleBar.getHeight();
+                    }
+                    /**
+                     * HACKME:When click the transparent part of "New Note" button, dispatch
+                     * the event to the list view behind this button. The transparent part of
+                     * "New Note" button could be expressed by formula y=-0.12x+94（Unit:pixel）
+                     * and the line top of the button. The coordinate based on left of the "New
+                     * Note" button. The 94 represents maximum height of the transparent part.
+                     * Notice that, if the background of the button changes, the formula should
+                     * also change. This is very bad, just for the UI designer's strong requirement.
+                     */
+                    if (event.getY() < (event.getX() * (-0.12) + 94)) {
+                        View view = mNotesListView.getChildAt(mNotesListView.getChildCount() - 1
+                                - mNotesListView.getFooterViewsCount());
+                        if (view != null && view.getBottom() > start
+                                && (view.getTop() < (start + 94))) {
+                            mOriginY = (int) event.getY();
+                            mDispatchY = eventY;
+                            event.setLocation(event.getX(), mDispatchY);
+                            mDispatch = true;
+                            return mNotesListView.dispatchTouchEvent(event);
+                        }
+                    }
+                    break;
+                }
+                case MotionEvent.ACTION_MOVE: {
+                    if (mDispatch) {
+                        mDispatchY += (int) event.getY() - mOriginY;
+                        event.setLocation(event.getX(), mDispatchY);
+                        return mNotesListView.dispatchTouchEvent(event);
+                    }
+                    break;
+                }
+                default: {
+                    if (mDispatch) {
+                        event.setLocation(event.getX(), mDispatchY);
+                        mDispatch = false;
+                        return mNotesListView.dispatchTouchEvent(event);
+                    }
+                    break;
+                }
+            }
+            return false;
+        }
+
+    };
+
+    private void startAsyncNotesListQuery() {
+        String selection = (mCurrentFolderId == Notes.ID_ROOT_FOLDER) ? ROOT_FOLDER_SELECTION
+                : NORMAL_SELECTION;
+        mBackgroundQueryHandler.startQuery(FOLDER_NOTE_LIST_QUERY_TOKEN, null,
+                Notes.CONTENT_NOTE_URI, NoteItemData.PROJECTION, selection, new String[] {
+                    String.valueOf(mCurrentFolderId)
+                }, NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC");
+    }
+
+    private final class BackgroundQueryHandler extends AsyncQueryHandler {
+        public BackgroundQueryHandler(ContentResolver contentResolver) {
+            super(contentResolver);
+        }
+
+        @Override
+        protected void onQueryComplete(int token, Object cookie, Cursor cursor) {
+            switch (token) {
+                case FOLDER_NOTE_LIST_QUERY_TOKEN:
+                    mNotesListAdapter.changeCursor(cursor);
+                    break;
+                case FOLDER_LIST_QUERY_TOKEN:
+                    if (cursor != null && cursor.getCount() > 0) {
+                        showFolderListMenu(cursor);
+                    } else {
+                        Log.e(TAG, "Query folder failed");
+                    }
+                    break;
+                default:
+                    return;
+            }
+        }
+    }
+
+    private void showFolderListMenu(Cursor cursor) {
+        AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
+        builder.setTitle(R.string.menu_title_select_folder);
+        final FoldersListAdapter adapter = new FoldersListAdapter(this, cursor);
+        builder.setAdapter(adapter, new DialogInterface.OnClickListener() {
+
+            public void onClick(DialogInterface dialog, int which) {
+                DataUtils.batchMoveToFolder(mContentResolver,
+                        mNotesListAdapter.getSelectedItemIds(), adapter.getItemId(which));
+                Toast.makeText(
+                        NotesListActivity.this,
+                        getString(R.string.format_move_notes_to_folder,
+                                mNotesListAdapter.getSelectedCount(),
+                                adapter.getFolderName(NotesListActivity.this, which)),
+                        Toast.LENGTH_SHORT).show();
+                mModeCallBack.finishActionMode();
+            }
+        });
+        builder.show();
+    }
+
+    private void createNewNote() {
+        Intent intent = new Intent(this, NoteEditActivity.class);
+        intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
+        intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mCurrentFolderId);
+        this.startActivityForResult(intent, REQUEST_CODE_NEW_NODE);
+    }
+
+    private void batchDelete() {
+        new AsyncTask<Void, Void, HashSet<AppWidgetAttribute>>() {
+            protected HashSet<AppWidgetAttribute> doInBackground(Void... unused) {
+                HashSet<AppWidgetAttribute> widgets = mNotesListAdapter.getSelectedWidget();
+                if (!isSyncMode()) {
+                    // if not synced, delete notes directly
+                    if (DataUtils.batchDeleteNotes(mContentResolver, mNotesListAdapter
+                            .getSelectedItemIds())) {
+                    } else {
+                        Log.e(TAG, "Delete notes error, should not happens");
+                    }
+                } else {
+                    // in sync mode, we'll move the deleted note into the trash
+                    // folder
+                    if (!DataUtils.batchMoveToFolder(mContentResolver, mNotesListAdapter
+                            .getSelectedItemIds(), Notes.ID_TRASH_FOLER)) {
+                        Log.e(TAG, "Move notes to trash folder error, should not happens");
+                    }
+                }
+                return widgets;
+            }
+
+            @Override
+            protected void onPostExecute(HashSet<AppWidgetAttribute> widgets) {
+                if (widgets != null) {
+                    for (AppWidgetAttribute widget : widgets) {
+                        if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID
+                                && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {
+                            updateWidget(widget.widgetId, widget.widgetType);
+                        }
+                    }
+                }
+                mModeCallBack.finishActionMode();
+            }
+        }.execute();
+    }
+
+    private void deleteFolder(long folderId) {
+        if (folderId == Notes.ID_ROOT_FOLDER) {
+            Log.e(TAG, "Wrong folder id, should not happen " + folderId);
+            return;
+        }
+
+        HashSet<Long> ids = new HashSet<Long>();
+        ids.add(folderId);
+        HashSet<AppWidgetAttribute> widgets = DataUtils.getFolderNoteWidget(mContentResolver,
+                folderId);
+        if (!isSyncMode()) {
+            // if not synced, delete folder directly
+            DataUtils.batchDeleteNotes(mContentResolver, ids);
+        } else {
+            // in sync mode, we'll move the deleted folder into the trash folder
+            DataUtils.batchMoveToFolder(mContentResolver, ids, Notes.ID_TRASH_FOLER);
+        }
+        if (widgets != null) {
+            for (AppWidgetAttribute widget : widgets) {
+                if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID
+                        && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {
+                    updateWidget(widget.widgetId, widget.widgetType);
+                }
+            }
+        }
+    }
+
+    private void openNode(NoteItemData data) {
+        Intent intent = new Intent(this, NoteEditActivity.class);
+        intent.setAction(Intent.ACTION_VIEW);
+        intent.putExtra(Intent.EXTRA_UID, data.getId());
+        this.startActivityForResult(intent, REQUEST_CODE_OPEN_NODE);
+    }
+
+    private void openFolder(NoteItemData data) {
+        mCurrentFolderId = data.getId();
+        startAsyncNotesListQuery();
+        if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
+            mState = ListEditState.CALL_RECORD_FOLDER;
+            mAddNewNote.setVisibility(View.GONE);
+        } else {
+            mState = ListEditState.SUB_FOLDER;
+        }
+        if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
+            mTitleBar.setText(R.string.call_record_folder_name);
+        } else {
+            mTitleBar.setText(data.getSnippet());
+        }
+        mTitleBar.setVisibility(View.VISIBLE);
+    }
+
+    public void onClick(View v) {
+        switch (v.getId()) {
+            case R.id.btn_new_note:
+                createNewNote();
+                break;
+            default:
+                break;
+        }
+    }
+
+    private void showSoftInput() {
+        InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
+        if (inputMethodManager != null) {
+            inputMethodManager.toggleSoftInput(InputMethodManager.SHOW_FORCED, 0);
+        }
+    }
+
+    private void hideSoftInput(View view) {
+        InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
+        inputMethodManager.hideSoftInputFromWindow(view.getWindowToken(), 0);
+    }
+
+    private void showCreateOrModifyFolderDialog(final boolean create) {
+        final AlertDialog.Builder builder = new AlertDialog.Builder(this);
+        View view = LayoutInflater.from(this).inflate(R.layout.dialog_edit_text, null);
+        final EditText etName = (EditText) view.findViewById(R.id.et_foler_name);
+        showSoftInput();
+        if (!create) {
+            if (mFocusNoteDataItem != null) {
+                etName.setText(mFocusNoteDataItem.getSnippet());
+                builder.setTitle(getString(R.string.menu_folder_change_name));
+            } else {
+                Log.e(TAG, "The long click data item is null");
+                return;
+            }
+        } else {
+            etName.setText("");
+            builder.setTitle(this.getString(R.string.menu_create_folder));
+        }
+
+        builder.setPositiveButton(android.R.string.ok, null);
+        builder.setNegativeButton(android.R.string.cancel, new DialogInterface.OnClickListener() {
+            public void onClick(DialogInterface dialog, int which) {
+                hideSoftInput(etName);
+            }
+        });
+
+        final Dialog dialog = builder.setView(view).show();
+        final Button positive = (Button)dialog.findViewById(android.R.id.button1);
+        positive.setOnClickListener(new OnClickListener() {
+            public void onClick(View v) {
+                hideSoftInput(etName);
+                String name = etName.getText().toString();
+                if (DataUtils.checkVisibleFolderName(mContentResolver, name)) {
+                    Toast.makeText(NotesListActivity.this, getString(R.string.folder_exist, name),
+                            Toast.LENGTH_LONG).show();
+                    etName.setSelection(0, etName.length());
+                    return;
+                }
+                if (!create) {
+                    if (!TextUtils.isEmpty(name)) {
+                        ContentValues values = new ContentValues();
+                        values.put(NoteColumns.SNIPPET, name);
+                        values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);
+                        values.put(NoteColumns.LOCAL_MODIFIED, 1);
+                        mContentResolver.update(Notes.CONTENT_NOTE_URI, values, NoteColumns.ID
+                                + "=?", new String[] {
+                            String.valueOf(mFocusNoteDataItem.getId())
+                        });
+                    }
+                } else if (!TextUtils.isEmpty(name)) {
+                    ContentValues values = new ContentValues();
+                    values.put(NoteColumns.SNIPPET, name);
+                    values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);
+                    mContentResolver.insert(Notes.CONTENT_NOTE_URI, values);
+                }
+                dialog.dismiss();
+            }
+        });
+
+        if (TextUtils.isEmpty(etName.getText())) {
+            positive.setEnabled(false);
+        }
+        /**
+         * When the name edit text is null, disable the positive button
+         */
+        etName.addTextChangedListener(new TextWatcher() {
+            public void beforeTextChanged(CharSequence s, int start, int count, int after) {
+                // TODO Auto-generated method stub
+
+            }
+
+            public void onTextChanged(CharSequence s, int start, int before, int count) {
+                if (TextUtils.isEmpty(etName.getText())) {
+                    positive.setEnabled(false);
+                } else {
+                    positive.setEnabled(true);
+                }
+            }
+
+            public void afterTextChanged(Editable s) {
+                // TODO Auto-generated method stub
+
+            }
+        });
+    }
+
+    @Override
+    public void onBackPressed() {
+        switch (mState) {
+            case SUB_FOLDER:
+                mCurrentFolderId = Notes.ID_ROOT_FOLDER;
+                mState = ListEditState.NOTE_LIST;
+                startAsyncNotesListQuery();
+                mTitleBar.setVisibility(View.GONE);
+                break;
+            case CALL_RECORD_FOLDER:
+                mCurrentFolderId = Notes.ID_ROOT_FOLDER;
+                mState = ListEditState.NOTE_LIST;
+                mAddNewNote.setVisibility(View.VISIBLE);
+                mTitleBar.setVisibility(View.GONE);
+                startAsyncNotesListQuery();
+                break;
+            case NOTE_LIST:
+                super.onBackPressed();
+                break;
+            default:
+                break;
+        }
+    }
+
+    private void updateWidget(int appWidgetId, int appWidgetType) {
+        Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
+        if (appWidgetType == Notes.TYPE_WIDGET_2X) {
+            intent.setClass(this, NoteWidgetProvider_2x.class);
+        } else if (appWidgetType == Notes.TYPE_WIDGET_4X) {
+            intent.setClass(this, NoteWidgetProvider_4x.class);
+        } else {
+            Log.e(TAG, "Unspported widget type");
+            return;
+        }
+
+        intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {
+            appWidgetId
+        });
+
+        sendBroadcast(intent);
+        setResult(RESULT_OK, intent);
+    }
+
+    private final OnCreateContextMenuListener mFolderOnCreateContextMenuListener = new OnCreateContextMenuListener() {
+        public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) {
+            if (mFocusNoteDataItem != null) {
+                menu.setHeaderTitle(mFocusNoteDataItem.getSnippet());
+                menu.add(0, MENU_FOLDER_VIEW, 0, R.string.menu_folder_view);
+                menu.add(0, MENU_FOLDER_DELETE, 0, R.string.menu_folder_delete);
+                menu.add(0, MENU_FOLDER_CHANGE_NAME, 0, R.string.menu_folder_change_name);
+            }
+        }
+    };
+
+    @Override
+    public void onContextMenuClosed(Menu menu) {
+        if (mNotesListView != null) {
+            mNotesListView.setOnCreateContextMenuListener(null);
+        }
+        super.onContextMenuClosed(menu);
+    }
+
+    @Override
+    public boolean onContextItemSelected(MenuItem item) {
+        if (mFocusNoteDataItem == null) {
+            Log.e(TAG, "The long click data item is null");
+            return false;
+        }
+        switch (item.getItemId()) {
+            case MENU_FOLDER_VIEW:
+                openFolder(mFocusNoteDataItem);
+                break;
+            case MENU_FOLDER_DELETE:
+                AlertDialog.Builder builder = new AlertDialog.Builder(this);
+                builder.setTitle(getString(R.string.alert_title_delete));
+                builder.setIcon(android.R.drawable.ic_dialog_alert);
+                builder.setMessage(getString(R.string.alert_message_delete_folder));
+                builder.setPositiveButton(android.R.string.ok,
+                        new DialogInterface.OnClickListener() {
+                            public void onClick(DialogInterface dialog, int which) {
+                                deleteFolder(mFocusNoteDataItem.getId());
+                            }
+                        });
+                builder.setNegativeButton(android.R.string.cancel, null);
+                builder.show();
+                break;
+            case MENU_FOLDER_CHANGE_NAME:
+                showCreateOrModifyFolderDialog(false);
+                break;
+            default:
+                break;
+        }
+
+        return true;
+    }
+
+    @Override
+    public boolean onPrepareOptionsMenu(Menu menu) {
+        menu.clear();
+        if (mState == ListEditState.NOTE_LIST) {
+            getMenuInflater().inflate(R.menu.note_list, menu);
+            // set sync or sync_cancel
+            menu.findItem(R.id.menu_sync).setTitle(
+                    GTaskSyncService.isSyncing() ? R.string.menu_sync_cancel : R.string.menu_sync);
+        } else if (mState == ListEditState.SUB_FOLDER) {
+            getMenuInflater().inflate(R.menu.sub_folder, menu);
+        } else if (mState == ListEditState.CALL_RECORD_FOLDER) {
+            getMenuInflater().inflate(R.menu.call_record_folder, menu);
+        } else {
+            Log.e(TAG, "Wrong state:" + mState);
+        }
+        return true;
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        switch (item.getItemId()) {
+            case R.id.menu_new_folder: {
+                showCreateOrModifyFolderDialog(true);
+                break;
+            }
+            case R.id.menu_export_text: {
+                exportNoteToText();
+                break;
+            }
+            case R.id.menu_sync: {
+                if (isSyncMode()) {
+                    if (TextUtils.equals(item.getTitle(), getString(R.string.menu_sync))) {
+                        GTaskSyncService.startSync(this);
+                    } else {
+                        GTaskSyncService.cancelSync(this);
+                    }
+                } else {
+                    startPreferenceActivity();
+                }
+                break;
+            }
+            case R.id.menu_setting: {
+                startPreferenceActivity();
+                break;
+            }
+            case R.id.menu_new_note: {
+                createNewNote();
+                break;
+            }
+            case R.id.menu_search:
+                onSearchRequested();
+                break;
+            default:
+                break;
+        }
+        return true;
+    }
+
+    @Override
+    public boolean onSearchRequested() {
+        startSearch(null, false, null /* appData */, false);
+        return true;
+    }
+
+    private void exportNoteToText() {
+        final BackupUtils backup = BackupUtils.getInstance(NotesListActivity.this);
+        new AsyncTask<Void, Void, Integer>() {
+
+            @Override
+            protected Integer doInBackground(Void... unused) {
+                return backup.exportToText();
+            }
+
+            @Override
+            protected void onPostExecute(Integer result) {
+                if (result == BackupUtils.STATE_SD_CARD_UNMOUONTED) {
+                    AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
+                    builder.setTitle(NotesListActivity.this
+                            .getString(R.string.failed_sdcard_export));
+                    builder.setMessage(NotesListActivity.this
+                            .getString(R.string.error_sdcard_unmounted));
+                    builder.setPositiveButton(android.R.string.ok, null);
+                    builder.show();
+                } else if (result == BackupUtils.STATE_SUCCESS) {
+                    AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
+                    builder.setTitle(NotesListActivity.this
+                            .getString(R.string.success_sdcard_export));
+                    builder.setMessage(NotesListActivity.this.getString(
+                            R.string.format_exported_file_location, backup
+                                    .getExportedTextFileName(), backup.getExportedTextFileDir()));
+                    builder.setPositiveButton(android.R.string.ok, null);
+                    builder.show();
+                } else if (result == BackupUtils.STATE_SYSTEM_ERROR) {
+                    AlertDialog.Builder builder = new AlertDialog.Builder(NotesListActivity.this);
+                    builder.setTitle(NotesListActivity.this
+                            .getString(R.string.failed_sdcard_export));
+                    builder.setMessage(NotesListActivity.this
+                            .getString(R.string.error_sdcard_export));
+                    builder.setPositiveButton(android.R.string.ok, null);
+                    builder.show();
+                }
+            }
+
+        }.execute();
+    }
+
+    private boolean isSyncMode() {
+        return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
+    }
+
+    private void startPreferenceActivity() {
+        Activity from = getParent() != null ? getParent() : this;
+        Intent intent = new Intent(from, NotesPreferenceActivity.class);
+        from.startActivityIfNeeded(intent, -1);
+    }
+
+    private class OnListItemClickListener implements OnItemClickListener {
+
+        public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
+            if (view instanceof NotesListItem) {
+                NoteItemData item = ((NotesListItem) view).getItemData();
+                if (mNotesListAdapter.isInChoiceMode()) {
+                    if (item.getType() == Notes.TYPE_NOTE) {
+                        position = position - mNotesListView.getHeaderViewsCount();
+                        mModeCallBack.onItemCheckedStateChanged(null, position, id,
+                                !mNotesListAdapter.isSelectedItem(position));
+                    }
+                    return;
+                }
+
+                switch (mState) {
+                    case NOTE_LIST:
+                        if (item.getType() == Notes.TYPE_FOLDER
+                                || item.getType() == Notes.TYPE_SYSTEM) {
+                            openFolder(item);
+                        } else if (item.getType() == Notes.TYPE_NOTE) {
+                            openNode(item);
+                        } else {
+                            Log.e(TAG, "Wrong note type in NOTE_LIST");
+                        }
+                        break;
+                    case SUB_FOLDER:
+                    case CALL_RECORD_FOLDER:
+                        if (item.getType() == Notes.TYPE_NOTE) {
+                            openNode(item);
+                        } else {
+                            Log.e(TAG, "Wrong note type in SUB_FOLDER");
+                        }
+                        break;
+                    default:
+                        break;
+                }
+            }
+        }
+
+    }
+
+    private void startQueryDestinationFolders() {
+        String selection = NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>? AND " + NoteColumns.ID + "<>?";
+        selection = (mState == ListEditState.NOTE_LIST) ? selection:
+            "(" + selection + ") OR (" + NoteColumns.ID + "=" + Notes.ID_ROOT_FOLDER + ")";
+
+        mBackgroundQueryHandler.startQuery(FOLDER_LIST_QUERY_TOKEN,
+                null,
+                Notes.CONTENT_NOTE_URI,
+                FoldersListAdapter.PROJECTION,
+                selection,
+                new String[] {
+                        String.valueOf(Notes.TYPE_FOLDER),
+                        String.valueOf(Notes.ID_TRASH_FOLER),
+                        String.valueOf(mCurrentFolderId)
+                },
+                NoteColumns.MODIFIED_DATE + " DESC");
+    }
+
+    public boolean onItemLongClick(AdapterView<?> parent, View view, int position, long id) {
+        if (view instanceof NotesListItem) {
+            mFocusNoteDataItem = ((NotesListItem) view).getItemData();
+            if (mFocusNoteDataItem.getType() == Notes.TYPE_NOTE && !mNotesListAdapter.isInChoiceMode()) {
+                if (mNotesListView.startActionMode(mModeCallBack) != null) {
+                    mModeCallBack.onItemCheckedStateChanged(null, position, id, true);
+                    mNotesListView.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS);
+                } else {
+                    Log.e(TAG, "startActionMode fails");
+                }
+            } else if (mFocusNoteDataItem.getType() == Notes.TYPE_FOLDER) {
+                mNotesListView.setOnCreateContextMenuListener(mFolderOnCreateContextMenuListener);
+            }
+        }
+        return false;
+    }
+}

src/ui/NotesListItem.java

@@ -0,0 +1,122 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.content.Context;
+import android.text.format.DateUtils;
+import android.view.View;
+import android.widget.CheckBox;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+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 TextView mCallName;//名称
+    private NoteItemData mItemData;//标签数据
+    private CheckBox mCheckBox;//勾选框
+
+    public NotesListItem(Context context) {//初始化基本信息
+        super(context);//调整调用父类构造函数的顺序
+        inflate(context, R.layout.note_item, this);//将xml定义的一个布局找出来
+        mAlert = (ImageView) findViewById(R.id.iv_alert_icon);//从contentView中查找指定ID的View
+        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);//获取复选框
+    }
+
+    public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {//根据data的属性对各个控件的属性的控制
+        if (choiceMode && data.getType() == Notes.TYPE_NOTE) {//如果当前处于选择模式下且数据类型为便签
+            mCheckBox.setVisibility(View.VISIBLE);//设置View可见
+            mCheckBox.setChecked(checked);//设置勾选
+        } else {
+            mCheckBox.setVisibility(View.GONE);//设置复选框不可见
+        }
+
+        mItemData = data;//把数据传给标签
+        if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {//设置控件属性，通过判断保存到文件夹的ID、当前ID以及父ID之间关系决定
+            mCallName.setVisibility(View.GONE);//设置联系人名字不可见
+            mAlert.setVisibility(View.VISIBLE);//设置闹钟图标可见
+            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);//设置外观风格
+            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);//设置图片来源
+        } else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {//关于闹钟的设置
+            mCallName.setVisibility(View.VISIBLE);//设置联系人姓名可见
+            mCallName.setText(data.getCallName());//设置联系人姓名的文本内容
+            mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem);//设置title文本风格
+            mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));//设置title的文本内容为便签内容的前面片段
+            if (data.hasAlert()) {//如果时间提醒存在，设置图片来源，将时间提醒图标定为可见
+                mAlert.setImageResource(R.drawable.clock);//图片来源的设置
+                mAlert.setVisibility(View.VISIBLE);//将提醒图标设置为可见
+            } else {//否则将提醒图标设置为不可见
+                mAlert.setVisibility(View.GONE);
+            }
+        } else {//如果父类和当前id均与保存在文件夹中的id不同
+            mCallName.setVisibility(View.GONE);//设置联系人姓名不可见
+            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);//设置title的文本格式
+
+            if (data.getType() == Notes.TYPE_FOLDER) {//设置Type格式
+                mTitle.setText(data.getSnippet()//设置便签标题内容为便签的前面部分的内容+文件数+便签数
+                        + context.getString(R.string.format_folder_files_count,
+                                data.getNotesCount()));//设置内容，从data编辑的日期中获取时间
+                mAlert.setVisibility(View.GONE);//设置时间提醒图标为不可见
+            } else {//如果不是文件夹类型,设置便签的title为便签内容的前面片段
+                mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
+                if (data.hasAlert()) {//若当前便签存在提醒闹钟时间，则显示相应的图片
+                    mAlert.setImageResource(R.drawable.clock);//将提醒图标设置为闹钟样式
+                    mAlert.setVisibility(View.VISIBLE);//设置提醒闹钟可见
+                } else {//否则设置提醒图标不可见
+                    mAlert.setVisibility(View.GONE);
+                }
+            }
+        }
+        mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));//将时间设置为编辑便签的时间
+
+        setBackground(data);//从data里编辑的日期中获取内容和相关时间
+    }
+
+    private void setBackground(NoteItemData data) {//根据data的文件属性来设置背景
+        int id = data.getBgColorId();//获取id，用此id用来获取背景颜色
+        if (data.getType() == Notes.TYPE_NOTE) {//根据data的属性来是否为Note属性，分为4种情况
+            if (data.isSingle() || data.isOneFollowingFolder()) {//单个数据或只有一个子文件夹
+                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));//设置背景来源为id的单个数据
+            } else if (data.isLast()) {//若当前便签为最后一个,设置背景来源为id的最后一个数据
+                setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));
+            } else if (data.isFirst() || data.isMultiFollowingFolder()) {//若是第一个数据或者有很多个子文件夹, 设置背景来源为id的第一个数据
+                setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));
+            } else {
+                setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));//将便签设置为普通类型便签的背景
+            }
+        } else {//则将背景设置为文件夹的背景
+            setBackgroundResource(NoteItemBgResources.getFolderBgRes());
+        }
+    }
+
+    public NoteItemData getItemData() {
+        return mItemData;
+    }//返回当前便签的数据信息
+}

src/ui/NotesPreferenceActivity.java

@@ -0,0 +1,389 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui;
+
+import android.accounts.Account;
+import android.accounts.AccountManager;
+import android.app.ActionBar;
+import android.app.AlertDialog;
+import android.content.BroadcastReceiver;
+import android.content.ContentValues;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.content.SharedPreferences;
+import android.os.Bundle;
+import android.preference.Preference;
+import android.preference.Preference.OnPreferenceClickListener;
+import android.preference.PreferenceActivity;
+import android.preference.PreferenceCategory;
+import android.text.TextUtils;
+import android.text.format.DateFormat;
+import android.view.LayoutInflater;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Button;
+import android.widget.TextView;
+import android.widget.Toast;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.remote.GTaskSyncService;
+
+
+public class NotesPreferenceActivity extends PreferenceActivity {//实现对背景颜色和字体大小的数据储存
+    public static final String PREFERENCE_NAME = "notes_preferences";//优先名
+
+    public static final String PREFERENCE_SYNC_ACCOUNT_NAME = "pref_key_account_name";//同步账号
+
+    public static final String PREFERENCE_LAST_SYNC_TIME = "pref_last_sync_time";//同步时间
+
+    public static final String PREFERENCE_SET_BG_COLOR_KEY = "pref_key_bg_random_appear";//背景颜色设置按键
+
+    private static final String PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";//账户同步密码
+
+    private static final String AUTHORITIES_FILTER_KEY = "authorities";//本地密码
+
+    private PreferenceCategory mAccountCategory;//账户分组
+
+    private GTaskReceiver mReceiver;//同步任务接收器
+
+    private Account[] mOriAccounts;//账户
+
+    private boolean mHasAddedAccount;//账户的hash标记
+
+    @Override
+    protected void onCreate(Bundle icicle) {//创建一个activity，在函数里完成所有的正常静态设置
+        super.onCreate(icicle);//执行父类创建函数
+
+        /* using the app icon for navigation */
+        getActionBar().setDisplayHomeAsUpEnabled(true);//给左上角图标的左边加上一个返回的图标
+
+        addPreferencesFromResource(R.xml.preferences);//从资源里添加布局文件
+        mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);//根据同步账户密码进行账户分组
+        mReceiver = new GTaskReceiver();//设置同步任务接收器
+        IntentFilter filter = new IntentFilter();//设置过滤项
+        filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);//
+        registerReceiver(mReceiver, filter);
+
+        mOriAccounts = null;//初始化同步组件
+        View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);//从xml获取Listview
+        getListView().addHeaderView(header, null, true);//列出所有选择
+    }
+
+    @Override//功能描述：重启活动
+    protected void onResume() {
+        super.onResume();//activity交互功能的实现，用于接受用户的输入
+
+        // need to set sync account automatically if user has added a new
+        // account
+        if (mHasAddedAccount) {//若用户新加了账户则自动设置同步账户
+            Account[] accounts = getGoogleAccounts();//获取google同步账户
+            if (mOriAccounts != null && accounts.length > mOriAccounts.length) {//若原账户不为空且当前账户有增加
+                for (Account accountNew : accounts) {//遍历账户
+                    boolean found = false;//更新账户
+                    for (Account accountOld : mOriAccounts) {//循环判断当前账户列表中的账户是否与新建账户名相同
+                        if (TextUtils.equals(accountOld.name, accountNew.name)) {
+                            found = true;
+                            break;
+                        }//若没找到旧账户则只设置新账户为同步账户
+                    }
+                    if (!found) {//如果当前新建账户不存在
+                        setSyncAccount(accountNew.name);//保存该账户
+                        break;
+                    }
+                }
+            }
+        }
+
+        refreshUI();//刷新标签界面
+    }
+
+    @Override//功能描述：销毁活动
+    protected void onDestroy() {//销毁Activity
+        if (mReceiver != null) {
+            unregisterReceiver(mReceiver);//取消广播器的监听
+        }//销毁接收器
+        super.onDestroy();//执行销毁动作
+    }
+
+    private void loadAccountPreference() {//重新设置账户信息
+        mAccountCategory.removeAll();//销毁所有的分组
+
+        Preference accountPref = new Preference(this);//建立首选项
+        final String defaultAccount = getSyncAccountName(this);//默认账户为当前账户
+        accountPref.setTitle(getString(R.string.preferences_account_title));
+        accountPref.setSummary(getString(R.string.preferences_account_summary));
+        accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {//设置首选项的大标题和小标题
+            public boolean onPreferenceClick(Preference preference) {//建立监听器
+                if (!GTaskSyncService.isSyncing()) {//不在同步状态下，如果没有默认的账户，显示选择账户的对话框，否则显示需要改变账户的对话框
+                    if (TextUtils.isEmpty(defaultAccount)) {//第一次设置账户
+                        // the first time to set account
+                        showSelectAccountAlertDialog();//第一次建立账户，显示选择账户提示对话框
+                    } else {
+                        // if the account has already been set, we need to promp
+                        // user about the risk
+                        showChangeAccountConfirmAlertDialog();//展示改变账户确认提醒对话框
+                    }
+                } else {//若在没有同步的情况下，则在toast中显示不能修改
+                    Toast.makeText(NotesPreferenceActivity.this,
+                            R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
+                            .show();//正在同步，不能切换同步的账号
+                }
+                return true;
+            }
+        });
+
+        mAccountCategory.addPreference(accountPref);//根据新建首选项编辑新的账户分组
+    }
+
+    private void loadSyncButton() {//设置同步按键和最近同步时间
+        Button syncButton = (Button) findViewById(R.id.preference_sync_button);//配置资源，设置一个button
+        TextView lastSyncTimeView = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
+        //获取同步按钮控件和最终同步时间的的窗口
+
+        // set button state
+        if (GTaskSyncService.isSyncing()) {//如果在同步状态下，则按钮设置为“取消同步”
+            syncButton.setText(getString(R.string.preferences_button_sync_cancel));
+            syncButton.setOnClickListener(new View.OnClickListener() {//设置点击监听器
+                public void onClick(View v) {//设置取消同步的响应方法
+                    GTaskSyncService.cancelSync(NotesPreferenceActivity.this);
+                }
+            });
+        } else {//若是不同步则设置按钮显示的文本为“立即同步”以及对应监听器
+            syncButton.setText(getString(R.string.preferences_button_sync_immediately));
+            syncButton.setOnClickListener(new View.OnClickListener() {
+                public void onClick(View v) {//点击行为
+                    GTaskSyncService.startSync(NotesPreferenceActivity.this);//开始同步
+                }
+            });
+        }
+        syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));//如果没有账户，则不可选“立即同步”的按键
+
+        // set last sync time设置上次同步时间
+        if (GTaskSyncService.isSyncing()) {//如果正在同步则读取正在同步的进度，否则显示最后同步的时间
+            lastSyncTimeView.setText(GTaskSyncService.getProgressString());
+            lastSyncTimeView.setVisibility(View.VISIBLE);
+        } else {//若是非同步情况
+            long lastSyncTime = getLastSyncTime(this);
+            if (lastSyncTime != 0) {//若最近同步时间不为0则显示最近同步时间
+                lastSyncTimeView.setText(getString(R.string.preferences_last_sync_time,
+                        DateFormat.format(getString(R.string.preferences_last_sync_time_format),
+                                lastSyncTime)));
+                lastSyncTimeView.setVisibility(View.VISIBLE);
+            } else {//若时间为空直接设置为不可见状态
+                lastSyncTimeView.setVisibility(View.GONE);
+            }
+        }
+    }//根据当前同步服务器设置时间显示框的文本以及可见性
+
+    private void refreshUI() {//刷新标签界面
+        loadAccountPreference();
+        loadSyncButton();//加载“保存”按钮
+    }
+
+    private void showSelectAccountAlertDialog() {//显示账户选择的对话框并进行账户的设置
+        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);//创建一个新的对话框
+
+        View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
+        TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
+        titleTextView.setText(getString(R.string.preferences_dialog_select_account_title));
+        TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);//文本视图设置
+        subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips));
+
+        dialogBuilder.setCustomTitle(titleView);//设置标题以及子标题的内容
+        dialogBuilder.setPositiveButton(null, null);//不设置“确定”的按钮
+
+        Account[] accounts = getGoogleAccounts();//获取当前谷歌账户
+        String defAccount = getSyncAccountName(this);//获得同步账户
+
+        mOriAccounts = accounts;
+        mHasAddedAccount = false;//获取同步账户信息
+
+        if (accounts.length > 0) {//如果有谷歌账户，则显示所有账户的名称，并设置为选项
+            CharSequence[] items = new CharSequence[accounts.length];
+            final CharSequence[] itemMapping = items;
+            int checkedItem = -1;
+            int index = 0;
+            for (Account account : accounts) {//通过循环检查账户列表
+                if (TextUtils.equals(account.name, defAccount)) {
+                    checkedItem = index;
+                }//在账户列表中查询到所需账户
+                items[index++] = account.name;
+            }
+            dialogBuilder.setSingleChoiceItems(items, checkedItem,//在对话框建立一个单选的复选框
+                    new DialogInterface.OnClickListener() {
+                        public void onClick(DialogInterface dialog, int which) {//响应对话框的点击
+                            setSyncAccount(itemMapping[which].toString());//点击则开始设置同步账户
+                            dialog.dismiss();//取消对话框
+                            refreshUI();//刷新界面
+                        }
+                    });
+        }//设置点击后执行的事件，包括检录新同步账户和刷新标签界面
+
+        View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);//添加新的账户
+        dialogBuilder.setView(addAccountView);//给新加账户对话框设置自定义样式
+
+        final AlertDialog dialog = dialogBuilder.show();//显示对话框
+        addAccountView.setOnClickListener(new View.OnClickListener() {//设置监听器
+            public void onClick(View v) {//响应点击添加账户的请求
+                mHasAddedAccount = true;//将新加账户的hash置为true
+                Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");//建立网络组件
+                intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {
+                    "gmail-ls"
+                });
+                startActivityForResult(intent, -1);//跳回上一个选项
+                dialog.dismiss();
+            }
+        });
+    }
+
+    private void showChangeAccountConfirmAlertDialog() {//刷新标签界面
+        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);//创建一个新的对话框
+
+        View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
+        TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
+        titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
+                getSyncAccountName(this)));
+        TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
+        subtitleTextView.setText(getString(R.string.preferences_dialog_change_account_warn_msg));
+        dialogBuilder.setCustomTitle(titleView);//根据同步修改的账户信息设置标题以及子标题的内容
+
+        CharSequence[] menuItemArray = new CharSequence[] {
+                getString(R.string.preferences_menu_change_account),
+                getString(R.string.preferences_menu_remove_account),
+                getString(R.string.preferences_menu_cancel)
+        };//设置对话框的自定义标题
+        dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {//定义一些标记字符串
+            public void onClick(DialogInterface dialog, int which) {//响应对话框的点击
+                if (which == 0) {//如果是改变同步账户，则显示可选择的账户
+                    showSelectAccountAlertDialog();
+                } else if (which == 1) {
+                    removeSyncAccount();
+                    refreshUI();
+                }//删除同步账户
+            }
+        });
+        dialogBuilder.show();//显示对话框
+    }
+
+    private Account[] getGoogleAccounts() {//获取谷歌账户
+        AccountManager accountManager = AccountManager.get(this);
+        return accountManager.getAccountsByType("com.google");
+    }
+
+    private void setSyncAccount(String account) {//设置同步账户
+        if (!getSyncAccountName(this).equals(account)) {//如果该账号不在同步账号列表中
+            SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
+            SharedPreferences.Editor editor = settings.edit();//编辑共享首选项
+            if (account != null) {//如果账户不为空
+                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);
+            } else {
+                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
+            }//将该账号加入到首选项中
+            editor.commit();//提交修改的数据
+
+            // clean up last sync time
+            setLastSyncTime(this, 0);//将最后同步时间清零
+
+            // clean up local gtask related info
+            new Thread(new Runnable() {//新线程的创建
+                public void run() {
+                    ContentValues values = new ContentValues();
+                    values.put(NoteColumns.GTASK_ID, "");
+                    values.put(NoteColumns.SYNC_ID, 0);
+                    getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
+                }//清除本地的gtask关联的信息
+            }).start();//重置当地同步任务的信息
+
+            Toast.makeText(NotesPreferenceActivity.this,//设置一个toast提示信息，提示用户成功设置同步
+                    getString(R.string.preferences_toast_success_set_accout, account),
+                    Toast.LENGTH_SHORT).show();//将toast的文本信息置为“设置账户成功”并显示出来
+        }
+    }
+
+    private void removeSyncAccount() {//删除同步账户
+        SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);//存放数据和读取数据
+        SharedPreferences.Editor editor = settings.edit();//设置共享首选项
+        if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {
+            editor.remove(PREFERENCE_SYNC_ACCOUNT_NAME);
+        }//若当前首选项中有账户就删除
+        if (settings.contains(PREFERENCE_LAST_SYNC_TIME)) {
+            editor.remove(PREFERENCE_LAST_SYNC_TIME);
+        }//删除当前首选项中有账户时间
+        editor.commit();//提交更新后的数据
+
+        // clean up local gtask related info
+        new Thread(new Runnable() {//新线程的创建
+            public void run() {
+                ContentValues values = new ContentValues();
+                values.put(NoteColumns.GTASK_ID, "");
+                values.put(NoteColumns.SYNC_ID, 0);
+                getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
+            }//清除本地的gtask关联的信息，将一些参数设置为0或NULL
+        }).start();
+    }
+
+    public static String getSyncAccountName(Context context) {
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                Context.MODE_PRIVATE);
+        return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
+    }//获取同步账户名称
+
+    public static void setLastSyncTime(Context context, long time) {
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                Context.MODE_PRIVATE);
+        SharedPreferences.Editor editor = settings.edit();//从共享首选项中找到相关账户并获取其编辑器
+        editor.putLong(PREFERENCE_LAST_SYNC_TIME, time);
+        editor.commit();//编辑最终同步时间并提交更新
+    }//设置最终同步的时间
+
+    public static long getLastSyncTime(Context context) {//获取最终同步时间
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                Context.MODE_PRIVATE);//通过共享，获取时间
+        return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0);
+    }
+
+    private class GTaskReceiver extends BroadcastReceiver {//接受同步信息
+
+        @Override
+        public void onReceive(Context context, Intent intent) {//响应接收广播的情况
+            refreshUI();
+            if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {
+                TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
+                syncStatus.setText(intent
+                        .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));////通过获取的数据在设置系统的状态
+            }//获取随广播而来的Intent中的同步服务的数据
+
+        }
+    }
+
+    public boolean onOptionsItemSelected(MenuItem item) {//处理菜单的选项
+        switch (item.getItemId()) {//根据选项的id选择
+            case android.R.id.home://返回主界面
+                Intent intent = new Intent(this, NotesListActivity.class);
+                intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
+                startActivity(intent);//创建活动
+                return true;
+            default://在主页情况下在创建连接组件intent，发出清空的信号并开始一个相应的activity
+                return false;
+        }
+    }
+}