diff --git a/doc/小米便签开源代码泛读报告.docx b/doc/小米便签开源代码泛读报告.docx new file mode 100644 index 0000000..6082b20 Binary files /dev/null and b/doc/小米便签开源代码泛读报告.docx differ diff --git a/src/notes/ui/NoteItemData.java b/src/notes/ui/NoteItemData.java new file mode 100644 index 0000000..ec56724 --- /dev/null +++ b/src/notes/ui/NoteItemData.java @@ -0,0 +1,224 @@ +/* + * 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 [] {//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,//父id + NoteColumns.SNIPPET,//文件夹名称或者文本注释内容 + NoteColumns.TYPE,//某一列note的种类，是text note还是folder + 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，主要利用光标cursor获取的东西 + mId = cursor.getLong(ID_COLUMN);//从cursor中获取数据 + 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确定电话号码 + 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;//如果匹配失败，就把phonenumber设置为name + } + } + } + + if (mName == null) {//如果没有对name复制成功，则把name设置为空值 + mName = ""; + } + checkPostion(cursor);//检查光标位置 + } + + private void checkPostion(Cursor cursor) {//通过光标所处位置设置标记 + mIsLastItem = cursor.isLast() ? true : false;//分别为各种描述状态的变量进行赋值 + mIsFirstItem = cursor.isFirst() ? true : false; + mIsOnlyOneItem = (cursor.getCount() == 1); + mIsMultiNotesFollowingFolder = false;//初始化“多重子文件”“单一子文件”2个标记 + mIsOneNoteFollowingFolder = false; + + if (mType == Notes.TYPE_NOTE && !mIsFirstItem) {//是NOTE格式且不是第一个item + int position = cursor.getPosition();//光标指向的位置 + if (cursor.moveToPrevious()) {//获取光标位置并看向上一行 + if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER//若光标满足SYSTEM或FOLDER格式 + || cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {//数据行数大于当前位置+1则设置是多重子文件 + if (cursor.getCount() > (position + 1)) {//数据行数大于当前位置+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且电话号码不空，则返回真 + + 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() {//判断便签项是否为CallRecord + return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));// 如果父类id保存至文件夹模式并且电话号码单元不为空 + } + + public static int getNoteType(Cursor cursor) { + return cursor.getInt(TYPE_COLUMN); + }//获得便签的类型 +} diff --git a/src/notes/ui/NotesListActivity.java b/src/notes/ui/NotesListActivity.java new file mode 100644 index 0000000..7693fa5 --- /dev/null +++ b/src/notes/ui/NotesListActivity.java @@ -0,0 +1,955 @@ +/* + * 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;//这个类包含在net.micode.notes.ui这个包里 + +import android.app.Activity;//引入了一系列实现这个类功能所必须的类 +import android.app.AlertDialog; +import android.app.Dialog; +import android.appwidget.AppWidgetManager;//APP的界宽 +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;//Android自动生成的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 {//这个类继承于Activity类，实现了两个接口，分别是点击监听器，和长按监听器，即在这个类的界面实现对这两种操作的响应，这是整个project的主类 + 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;//菜单中的查看文件夹对应的int值 + + private static final int MENU_FOLDER_CHANGE_NAME = 2;//.菜单中改文件夹名项对应的int值 + + 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 + protected void onCreate(Bundle savedInstanceState) {//创建类 + super.onCreate(savedInstanceState);//super调用父类的protected函数,创建窗口时使用 + 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) {//对子模块的一些数据进行分析 + if (resultCode == RESULT_OK + && (requestCode == REQUEST_CODE_OPEN_NODE || requestCode == REQUEST_CODE_NEW_NODE)) {//当被销毁的活动是打开便签或者新建便签，且结果码匹配时，把从编辑界面的光标数据删除 + mNotesListAdapter.changeCursor(null); + } else {//super调用父类的protected函数,创建窗口时使用 + super.onActivityResult(requestCode, resultCode, data);// 调用父类的方法 + } + } + + private void setAppInfoFromRawRes() {//通过原生资源设置APP信息 + SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this);//SharedPreferences类，用于保存配置参数 + if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) {//添加新的偏好设置 + StringBuilder sb = new StringBuilder();//读取原生资源信息 + InputStream in = null;//输入流初始设置为空 + try {//从原始配置文件当中获取基本信息 + in = getResources().openRawResource(R.raw.introduction);//加载Welcome to use MIUI notes!（本地xml文件） + 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) {//read读取一个字符，若读取到末尾则返回-1，这里是加载到buf中 + sb.append(buf, 0, len);//使用append函数在指定元素的结尾插入内容 + } + } else { + Log.e(TAG, "Read introduction file error");//报错，读取文件错误 + return; + } + } catch (IOException e) {//IO出错，打印异常信息 + e.printStackTrace();//在命令行打印异常信息在程序中出错的位置及原因 + return; + } finally {//close语句会自动执行，不需要显示的调用 + 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() {//在OnCreate函数运行完之后执行。用于获取便签列表 + 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);//设置Title bar，也就是app页面顶部的返回、选项、信息描述 + mState = ListEditState.NOTE_LIST;//功能描述：设置状态 + mModeCallBack = new ModeCallback();//.implements是一个类实现连接一个接口用的关键字，它是用来实现接口中定义的抽象方法 + } + + 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);//layout的xml布局文件实例化为View类对象 + menu.findItem(R.id.delete).setOnMenuItemClickListener(this);//为便签删除模块设定监听器 + mMoveMenu = menu.findItem(R.id.move);//调用下面的更新菜单函数 + if (mFocusNoteDataItem.getParentId() == Notes.ID_CALL_RECORD_FOLDER + || DataUtils.getUserFolderCount(mContentResolver) == 0) {//如果父类id在文件夹中保存或者用户文件数量为零，设置移动菜单为不可见，否者设为可见 + 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-Android系统中一种消息框类型 + 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://default，switch语句结束 + 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;//起始的y值 + int eventY = start + (int) event.getY();//event.getY相当于点击到的地方的y值 + /** + * 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//最后得到最后一个元素的view（视图） + - 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() {//开始NoteList对数据库的异步查询 + String selection = (mCurrentFolderId == Notes.ID_ROOT_FOLDER) ? ROOT_FOLDER_SELECTION + : NORMAL_SELECTION;//如果当前文件id与保存在文件夹的id相同，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);//对话框的title是“选择文件夹” + 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);//新建一个意图，与NoteEditActivity相关联 + 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>() {//批量删除：删除时候，会判断是否为桌面挂件 + protected HashSet doInBackground(Void... unused) { + HashSet 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;//桌面widget修改 + } + + @Override + protected void onPostExecute(HashSet widgets) {//遍历所有的widget + if (widgets != null) { + for (AppWidgetAttribute widget : widgets) { + if (widget.widgetId != AppWidgetManager.INVALID_APPWIDGET_ID//此处判断是否为一个widget + && widget.widgetType != Notes.TYPE_WIDGET_INVALIDE) {//更新widget信息 + 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 ids = new HashSet();//初始化一个哈希表 + ids.add(folderId);// 把文件夹id加入进去 + HashSet widgets = DataUtils.getFolderNoteWidget(mContentResolver, + folderId); + if (!isSyncMode()) {//如果不同步，直接删除 + // if not synced, delete folder directly + DataUtils.batchDeleteNotes(mContentResolver, ids);//如同步，将被删除的文件夹放入trash文件夹中 + } 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) {//如果存在对应桌面挂件，那么判断挂件信息，如果挂件id有效且挂件类型有效，则更新挂件信息 + 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();//获取当前文件夹的ID + startAsyncNotesListQuery();//开始异步的便签列表反馈 + if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {//如果当前id是保存在文件夹的id，将列表编辑状态置为call文件夹，否则设置为镜像文件夹 + mState = ListEditState.CALL_RECORD_FOLDER;//对标题栏的操作 + mAddNewNote.setVisibility(View.GONE);//将button“新建便签”置为不可见 + } else {//不然状态设置为子文件夹 + mState = ListEditState.SUB_FOLDER; + } + if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {//如果当前id是保存在文件夹的id，设置标题内容为文件夹名字，否则设置为文本的前部片段内容 + mTitleBar.setText(R.string.call_record_folder_name);//title设置为call notes + } else { + mTitleBar.setText(data.getSnippet());//否则文本的前部片段内容，即文件夹名称 + } + mTitleBar.setVisibility(View.VISIBLE);//将Activity的title设置为可见 + } + + public void onClick(View v) {//点击时进行的响应 + switch (v.getId()) {//得到我们所点击组件的ID号并进行判断 + case R.id.btn_new_note://当点击的组件是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);//使软键盘显示，第二个参数hideFlags（用来设置是否隐藏）等于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);//编辑文本，通过ID获取名称. + showSoftInput();//显示键盘 + if (!create) {//如果create==false将对话框标题设置为 修改文件夹名称，否则设置为新建文件夹 + if (mFocusNoteDataItem != null) {//如果长按的对象（focus对象）不等于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");//载入标签tag，报错 + 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();//获取当前可编辑文本框etName的文本内容 + if (DataUtils.checkVisibleFolderName(mContentResolver, name)) {//检测可视文件夹的名字 + Toast.makeText(NotesListActivity.this, getString(R.string.folder_exist, name),//显示提示信息“文件夹‘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);//将片段名字添加入value + values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);//将文件夹类型添加入value + values.put(NoteColumns.LOCAL_MODIFIED, 1);//将本地修改添加入value + mContentResolver.update(Notes.CONTENT_NOTE_URI, values, NoteColumns.ID + + "=?", new String[] {//将内容笔记URI及笔记专栏ID更新至内容解决器 + String.valueOf(mFocusNoteDataItem.getId())//如果修改文件夹名字操作成功，则更新数据库内容 + }); + } + } else if (!TextUtils.isEmpty(name)) {//如果是新建文件夹操作 + ContentValues values = new ContentValues(); + values.put(NoteColumns.SNIPPET, name);//将SNIPPET加入内容值中 + values.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);//将TYPE加入内容值中 + mContentResolver.insert(Notes.CONTENT_NOTE_URI, values);//将内容_笔记的URI插入到内容解决器 + } + dialog.dismiss();//撤销对话框 + } + }); + + if (TextUtils.isEmpty(etName.getText())) {//若文本为空，确认按钮设置使能为false + 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);//监听输入字符串，如果大于零，则button可以点击 + } + } + + 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;//将当前文件夹id修改为根文件夹 + startAsyncNotesListQuery();//将当前状态改为一般状态 + mTitleBar.setVisibility(View.GONE);//隐藏TitleBar，设置为不可见 + break; + case CALL_RECORD_FOLDER://响应已记录文件夹的操作 + mCurrentFolderId = Notes.ID_ROOT_FOLDER;//将当前文件夹id修改为根文件夹 + mState = ListEditState.NOTE_LIST;//便签列表的返回 + mAddNewNote.setVisibility(View.VISIBLE);//设置button“新增便签”可见 + mTitleBar.setVisibility(View.GONE);//隐藏TitleBar，设置为不可见 + startAsyncNotesListQuery(); + break; + case NOTE_LIST://从主界面退出 + super.onBackPressed();//调用原来的onBackPressed方法 + break; + default://其他情况直接break + break; + } + } + + private void updateWidget(int appWidgetId, int appWidgetType) {//更新桌面widget小工具，设置内容、格式 + Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);//初始化部件大小管理 + if (appWidgetType == Notes.TYPE_WIDGET_2X) {//下面是判断不同类型widget的操作并建立不同的类型 + intent.setClass(this, NoteWidgetProvider_2x.class);//将便签插件提供器的类型设置成内容的类型 + } else if (appWidgetType == Notes.TYPE_WIDGET_4X) {//判断不同类型widget的操作并建立不同的类型 + intent.setClass(this, NoteWidgetProvider_4x.class); + } else { + Log.e(TAG, "Unspported widget type");//否则显示“不支持的插件类型 + return;//返回错误日志信息 + } + + intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {//putExtra中两个参数为键对值，第一个参数为键名 + 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()) {//通过获取项目ID，进行switch + 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);//设置button“取消” + builder.show(); + break; + case MENU_FOLDER_CHANGE_NAME://修改目录文件夹的名称 + showCreateOrModifyFolderDialog(false);//不显示创建or修改文件夹的对话框 + 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);//采用布局文件R.menu.sub_folder来构建菜单项 + } else if (mState == ListEditState.CALL_RECORD_FOLDER) {//当状态为当调用记录文件夹时，扩充记录文件夹的菜单 + getMenuInflater().inflate(R.menu.call_record_folder, menu);//采用布局文件R.menu.call_record_folder来构建菜单项 + } else {//否则设置标签为“错误状态”+当前状态 + Log.e(TAG, "Wrong state:" + mState);//报错日志信息 + } + return true; + } + + @Override + public boolean onOptionsItemSelected(MenuItem item) {//实现菜单项目的操作，通过case语句对各个菜单项目分别设置事件 + 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))) {//如果项目title与菜单同步相同，则进行同步 + GTaskSyncService.startSync(this);//利用到GTaskSyncService的类 + } else {//否则取消同步 + GTaskSyncService.cancelSync(this); + } + } else {//如果不是同步模式，则开始设置动作 + startPreferenceActivity();//.否则进行Preference活动 + } + 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() {//异步任务 + + @Override + protected Integer doInBackground(Void... unused) { + return backup.exportToText(); + }//未被占用的话后台进行 + + @Override + protected void onPostExecute(Integer result) {//设置备份的结果响应 + if (result == BackupUtils.STATE_SD_CARD_UNMOUONTED) {//如果SD卡无响应，则提示用户 “导出失败，SD卡繁忙” + 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);//如果导出成功，则显示成功 + //并且会显示“Export text file 《便签名称》 to SD 《目录名称》 directory” + 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;//转到PreferenceActivity + } + + private void startPreferenceActivity() {//跳转到设置界面 + Activity from = getParent() != null ? getParent() : this;//设置便签函数 + Intent intent = new Intent(from, NotesPreferenceActivity.class); + from.startActivityIfNeeded(intent, -1);//请求码为-1，表示此活动结束后不会通知原活动 + } + + private class OnListItemClickListener implements OnItemClickListener {//当短按标签列表项时的响应 + + public void onItemClick(AdapterView parent, View view, int position, long id) {//项目被点击的响应 + if (view instanceof NotesListItem) {//判断view是否是NotesListItem的一个实例，如果是就获取他的项目信息装入item中 + NoteItemData item = ((NotesListItem) view).getItemData(); + if (mNotesListAdapter.isInChoiceMode()) {//如果列表适配器被选择并且项是便签类型的，则修改位置和状态信息 + if (item.getType() == Notes.TYPE_NOTE) {//如果点到的item是便签 + position = position - mNotesListView.getHeaderViewsCount();//减去头部视图的元素项，得到列表的元素索引值 + mModeCallBack.onItemCheckedStateChanged(null, position, id,//改变对应索引的Item是否被选中的状态 + !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,//长按某一项时进行的操作如果长按的是便签，则通过ActionMode菜单实现 + FoldersListAdapter.PROJECTION, + selection,//长按某一项时进行的操作 如果长按的是便签，则通过ActionMode菜单实现；如果长按的是文件夹，则通过ContextMenu菜单实现； + 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) {//判断view是否是NotesListItem的一个实例，如果是就获取他的项目信息装入item中 + mFocusNoteDataItem = ((NotesListItem) view).getItemData();//聚焦的Item对象 + if (mFocusNoteDataItem.getType() == Notes.TYPE_NOTE && !mNotesListAdapter.isInChoiceMode()) {//长按的对象是便签时的处理，通过ActionMode实现 + if (mNotesListView.startActionMode(mModeCallBack) != null) { + mModeCallBack.onItemCheckedStateChanged(null, position, id, true);//开始对单个便签进行操作 + mNotesListView.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS); + } else {//长按的对象是文件夹时的处理，通过ContextMenu实现 + Log.e(TAG, "startActionMode fails"); + } + } else if (mFocusNoteDataItem.getType() == Notes.TYPE_FOLDER) {//如果长按的的项目是文件夹类型，则执行ContextMenu菜单的实现 + mNotesListView.setOnCreateContextMenuListener(mFolderOnCreateContextMenuListener); + } + } + return false; + } +} diff --git a/src/notes/ui/NotesListAdapter.java b/src/notes/ui/NotesListAdapter.java new file mode 100644 index 0000000..94d1b4b --- /dev/null +++ b/src/notes/ui/NotesListAdapter.java @@ -0,0 +1,185 @@ +/* + * 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;//引入tools包 + +import android.content.Context;//第19到31行导入各种类 +import android.database.Cursor;//光标 +import android.util.Log; +import android.view.View; +import android.view.ViewGroup; +import android.widget.CursorAdapter; + +import net.micode.notes.data.Notes; + +import java.util.Collection;//便签连接器 可能是 实现便签的编辑 +import java.util.HashMap; +import java.util.HashSet; +import java.util.Iterator; + + +public class NotesListAdapter extends CursorAdapter {//直译为便签列表适配器，继承自光标适配器，功能为：实现了鼠标与编辑便签的连接 + private static final String TAG = "NotesListAdapter";//设置标签字符常量 + private Context mContext;//便签数 + private HashMap mSelectedIndex;//HashMap是一个散列表，储存键值对的映射关系 + private int mNotesCount;//便签数 + private boolean mChoiceMode;//选择模式标志 + + public static class AppWidgetAttribute {//桌面widget的属性，包括编号和类型 + public int widgetId;//初始化便签链接器 + public int widgetType; + }; + + public NotesListAdapter(Context context) {// 初始化便签链接 + super(context, null);//功能描述：NoteListAdapter的构造函数 + //函数实现：继承父类函数；设置HashMap的map表，实现选择item与是否选择的键值对；设置context上下文；初始化note数量为0 + mSelectedIndex = new HashMap();//新建哈希表 + mContext = context;//新建一个视图来存储光标所指向的数据 + mNotesCount = 0;//初始便签数为0 + } + + @Override + public View newView(Context context, Cursor cursor, ViewGroup parent) {//利用NotesListLtem类创建新布局 + return new NotesListItem(context);//使用noteslistitem类新建一个项目选项 + } + + @Override + public void bindView(View view, Context context, Cursor cursor) {//将已经存在的视图和鼠标指向的数据进行捆绑 + if (view instanceof NotesListItem) {//如果view是NotesListItem的实例 + NoteItemData itemData = new NoteItemData(context, cursor);//新建一个项目选项并且用bind跟将view和鼠标，内容，便签数据捆绑在一起 + ((NotesListItem) view).bind(context, itemData, mChoiceMode,//用光标指向的内容新建项目并将数据、项目、鼠标、视图捆绑起来 + isSelectedItem(cursor.getPosition())); + } + } + + public void setCheckedItem(final int position, final boolean checked) {//设置勾选框 + mSelectedIndex.put(position, checked);//根据定位和是否勾选设置下标 + notifyDataSetChanged();//在修改后刷新activity + } + + public boolean isInChoiceMode() { + return mChoiceMode; + }//判断单选按钮是否勾选，设置单项选项框 + + public void setChoiceMode(boolean mode) {//重置下标，并根据参数mode设置选项 + mSelectedIndex.clear();//清空勾选下表并根据当前mode设置 + mChoiceMode = mode; + } + + public void selectAll(boolean checked) {//选择全部选项，遍历所有光标可用的位置在判断为便签类型之后勾选单项框 + Cursor cursor = getCursor();//获取光标位置 + for (int i = 0; i < getCount(); i++) {//遍历可用光标位置，如果光标移动且光标当前指向的便签项目类型为TYPE_NOTE则设置为勾选状态 + if (cursor.moveToPosition(i)) {//遍历所有位置并设置勾选标志 + if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {//如果是便签状态 + setCheckedItem(i, checked);// 将位置i标志为已勾选加入到 mSelectedIndex中 + } + } + } + } + + public HashSet getSelectedItemIds() {//建立选择项目的ID的HASH表 + HashSet itemSet = new HashSet();//建立一个选项集合 + for (Integer position : mSelectedIndex.keySet()) {//遍历所有的关键 + if (mSelectedIndex.get(position) == true) {//判断光标位置是否可用 + Long id = getItemId(position); + if (id == Notes.ID_ROOT_FOLDER) {//原文件不需要添加，则将id该下标假如选项集合中 + Log.d(TAG, "Wrong item id, should not happen");//原文件不需要添加 + } else {//如果不是，则加入条目集合 + itemSet.add(id);//将该id加入到选项集合当中 + } + } + } + + return itemSet;//返回条目集合 + } + + public HashSet getSelectedWidget() {//建立桌面widget选项表 + HashSet itemSet = new HashSet();//类似于getselecteditemids的实现方法 + for (Integer position : mSelectedIndex.keySet()) {//如果光标位置可用 + if (mSelectedIndex.get(position) == true) { + Cursor c = (Cursor) getItem(position);//用c记录光标位置以判断是否选择了桌面挂件（可用） + if (c != null) {//获取光标位置可用 + AppWidgetAttribute widget = new AppWidgetAttribute();//新建widget并更新ID和类型，最后添加到选项表中 + NoteItemData item = new NoteItemData(mContext, c);//初始化所选桌面挂件信息加入到itemSet中 + widget.widgetId = item.getWidgetId(); + widget.widgetType = item.getWidgetType(); + itemSet.add(widget);//加入条目集合 + /** + * Don't close cursor here, only the adapter could close it + */ + } else {//在这里，不关闭光标，而是在adapter中才能关闭光标 + Log.e(TAG, "Invalid cursor");//设置标签，无效的cursor + return null; + } + } + } + return itemSet; + } + + public int getSelectedCount() {//被选中的进行计数的函数 + Collection values = mSelectedIndex.values();//获取选项下标的值 + if (null == values) {//如果此项值为空贼返回0 + return 0; + } + Iterator iter = values.iterator();//初始化迭代器 + int count = 0; + while (iter.hasNext()) {//如果iter后面还有，则count加一 + if (true == iter.next()) {//value值为真则count加一 + count++; + } + } + return count; + } + + public boolean isAllSelected() {//判断是否全选 + int checkedCount = getSelectedCount();//通过获得计数的结果与小米便签中的数量相比较 + return (checkedCount != 0 && checkedCount == mNotesCount);//对比选项数和总数是否一致且不为0 + } + + public boolean isSelectedItem(final int position) {//判断是否为选项表 + if (null == mSelectedIndex.get(position)) {//选项下标为空则不是 + return false; + } + return mSelectedIndex.get(position);//判断Item是否被选中的状态 + } + + @Override + protected void onContentChanged() {//activity内容变动时调用calcNotesCount计算便签数量 + super.onContentChanged();//执行父类函数 + calcNotesCount(); + } + + @Override + public void changeCursor(Cursor cursor) {//activity光标变动时调用calcNotesCount计算便签数量 + super.changeCursor(cursor);//重载父类函数 + calcNotesCount();//calcNotesCount函数实现 + } + + private void calcNotesCount() {//实现方式类似前面代码中的selectAll函数 + mNotesCount = 0; + for (int i = 0; i < getCount(); i++) {//获取总数同时遍历 + Cursor c = (Cursor) getItem(i);//遍历所有选项 + if (c != null) {//判断语句，如果光标不是null，那么便得到信息，便签数目加1 + if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {//若选项的数据类型为便签类型，那么计数+1 + mNotesCount++; + } + } else {//设置为无效的光标 + Log.e(TAG, "Invalid cursor");//否则就将设置为无效的光标 + return; + } + } + } +} diff --git a/src/notes/ui/NotesListItem.java b/src/notes/ui/NotesListItem.java new file mode 100644 index 0000000..0c98f49 --- /dev/null +++ b/src/notes/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;//第19到30行导入各种类 +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);//super()它的主要作用是调整调用父类构造函数的顺序 + inflate(context, R.layout.note_item, this);//Inflate()作用就是将xml定义的一个布局找出来 + mAlert = (ImageView) findViewById(R.id.iv_alert_icon);//findViewById用于从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的属性对各个控件的属性的控制，主要是可见性Visibility，内容setText，格式setTextAppearance + 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()));//设置title的内容（文件夹名字+数量） + 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 { + 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()));//设置便签标题内容为便签的前面部分的内容+文件数+便签数 + mAlert.setVisibility(View.GONE);//设置图标不可见 + } else { + 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);//设置背景 + } + + private void setBackground(NoteItemData data) {//通过data设置背景 + int id = data.getBgColorId();//获取id，用此id用来获取背景颜色 + if (data.getType() == Notes.TYPE_NOTE) {//若是note型文件，则4种情况，对于4种不同情况的背景来源 + if (data.isSingle() || data.isOneFollowingFolder()) {//单个数据或只有一个子文件夹 + setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id)); + } else if (data.isLast()) {//最后一个数据 + setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id)); + } else if (data.isFirst() || data.isMultiFollowingFolder()) {//设置背景来源为id的最后一个数据 + setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));//.若不是Note类型则使用文件夹背景来源 + } else { + setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));//设置背景来源为id的普通数据 + } + } else {//如果不是便签类型的数据 + setBackgroundResource(NoteItemBgResources.getFolderBgRes());//设置背景来源为文件夹 + } + } + + public NoteItemData getItemData() { + return mItemData; + }//返回当前便签的数据信息 +} diff --git a/src/notes/ui/NotesPreferenceActivity.java b/src/notes/ui/NotesPreferenceActivity.java new file mode 100644 index 0000000..7a721da --- /dev/null +++ b/src/notes/ui/NotesPreferenceActivity.java @@ -0,0 +1,388 @@ +/* + * 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;//引入ui包 + +import android.accounts.Account;//第19到48行导入各种类 +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;//继承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;//引入R包 +import net.micode.notes.data.Notes.NoteColumns;//小米便签栏 +import net.micode.notes.gtask.remote.GTaskSyncService; + + +public class NotesPreferenceActivity extends PreferenceActivity {//NotesPreferenceActivity，在小米便签中主要实现的是对背景颜色和字体大小的数据储存。 + public static final String PREFERENCE_NAME = "notes_preferences";//继承了PreferenceActivity主要功能为对系统信息和配置进行自动保存的Activity + + 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;//账户标记 + + @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);//在listview组件上方添加其它组件 + } + + @Override + protected void onResume() {//activity交互功能的实现，用于接受用户的输入 + super.onResume(); + + // 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));//与google task同步便签记录 + 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) {//如果有上次修改时间 + lastSyncTimeView.setText(getString(R.string.preferences_last_sync_time, + DateFormat.format(getString(R.string.preferences_last_sync_time_format), + lastSyncTime)));//非同步时，若最近同步时间不为0则显示最近同步时间 + 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) {//设置对话框要显示的一个list，用于显示几个命令时,即change，remove，cancel + 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() {//清除本地的gtask关联的信息 + ContentValues values = new ContentValues(); + values.put(NoteColumns.GTASK_ID, ""); + values.put(NoteColumns.SYNC_ID, 0); + getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null); + } + }).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是以键值对的形式存储数据的，其使用非常简单，能够轻松的存放数据和读取数据 + 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() {//清除本地的gtask关联的信息，将一些参数设置为0或NULL + ContentValues values = new ContentValues(); + values.put(NoteColumns.GTASK_ID, ""); + values.put(NoteColumns.SYNC_ID, 0); + getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, 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)) {//：获取随广播而来的Intent中的同步服务的数据 + TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);//通过获取的数据在设置系统的状态 + syncStatus.setText(intent + .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG)); + }//通过获取的数据在设置系统的状态 + + } + } + + 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; + } + } +} diff --git a/src/notes/widget/NoteWidgetProvider.java b/src/notes/widget/NoteWidgetProvider.java new file mode 100644 index 0000000..97e7365 --- /dev/null +++ b/src/notes/widget/NoteWidgetProvider.java @@ -0,0 +1,132 @@ +/* + * 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.widget;//导入widget +import android.app.PendingIntent;//引入各种类 +import android.appwidget.AppWidgetManager;//导入AppWidget +import android.appwidget.AppWidgetProvider;//提供widget的基本操作和属性 +import android.content.ContentValues; +import android.content.Context; +import android.content.Intent; +import android.database.Cursor;//数据库的光标 +import android.util.Log; +import android.widget.RemoteViews;//远程访问 + +import net.micode.notes.R;//引入android自动生成的R类资源 +import net.micode.notes.data.Notes; +import net.micode.notes.data.Notes.NoteColumns;//便签栏 +import net.micode.notes.tool.ResourceParser; +import net.micode.notes.ui.NoteEditActivity; +import net.micode.notes.ui.NotesListActivity; + +public abstract class NoteWidgetProvider extends AppWidgetProvider {//构造了一个类继承Android原有的AppWidgetProvider类 + public static final String [] PROJECTION = new String [] {//定义了一个字符数组类型的静态变量 + NoteColumns.ID, + NoteColumns.BG_COLOR_ID, + NoteColumns.SNIPPET + }; + + public static final int COLUMN_ID = 0;//便签栏编号 + public static final int COLUMN_BG_COLOR_ID = 1;//背景颜色编号 + public static final int COLUMN_SNIPPET = 2;//便签片段 + + private static final String TAG = "NoteWidgetProvider";//定义NoteWidgetProvider为标签TAG + + @Override + public void onDeleted(Context context, int[] appWidgetIds) {//重载删除方法，把WIDGET_ID置为INVALID_APPPWIDGET_ID,把当前窗口ID置为无效， + ContentValues values = new ContentValues();//定义了一个新values变量 + values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);//存储便签信息 + for (int i = 0; i < appWidgetIds.length; i++) {//遍历修改所有的URI值 + context.getContentResolver().update(Notes.CONTENT_NOTE_URI, + values, + NoteColumns.WIDGET_ID + "=?", + new String[] { String.valueOf(appWidgetIds[i])});// valueOf() 方法用于返回给定参数的原生 Number 对象值 + } + } + + private Cursor getNoteWidgetInfo(Context context, int widgetId) {//获取窗口宽度信息 + return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,//返回信息值 + PROJECTION, + NoteColumns.WIDGET_ID + "=? AND " + NoteColumns.PARENT_ID + "<>?",//用ID来筛选，同时要是存在于未被删除的文件夹中 + new String[] { String.valueOf(widgetId), String.valueOf(Notes.ID_TRASH_FOLER) }, + null); + } + + protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {//上传widget的信息 + update(context, appWidgetManager, appWidgetIds, false);//更新窗口部件 + } + + private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds,//把更新的窗口ID保存到窗口管理器中 + boolean privacyMode) { + for (int i = 0; i < appWidgetIds.length; i++) {//每添加一个widget就会进行一次循环更新操作 + if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {//需要跳过那些已经关闭的窗口的ID + int bgId = ResourceParser.getDefaultBgId(context); + String snippet = ""; + Intent intent = new Intent(context, NoteEditActivity.class);//创建intent对象 + intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);//目标activity在栈顶跳转，不在则新建一个 + intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetIds[i]);//将要传递的值附加键对象 + intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType());//附加组件类型 + + Cursor c = getNoteWidgetInfo(context, appWidgetIds[i]);//获取特定的对应对象 + if (c != null && c.moveToFirst()) {//处理多窗口同位置的情况 + if (c.getCount() > 1) {//cursor.getCount()返回cursor中的行数。 + Log.e(TAG, "Multiple message with same widget id:" + appWidgetIds[i]); + c.close(); + return; + } + snippet = c.getString(COLUMN_SNIPPET);//一条字符串 + bgId = c.getInt(COLUMN_BG_COLOR_ID);//获取ID值 + intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID));//目的 + intent.setAction(Intent.ACTION_VIEW);//为Intent设置一个动作Action + } else {//在Intent内设置一个Action + snippet = context.getResources().getString(R.string.widget_havenot_content);//没有关联内容，点击新建便签 + intent.setAction(Intent.ACTION_INSERT_OR_EDIT); + } + + if (c != null) { + c.close(); + } + + RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());//获取AppWidget对应的视图 + rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));//根据当前的属性，设置背景图片 + intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId); + /** + * Generate the pending intent to start host for the widget//为小部件生成启动主机的挂起意图 + */ + PendingIntent pendingIntent = null;//为小部件生成启动主机的挂起的目标选项 + if (privacyMode) {//判定是否是私密模式 + rv.setTextViewText(R.id.widget_text,//访客模式下，便签内容不可见 + context.getString(R.string.widget_under_visit_mode)); + pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], new Intent( + context, NotesListActivity.class), PendingIntent.FLAG_UPDATE_CURRENT);//获得一个PendingIntent，如果该意图要发生就相当于Context.startActivity(Intent)。 + } else { + rv.setTextViewText(R.id.widget_text, snippet);//设置 点击“按钮(widget_text)”时会触发的Intent，从而对按钮点击事件进行处理 + pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], intent, + PendingIntent.FLAG_UPDATE_CURRENT); + } + + rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent);//窗口服务部件 + appWidgetManager.updateAppWidget(appWidgetIds[i], rv);//调用集合管理器对集合进行更新 + } + } + } + + protected abstract int getBgResourceId(int bgId);//从背景资源中获取当前应用ID + + protected abstract int getLayoutId();//获取部局ID + + protected abstract int getWidgetType();//可以调用2*2或者4*4的函数 +} diff --git a/src/notes/widget/NoteWidgetProvider_2x.java b/src/notes/widget/NoteWidgetProvider_2x.java new file mode 100644 index 0000000..0ca073a --- /dev/null +++ b/src/notes/widget/NoteWidgetProvider_2x.java @@ -0,0 +1,47 @@ +/* + * 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.widget;//声明小米便签窗口部件这个包 + +import android.appwidget.AppWidgetManager;//使用AppWidgetManager这个类 +import android.content.Context; + +import net.micode.notes.R; +import net.micode.notes.data.Notes;//便签数据 +import net.micode.notes.tool.ResourceParser;//资源解析器 + + +public class NoteWidgetProvider_2x extends NoteWidgetProvider {//继承NoteWidgetProvider这个类 + @Override + public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {//更新窗口 + super.update(context, appWidgetManager, appWidgetIds); + } + + @Override + protected int getLayoutId() { + return R.layout.widget_2x; + }//获取窗口布局 + + @Override + protected int getBgResourceId(int bgId) {//获取背景颜色id + return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId); + } + + @Override + protected int getWidgetType() { + return Notes.TYPE_WIDGET_2X; + }//确定窗口大小 +} diff --git a/src/notes/widget/NoteWidgetProvider_4x.java b/src/notes/widget/NoteWidgetProvider_4x.java new file mode 100644 index 0000000..1f60b05 --- /dev/null +++ b/src/notes/widget/NoteWidgetProvider_4x.java @@ -0,0 +1,46 @@ +/* + * 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.widget;//声明包名 + +import android.appwidget.AppWidgetManager;//导入一些类 +import android.content.Context; + +import net.micode.notes.R; +import net.micode.notes.data.Notes; +import net.micode.notes.tool.ResourceParser; + + +public class NoteWidgetProvider_4x extends NoteWidgetProvider {//定义4*4的widget + @Override + public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {//对窗口更新进行重载 + super.update(context, appWidgetManager, appWidgetIds); + } + + protected int getLayoutId() { + return R.layout.widget_4x; + }//返回窗口位置信息，返回了小米便签挂件是2x2型 + + @Override + protected int getBgResourceId(int bgId) {// 获取背景颜色ID + return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);//返回了小米便签2x2型挂件的背景类型ID，即确定了2x2型的背景。 + } + + @Override + protected int getWidgetType() { + return Notes.TYPE_WIDGET_4X; + }//返回窗口类型 +}