diff --git a/Notes-master/.idea/.name b/Notes-master/.idea/.name new file mode 100644 index 0000000..683595c --- /dev/null +++ b/Notes-master/.idea/.name @@ -0,0 +1 @@ +AlarmAlertActivity.java \ No newline at end of file diff --git a/Notes-master/src/net/micode/notes/ui/AlarmAlertActivity.java b/Notes-master/src/net/micode/notes/ui/AlarmAlertActivity.java index 85723be..a688061 100644 --- a/Notes-master/src/net/micode/notes/ui/AlarmAlertActivity.java +++ b/Notes-master/src/net/micode/notes/ui/AlarmAlertActivity.java @@ -16,143 +16,456 @@ package net.micode.notes.ui; -import android.app.Activity; +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.DialogInterface.OnClickListener; -import android.content.DialogInterface.OnDismissListener; import android.content.Intent; -import android.media.AudioManager; -import android.media.MediaPlayer; -import android.media.RingtoneManager; -import android.net.Uri; +import android.content.IntentFilter; +import android.content.SharedPreferences; import android.os.Bundle; -import android.os.PowerManager; -import android.provider.Settings; -import android.view.Window; -import android.view.WindowManager; +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.tool.DataUtils; +import net.micode.notes.data.Notes.NoteColumns; +import net.micode.notes.gtask.remote.GTaskSyncService; -import java.io.IOException; +/** + * NotesPreferenceActivity 类用于管理便签应用的设置界面。 + * 它允许用户选择同步账户、启动或取消同步，并显示上次同步时间。 + */ +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; + // 用于接收 GTask 同步服务广播的接收器 + private GTaskReceiver mReceiver; + // 原始的 Google 账户数组 + private Account[] mOriAccounts; + // 标记是否添加了新账户 + private boolean mHasAddedAccount; + + @Override + protected void onCreate(Bundle icicle) { + super.onCreate(icicle); + + // 设置 ActionBar 可返回 + getActionBar().setDisplayHomeAsUpEnabled(true); + // 加载偏好设置资源 + addPreferencesFromResource(R.xml.preferences); + // 找到同步账户的偏好设置类别 + mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY); + // 创建 GTask 广播接收器 + mReceiver = new GTaskReceiver(); + // 创建意图过滤器，用于接收 GTask 同步服务的广播 + IntentFilter filter = new IntentFilter(); + filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME); + // 注册广播接收器 + registerReceiver(mReceiver, filter); -public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener { - private long mNoteId; - private String mSnippet; - private static final int SNIPPET_PREW_MAX_LEN = 60; - MediaPlayer mPlayer; + // 初始化原始账户数组 + mOriAccounts = null; + // 加载设置界面的头部视图 + View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null); + // 将头部视图添加到列表视图中 + getListView().addHeaderView(header, null, true); + } @Override - protected void onCreate(Bundle savedInstanceState) { - super.onCreate(savedInstanceState); - requestWindowFeature(Window.FEATURE_NO_TITLE); - - final Window win = getWindow(); - win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED); - - if (!isScreenOn()) { - win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON - | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON - | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON - | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR); - } + protected void onResume() { + super.onResume(); - Intent intent = getIntent(); - - try { - mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1)); - mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId); - mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0, - SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info) - : mSnippet; - } catch (IllegalArgumentException e) { - e.printStackTrace(); - return; + // 如果添加了新账户，自动设置同步账户 + if (mHasAddedAccount) { + Account[] accounts = getGoogleAccounts(); + 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; + } + } + } } - mPlayer = new MediaPlayer(); - if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) { - showActionDialog(); - playAlarmSound(); - } else { - finish(); + // 刷新界面 + refreshUI(); + } + + @Override + protected void onDestroy() { + // 注销广播接收器 + if (mReceiver != null) { + unregisterReceiver(mReceiver); } + super.onDestroy(); } - private boolean isScreenOn() { - PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE); - return pm.isScreenOn(); + /** + * 加载同步账户的偏好设置项 + */ + 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)) { + showSelectAccountAlertDialog(); + } else { + // 如果已经设置了账户，显示更改账户的确认对话框 + showChangeAccountConfirmAlertDialog(); + } + } else { + // 如果正在同步，显示提示信息 + Toast.makeText(NotesPreferenceActivity.this, + R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT) + .show(); + } + return true; + } + }); + + // 将账户偏好设置项添加到账户偏好设置类别中 + mAccountCategory.addPreference(accountPref); } - private void playAlarmSound() { - Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM); + /** + * 加载同步按钮和上次同步时间的显示 + */ + private void loadSyncButton() { + // 找到同步按钮和上次同步时间的文本视图 + Button syncButton = (Button) findViewById(R.id.preference_sync_button); + TextView lastSyncTimeView = (TextView) findViewById(R.id.prefenerece_sync_status_textview); - int silentModeStreams = Settings.System.getInt(getContentResolver(), - Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0); + // 根据同步状态设置按钮的文本和点击监听器 + 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))); - if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) { - mPlayer.setAudioStreamType(silentModeStreams); + // 根据同步状态设置上次同步时间的显示 + if (GTaskSyncService.isSyncing()) { + lastSyncTimeView.setText(GTaskSyncService.getProgressString()); + lastSyncTimeView.setVisibility(View.VISIBLE); } else { - mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM); + 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))); + lastSyncTimeView.setVisibility(View.VISIBLE); + } else { + lastSyncTimeView.setVisibility(View.GONE); + } } - try { - mPlayer.setDataSource(this, url); - mPlayer.prepare(); - mPlayer.setLooping(true); - mPlayer.start(); - } catch (IllegalArgumentException e) { - // TODO Auto-generated catch block - e.printStackTrace(); - } catch (SecurityException e) { - // TODO Auto-generated catch block - e.printStackTrace(); - } catch (IllegalStateException e) { - // TODO Auto-generated catch block - e.printStackTrace(); - } catch (IOException e) { - // TODO Auto-generated catch block - e.printStackTrace(); + } + + /** + * 刷新界面，重新加载账户偏好设置和同步按钮 + */ + private void refreshUI() { + loadAccountPreference(); + loadSyncButton(); + } + + /** + * 显示选择账户的对话框 + */ + private void showSelectAccountAlertDialog() { + // 创建一个 AlertDialog 构建器 + 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); + + // 获取所有的 Google 账户 + 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; + // 创建一个添加账户的意图 + 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 构建器 + 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 void showActionDialog() { - AlertDialog.Builder dialog = new AlertDialog.Builder(this); - dialog.setTitle(R.string.app_name); - dialog.setMessage(mSnippet); - dialog.setPositiveButton(R.string.notealert_ok, this); - if (isScreenOn()) { - dialog.setNegativeButton(R.string.notealert_enter, this); + /** + * 获取所有的 Google 账户 + * @return 包含所有 Google 账户的数组 + */ + private Account[] getGoogleAccounts() { + // 获取账户管理器 + AccountManager accountManager = AccountManager.get(this); + // 获取所有的 Google 账户 + return accountManager.getAccountsByType("com.google"); + } + + /** + * 设置同步账户 + * @param account 要设置的账户名称 + */ + 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(); + + // 清空上次同步时间 + setLastSyncTime(this, 0); + + // 清空本地的 GTask 相关信息 + new Thread(new Runnable() { + public void run() { + ContentValues values = new ContentValues(); + values.put(NoteColumns.GTASK_ID, ""); + values.put(NoteColumns.SYNC_ID, 0); + // 更新所有便签的 GTask 相关信息 + getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null); + } + }).start(); + + // 显示设置成功的提示信息 + Toast.makeText(NotesPreferenceActivity.this, + getString(R.string.preferences_toast_success_set_accout, account), + Toast.LENGTH_SHORT).show(); } - dialog.show().setOnDismissListener(this); } - public void onClick(DialogInterface dialog, int which) { - switch (which) { - case DialogInterface.BUTTON_NEGATIVE: - Intent intent = new Intent(this, NoteEditActivity.class); - intent.setAction(Intent.ACTION_VIEW); - intent.putExtra(Intent.EXTRA_UID, mNoteId); - startActivity(intent); - break; - default: - break; + /** + * 移除同步账户 + */ + 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(); + + // 清空本地的 GTask 相关信息 + new Thread(new Runnable() { + public void run() { + ContentValues values = new ContentValues(); + values.put(NoteColumns.GTASK_ID, ""); + values.put(NoteColumns.SYNC_ID, 0); + // 更新所有便签的 GTask 相关信息 + getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null); + } + }).start(); } - public void onDismiss(DialogInterface dialog) { - stopAlarmSound(); - finish(); + /** + * 获取当前的同步账户名称 + * @param context 上下文对象 + * @return 当前的同步账户名称，如果没有设置则返回空字符串 + */ + public static String getSyncAccountName(Context context) { + // 获取共享偏好设置 + SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, + Context.MODE_PRIVATE); + // 获取同步账户名称 + return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, ""); } - private void stopAlarmSound() { - if (mPlayer != null) { - mPlayer.stop(); - mPlayer.release(); - mPlayer = null; - } + /** + * 设置上次同步时间 + * @param context 上下文对象 + * @param time 上次同步的时间 + */ + 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(); } -} + + /** + * 获取上次同步时间 + * @param context 上下文对象 + * @return 上次同步的时间，如果没有同步过则返回 0 + */ + public static long getLastSyncTime(Context context) { + // 获取共享偏好设置 + SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, \ No newline at end of file diff --git a/Notes-master/src/net/micode/notes/ui/AlarmInitReceiver.java b/Notes-master/src/net/micode/notes/ui/AlarmInitReceiver.java index f221202..0666513 100644 --- a/Notes-master/src/net/micode/notes/ui/AlarmInitReceiver.java +++ b/Notes-master/src/net/micode/notes/ui/AlarmInitReceiver.java @@ -27,39 +27,66 @@ import android.database.Cursor; import net.micode.notes.data.Notes; import net.micode.notes.data.Notes.NoteColumns; - +/** + * AlarmInitReceiver 类是一个广播接收器，用于在接收到特定广播时， + * 初始化所有已设置且未触发的提醒闹钟。 + */ public class AlarmInitReceiver extends BroadcastReceiver { + // 定义查询笔记时需要的列，包括笔记的 ID 和提醒日期 private static final String [] PROJECTION = new String [] { NoteColumns.ID, NoteColumns.ALERTED_DATE }; + // 定义查询结果中笔记 ID 所在的列索引 private static final int COLUMN_ID = 0; + // 定义查询结果中提醒日期所在的列索引 private static final int COLUMN_ALERTED_DATE = 1; + /** + * 当接收到广播时，此方法会被调用。 + * 它会查询所有设置了提醒且提醒日期在当前时间之后的笔记， + * 并为每个笔记设置一个闹钟。 + * + * @param context 上下文对象，用于访问系统服务和内容提供者 + * @param intent 接收到的广播意图 + */ @Override public void onReceive(Context context, Intent intent) { + // 获取当前时间的毫秒数 long currentDate = System.currentTimeMillis(); + // 查询所有设置了提醒且提醒日期在当前时间之后的笔记 Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI, PROJECTION, + // 查询条件：提醒日期大于当前时间，并且笔记类型为普通笔记 NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE, new String[] { String.valueOf(currentDate) }, null); + // 如果查询结果不为空 if (c != null) { + // 将游标移动到第一行 if (c.moveToFirst()) { + // 循环遍历查询结果的每一行 do { + // 获取当前笔记的提醒日期 long alertDate = c.getLong(COLUMN_ALERTED_DATE); + // 创建一个新的意图，用于触发 AlarmReceiver 广播接收器 Intent sender = new Intent(context, AlarmReceiver.class); + // 设置意图的数据，包含笔记的 URI 和 ID sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID))); + // 创建一个 PendingIntent，用于在闹钟触发时发送广播 PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0); + // 获取系统的闹钟服务 AlarmManager alermManager = (AlarmManager) context .getSystemService(Context.ALARM_SERVICE); + // 设置一个 RTC_WAKEUP 类型的闹钟，在提醒日期触发时唤醒设备 alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent); } while (c.moveToNext()); } + // 关闭游标，释放资源 c.close(); } } -} +} \ No newline at end of file diff --git a/Notes-master/src/net/micode/notes/ui/DateTimePicker.java b/Notes-master/src/net/micode/notes/ui/DateTimePicker.java index 496b0cd..258c930 100644 --- a/Notes-master/src/net/micode/notes/ui/DateTimePicker.java +++ b/Notes-master/src/net/micode/notes/ui/DateTimePicker.java @@ -21,64 +21,100 @@ import java.util.Calendar; import net.micode.notes.R; - import android.content.Context; import android.text.format.DateFormat; import android.view.View; import android.widget.FrameLayout; import android.widget.NumberPicker; +/** + * DateTimePicker 类用于创建一个日期和时间选择器，它允许用户选择日期和时间。 + * 该选择器包含日期、小时、分钟和上午/下午（AM/PM）的选择功能。 + */ public class DateTimePicker extends FrameLayout { + // 默认的启用状态 private static final boolean DEFAULT_ENABLE_STATE = true; + // 半天的小时数 private static final int HOURS_IN_HALF_DAY = 12; + // 一整天的小时数 private static final int HOURS_IN_ALL_DAY = 24; + // 一周的天数 private static final int DAYS_IN_ALL_WEEK = 7; + // 日期选择器的最小值 private static final int DATE_SPINNER_MIN_VAL = 0; + // 日期选择器的最大值 private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1; + // 24小时制小时选择器的最小值 private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0; + // 24小时制小时选择器的最大值 private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23; + // 12小时制小时选择器的最小值 private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1; + // 12小时制小时选择器的最大值 private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12; + // 分钟选择器的最小值 private static final int MINUT_SPINNER_MIN_VAL = 0; + // 分钟选择器的最大值 private static final int MINUT_SPINNER_MAX_VAL = 59; + // 上午/下午（AM/PM）选择器的最小值 private static final int AMPM_SPINNER_MIN_VAL = 0; + // 上午/下午（AM/PM）选择器的最大值 private static final int AMPM_SPINNER_MAX_VAL = 1; + // 日期选择器 private final NumberPicker mDateSpinner; + // 小时选择器 private final NumberPicker mHourSpinner; + // 分钟选择器 private final NumberPicker mMinuteSpinner; + // 上午/下午（AM/PM）选择器 private final NumberPicker mAmPmSpinner; + // 用于存储当前日期和时间的 Calendar 对象 private Calendar mDate; + // 用于显示日期的字符串数组 private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK]; + // 是否为上午的标志 private boolean mIsAm; + // 是否为24小时制的标志 private boolean mIs24HourView; + // 选择器的启用状态 private boolean mIsEnabled = DEFAULT_ENABLE_STATE; + // 初始化标志，用于避免在初始化过程中触发不必要的事件 private boolean mInitialising; + // 日期和时间改变监听器 private OnDateTimeChangedListener mOnDateTimeChangedListener; + // 日期选择器值改变监听器 private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() { @Override public void onValueChange(NumberPicker picker, int oldVal, int newVal) { + // 根据新值和旧值的差值，更新日期 mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal); + // 更新日期选择器的显示 updateDateControl(); + // 触发日期和时间改变事件 onDateTimeChanged(); } }; + // 小时选择器值改变监听器 private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() { @Override public void onValueChange(NumberPicker picker, int oldVal, int newVal) { + // 日期是否改变的标志 boolean isDateChanged = false; + // 创建一个新的 Calendar 对象 Calendar cal = Calendar.getInstance(); if (!mIs24HourView) { + // 在12小时制下，处理跨天的情况 if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) { cal.setTimeInMillis(mDate.getTimeInMillis()); cal.add(Calendar.DAY_OF_YEAR, 1); @@ -88,12 +124,15 @@ public class DateTimePicker extends FrameLayout { cal.add(Calendar.DAY_OF_YEAR, -1); isDateChanged = true; } + // 处理上午/下午（AM/PM）的切换 if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY || oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) { mIsAm = !mIsAm; + // 更新上午/下午（AM/PM）选择器的显示 updateAmPmControl(); } } else { + // 在24小时制下，处理跨天的情况 if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) { cal.setTimeInMillis(mDate.getTimeInMillis()); cal.add(Calendar.DAY_OF_YEAR, 1); @@ -104,10 +143,14 @@ public class DateTimePicker extends FrameLayout { isDateChanged = true; } } + // 计算新的小时数 int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY); + // 设置新的小时数 mDate.set(Calendar.HOUR_OF_DAY, newHour); + // 触发日期和时间改变事件 onDateTimeChanged(); if (isDateChanged) { + // 如果日期改变，更新年、月、日 setCurrentYear(cal.get(Calendar.YEAR)); setCurrentMonth(cal.get(Calendar.MONTH)); setCurrentDay(cal.get(Calendar.DAY_OF_MONTH)); @@ -115,182 +158,269 @@ public class DateTimePicker extends FrameLayout { } }; + // 分钟选择器值改变监听器 private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() { @Override public void onValueChange(NumberPicker picker, int oldVal, int newVal) { + // 分钟选择器的最小值 int minValue = mMinuteSpinner.getMinValue(); + // 分钟选择器的最大值 int maxValue = mMinuteSpinner.getMaxValue(); + // 小时偏移量 int offset = 0; + // 处理分钟跨小时的情况 if (oldVal == maxValue && newVal == minValue) { offset += 1; } else if (oldVal == minValue && newVal == maxValue) { offset -= 1; } if (offset != 0) { + // 根据偏移量更新小时数 mDate.add(Calendar.HOUR_OF_DAY, offset); + // 更新小时选择器的显示 mHourSpinner.setValue(getCurrentHour()); + // 更新日期选择器的显示 updateDateControl(); + // 获取当前小时数 int newHour = getCurrentHourOfDay(); if (newHour >= HOURS_IN_HALF_DAY) { mIsAm = false; + // 更新上午/下午（AM/PM）选择器的显示 updateAmPmControl(); } else { mIsAm = true; + // 更新上午/下午（AM/PM）选择器的显示 updateAmPmControl(); } } + // 设置新的分钟数 mDate.set(Calendar.MINUTE, newVal); + // 触发日期和时间改变事件 onDateTimeChanged(); } }; + // 上午/下午（AM/PM）选择器值改变监听器 private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() { @Override public void onValueChange(NumberPicker picker, int oldVal, int newVal) { + // 切换上午/下午（AM/PM）状态 mIsAm = !mIsAm; if (mIsAm) { + // 如果切换到上午，减去12小时 mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY); } else { + // 如果切换到下午，加上12小时 mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY); } + // 更新上午/下午（AM/PM）选择器的显示 updateAmPmControl(); + // 触发日期和时间改变事件 onDateTimeChanged(); } }; + /** + * 日期和时间改变监听器接口，用于在日期和时间改变时通知外部 + */ public interface OnDateTimeChangedListener { + /** + * 当日期和时间改变时调用 + * + * @param view DateTimePicker 视图 + * @param year 年份 + * @param month 月份 + * @param dayOfMonth 日 + * @param hourOfDay 小时（24小时制） + * @param minute 分钟 + */ void onDateTimeChanged(DateTimePicker view, int year, int month, - int dayOfMonth, int hourOfDay, int minute); + int dayOfMonth, int hourOfDay, int minute); } + /** + * 构造函数，使用当前时间初始化 + * + * @param context 上下文 + */ public DateTimePicker(Context context) { this(context, System.currentTimeMillis()); } + /** + * 构造函数，使用指定的时间初始化 + * + * @param context 上下文 + * @param date 时间（毫秒） + */ public DateTimePicker(Context context, long date) { this(context, date, DateFormat.is24HourFormat(context)); } + /** + * 构造函数，使用指定的时间和是否为24小时制初始化 + * + * @param context 上下文 + * @param date 时间（毫秒） + * @param is24HourView 是否为24小时制 + */ public DateTimePicker(Context context, long date, boolean is24HourView) { super(context); + // 初始化 Calendar 对象 mDate = Calendar.getInstance(); + // 设置初始化标志 mInitialising = true; + // 判断当前是否为上午 mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY; + // 加载布局文件 inflate(context, R.layout.datetime_picker, this); + // 初始化日期选择器 mDateSpinner = (NumberPicker) findViewById(R.id.date); mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL); mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL); mDateSpinner.setOnValueChangedListener(mOnDateChangedListener); + // 初始化小时选择器 mHourSpinner = (NumberPicker) findViewById(R.id.hour); mHourSpinner.setOnValueChangedListener(mOnHourChangedListener); + // 初始化分钟选择器 mMinuteSpinner = (NumberPicker) findViewById(R.id.minute); mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL); mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL); mMinuteSpinner.setOnLongPressUpdateInterval(100); mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener); + // 获取上午/下午（AM/PM）的字符串数组 String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings(); + // 初始化上午/下午（AM/PM）选择器 mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm); mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL); mAmPmSpinner.setMaxValue(AMPM_SPINNER_MAX_VAL); mAmPmSpinner.setDisplayedValues(stringsForAmPm); mAmPmSpinner.setOnValueChangedListener(mOnAmPmChangedListener); - // update controls to initial state + // 更新日期选择器的显示 updateDateControl(); + // 更新小时选择器的显示 updateHourControl(); + // 更新上午/下午（AM/PM）选择器的显示 updateAmPmControl(); + // 设置是否为24小时制 set24HourView(is24HourView); - // set to current time + // 设置当前日期和时间 setCurrentDate(date); + // 设置选择器的启用状态 setEnabled(isEnabled()); - // set the content descriptions + // 设置内容描述 mInitialising = false; } + /** + * 设置选择器的启用状态 + * + * @param enabled 是否启用 + */ @Override public void setEnabled(boolean enabled) { if (mIsEnabled == enabled) { return; } super.setEnabled(enabled); + // 设置日期选择器的启用状态 mDateSpinner.setEnabled(enabled); + // 设置分钟选择器的启用状态 mMinuteSpinner.setEnabled(enabled); + // 设置小时选择器的启用状态 mHourSpinner.setEnabled(enabled); + // 设置上午/下午（AM/PM）选择器的启用状态 mAmPmSpinner.setEnabled(enabled); + // 更新启用状态标志 mIsEnabled = enabled; } + /** + * 获取选择器的启用状态 + * + * @return 是否启用 + */ @Override public boolean isEnabled() { return mIsEnabled; } /** - * Get the current date in millis + * 获取当前日期和时间（毫秒） * - * @return the current date in millis + * @return 当前日期和时间（毫秒） */ public long getCurrentDateInTimeMillis() { return mDate.getTimeInMillis(); } /** - * Set the current date + * 设置当前日期和时间 * - * @param date The current date in millis + * @param date 当前日期和时间（毫秒） */ public void setCurrentDate(long date) { Calendar cal = Calendar.getInstance(); cal.setTimeInMillis(date); + // 设置年、月、日、小时、分钟 setCurrentDate(cal.get(Calendar.YEAR), cal.get(Calendar.MONTH), cal.get(Calendar.DAY_OF_MONTH), cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE)); } /** - * Set the current date + * 设置当前日期和时间 * - * @param year The current year - * @param month The current month - * @param dayOfMonth The current dayOfMonth - * @param hourOfDay The current hourOfDay - * @param minute The current minute + * @param year 年份 + * @param month 月份 + * @param dayOfMonth 日 + * @param hourOfDay 小时（24小时制） + * @param minute 分钟 */ public void setCurrentDate(int year, int month, - int dayOfMonth, int hourOfDay, int minute) { + int dayOfMonth, int hourOfDay, int minute) { + // 设置年份 setCurrentYear(year); + // 设置月份 setCurrentMonth(month); + // 设置日期 setCurrentDay(dayOfMonth); + // 设置小时 setCurrentHour(hourOfDay); + // 设置分钟 setCurrentMinute(minute); } /** - * Get current year + * 获取当前年份 * - * @return The current year + * @return 当前年份 */ public int getCurrentYear() { return mDate.get(Calendar.YEAR); } /** - * Set current year + * 设置当前年份 * - * @param year The current year + * @param year 当前年份 */ public void setCurrentYear(int year) { if (!mInitialising && year == getCurrentYear()) { return; } + // 设置年份 mDate.set(Calendar.YEAR, year); + // 更新日期选择器的显示 updateDateControl(); + // 触发日期和时间改变事件 onDateTimeChanged(); } diff --git a/Notes-master/src/net/micode/notes/ui/DateTimePickerDialog.java b/Notes-master/src/net/micode/notes/ui/DateTimePickerDialog.java index 2c47ba4..86e04df 100644 --- a/Notes-master/src/net/micode/notes/ui/DateTimePickerDialog.java +++ b/Notes-master/src/net/micode/notes/ui/DateTimePickerDialog.java @@ -29,59 +29,126 @@ import android.content.DialogInterface.OnClickListener; import android.text.format.DateFormat; import android.text.format.DateUtils; +/** + * DateTimePickerDialog 类继承自 AlertDialog，用于显示一个日期和时间选择对话框。 + * 用户可以通过这个对话框选择特定的日期和时间。 + */ public class DateTimePickerDialog extends AlertDialog implements OnClickListener { + // 用于存储用户选择的日期和时间的 Calendar 对象 private Calendar mDate = Calendar.getInstance(); + // 标记是否使用 24 小时制显示时间 private boolean mIs24HourView; + // 用于处理日期和时间设置完成后的回调接口 private OnDateTimeSetListener mOnDateTimeSetListener; + // 自定义的日期和时间选择器 private DateTimePicker mDateTimePicker; + /** + * 定义一个接口，用于在用户设置日期和时间后进行回调。 + */ public interface OnDateTimeSetListener { + /** + * 当用户设置日期和时间后调用此方法。 + * @param dialog 日期和时间选择对话框实例 + * @param date 用户选择的日期和时间的毫秒数 + */ void OnDateTimeSet(AlertDialog dialog, long date); } + /** + * 构造函数，用于创建一个 DateTimePickerDialog 实例。 + * @param context 上下文对象 + * @param date 初始显示的日期和时间的毫秒数 + */ public DateTimePickerDialog(Context context, long date) { super(context); + // 创建一个 DateTimePicker 实例 mDateTimePicker = new DateTimePicker(context); + // 将 DateTimePicker 设置为对话框的视图 setView(mDateTimePicker); + + // 为 DateTimePicker 设置日期和时间改变监听器 mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() { + /** + * 当日期或时间发生改变时调用此方法。 + * @param view 日期和时间选择器视图 + * @param year 选择的年份 + * @param month 选择的月份 + * @param dayOfMonth 选择的日期 + * @param hourOfDay 选择的小时 + * @param minute 选择的分钟 + */ public void onDateTimeChanged(DateTimePicker view, int year, int month, int dayOfMonth, int hourOfDay, int minute) { + // 更新 Calendar 对象中的日期和时间 mDate.set(Calendar.YEAR, year); mDate.set(Calendar.MONTH, month); mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth); mDate.set(Calendar.HOUR_OF_DAY, hourOfDay); mDate.set(Calendar.MINUTE, minute); + // 更新对话框的标题，显示当前选择的日期和时间 updateTitle(mDate.getTimeInMillis()); } }); + + // 设置 Calendar 对象的时间为传入的初始时间 mDate.setTimeInMillis(date); + // 将秒数设置为 0 mDate.set(Calendar.SECOND, 0); + // 设置 DateTimePicker 的当前日期和时间 mDateTimePicker.setCurrentDate(mDate.getTimeInMillis()); + + // 设置对话框的“确定”按钮，并设置点击监听器为当前类 setButton(context.getString(R.string.datetime_dialog_ok), this); + // 设置对话框的“取消”按钮，不设置点击监听器 setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null); + + // 根据系统设置判断是否使用 24 小时制，并设置相应的显示模式 set24HourView(DateFormat.is24HourFormat(this.getContext())); + // 更新对话框的标题，显示初始日期和时间 updateTitle(mDate.getTimeInMillis()); } + /** + * 设置是否使用 24 小时制显示时间。 + * @param is24HourView 是否使用 24 小时制 + */ public void set24HourView(boolean is24HourView) { mIs24HourView = is24HourView; } + /** + * 设置日期和时间设置完成后的回调监听器。 + * @param callBack 实现了 OnDateTimeSetListener 接口的回调对象 + */ public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) { mOnDateTimeSetListener = callBack; } + /** + * 更新对话框的标题，显示当前选择的日期和时间。 + * @param date 当前选择的日期和时间的毫秒数 + */ private void updateTitle(long date) { + // 设置日期和时间格式化的标志 int flag = DateUtils.FORMAT_SHOW_YEAR | DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_SHOW_TIME; + // 根据是否使用 24 小时制添加相应的标志 flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR; + // 使用 DateUtils 格式化日期和时间，并设置为对话框的标题 setTitle(DateUtils.formatDateTime(this.getContext(), date, flag)); } + /** + * 处理对话框按钮的点击事件。 + * @param arg0 对话框接口对象 + * @param arg1 按钮的索引 + */ public void onClick(DialogInterface arg0, int arg1) { + // 如果设置了回调监听器，则调用其 OnDateTimeSet 方法 if (mOnDateTimeSetListener != null) { mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis()); } diff --git a/Notes-master/src/net/micode/notes/ui/NoteEditActivity.java b/Notes-master/src/net/micode/notes/ui/NoteEditActivity.java index de98982..816f37d 100644 --- a/Notes-master/src/net/micode/notes/ui/NoteEditActivity.java +++ b/Notes-master/src/net/micode/notes/ui/NoteEditActivity.java @@ -71,103 +71,148 @@ import java.util.Map; import java.util.regex.Matcher; import java.util.regex.Pattern; -//笔记编辑功能 +/** + * NoteEditActivity 类用于编辑笔记，处理笔记的创建、加载、保存以及相关设置，如背景颜色、字体大小等。 + */ public class NoteEditActivity extends Activity implements OnClickListener, NoteSettingChangedListener, OnTextViewChangeListener { + + /** + * 头部视图的ViewHolder，用于存储头部视图的相关控件。 + */ private class HeadViewHolder { + // 显示笔记修改日期的TextView public TextView tvModified; - + // 提醒图标ImageView public ImageView ivAlertIcon; - + // 显示提醒日期的TextView public TextView tvAlertDate; - + // 设置背景颜色的按钮ImageView public ImageView ibSetBgColor; } - //便签背景选择按钮 + + // 背景选择按钮和对应背景资源ID的映射 private static final Map sBgSelectorBtnsMap = new HashMap(); static { + // 黄色背景按钮和对应资源ID sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW); + // 红色背景按钮和对应资源ID sBgSelectorBtnsMap.put(R.id.iv_bg_red, ResourceParser.RED); + // 蓝色背景按钮和对应资源ID sBgSelectorBtnsMap.put(R.id.iv_bg_blue, ResourceParser.BLUE); + // 绿色背景按钮和对应资源ID sBgSelectorBtnsMap.put(R.id.iv_bg_green, ResourceParser.GREEN); + // 白色背景按钮和对应资源ID sBgSelectorBtnsMap.put(R.id.iv_bg_white, ResourceParser.WHITE); } + // 背景选择和对应选中状态视图ID的映射 private static final Map sBgSelectorSelectionMap = new HashMap(); static { + // 黄色背景选中状态视图ID sBgSelectorSelectionMap.put(ResourceParser.YELLOW, R.id.iv_bg_yellow_select); + // 红色背景选中状态视图ID sBgSelectorSelectionMap.put(ResourceParser.RED, R.id.iv_bg_red_select); + // 蓝色背景选中状态视图ID sBgSelectorSelectionMap.put(ResourceParser.BLUE, R.id.iv_bg_blue_select); + // 绿色背景选中状态视图ID sBgSelectorSelectionMap.put(ResourceParser.GREEN, R.id.iv_bg_green_select); + // 白色背景选中状态视图ID sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select); } + // 字体大小按钮和对应字体大小资源ID的映射 private static final Map sFontSizeBtnsMap = new HashMap(); static { + // 大字体按钮和对应资源ID sFontSizeBtnsMap.put(R.id.ll_font_large, ResourceParser.TEXT_LARGE); + // 小字体按钮和对应资源ID sFontSizeBtnsMap.put(R.id.ll_font_small, ResourceParser.TEXT_SMALL); + // 正常字体按钮和对应资源ID sFontSizeBtnsMap.put(R.id.ll_font_normal, ResourceParser.TEXT_MEDIUM); + // 超大字体按钮和对应资源ID sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER); } + // 字体选择和对应选中状态视图ID的映射 private static final Map sFontSelectorSelectionMap = new HashMap(); static { + // 大字体选中状态视图ID sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE, R.id.iv_large_select); + // 小字体选中状态视图ID sFontSelectorSelectionMap.put(ResourceParser.TEXT_SMALL, R.id.iv_small_select); + // 正常字体选中状态视图ID sFontSelectorSelectionMap.put(ResourceParser.TEXT_MEDIUM, R.id.iv_medium_select); + // 超大字体选中状态视图ID sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select); } + // 日志标签 private static final String TAG = "NoteEditActivity"; + // 头部视图的ViewHolder实例 private HeadViewHolder mNoteHeaderHolder; - + // 头部视图面板 private View mHeadViewPanel; - + // 背景颜色选择器视图 private View mNoteBgColorSelector; - + // 字体大小选择器视图 private View mFontSizeSelector; - + // 笔记编辑器EditText private EditText mNoteEditor; - + // 笔记编辑器面板 private View mNoteEditorPanel; - + // 工作笔记实例 private WorkingNote mWorkingNote; - + // 共享偏好设置 private SharedPreferences mSharedPrefs; + // 字体大小ID private int mFontSizeId; + // 共享偏好设置中字体大小的键 private static final String PREFERENCE_FONT_SIZE = "pref_font_size"; - + // 快捷图标标题的最大长度 private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10; - + // 已选中标记 public static final String TAG_CHECKED = String.valueOf('\u221A'); + // 未选中标记 public static final String TAG_UNCHECKED = String.valueOf('\u25A1'); - + // 编辑文本列表 private LinearLayout mEditTextList; - + // 用户查询关键词 private String mUserQuery; + // 正则表达式模式 private Pattern mPattern; + /** + * 活动创建时调用，初始化布局和状态。 + * + * @param savedInstanceState 保存的实例状态 + */ @Override - //创建时进行初始化操作 protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); - //将布局样式进行添加 + // 设置布局 this.setContentView(R.layout.note_edit); + + // 如果是首次创建且初始化活动状态失败，则关闭活动 if (savedInstanceState == null && !initActivityState(getIntent())) { finish(); return; } + // 初始化资源 initResources(); } /** - * 当前Activity可能因内存不足被杀死，再次加载时应恢复之前的状态 + * 恢复活动状态时调用，用于恢复之前保存的状态。 + * + * @param savedInstanceState 保存的实例状态 */ @Override protected void onRestoreInstanceState(Bundle savedInstanceState) { super.onRestoreInstanceState(savedInstanceState); + // 如果保存的实例状态不为空且包含笔记ID，则恢复活动状态 if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) { Intent intent = new Intent(Intent.ACTION_VIEW); intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID)); @@ -178,31 +223,39 @@ public class NoteEditActivity extends Activity implements OnClickListener, Log.d(TAG, "Restoring from killed activity"); } } - //初始化活动状态函数 + + /** + * 初始化活动状态，根据意图加载或创建笔记。 + * + * @param intent 传入的意图 + * @return 如果初始化成功返回true，否则返回false + */ private boolean initActivityState(Intent intent) { - /** - * 如果用户指定查看笔记但未提供ID，跳转到笔记列表页 - */ + // 清空工作笔记 mWorkingNote = null; + // 如果是查看笔记的意图 if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) { + // 获取笔记ID long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0); + // 初始化用户查询为空 mUserQuery = ""; - /** - * 如果是从搜索结果启动 - */ + // 如果是从搜索结果启动的 if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) { noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY)); mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY); } + // 检查笔记是否在数据库中可见 if (!DataUtils.visibleInNoteDatabase(getContentResolver(), noteId, Notes.TYPE_NOTE)) { + // 不可见则跳转到笔记列表活动并提示错误 Intent jump = new Intent(this, NotesListActivity.class); startActivity(jump); showToast(R.string.error_note_not_exist); finish(); return false; } else { + // 加载笔记 mWorkingNote = WorkingNote.load(this, noteId); if (mWorkingNote == null) { Log.e(TAG, "load note failed with note id" + noteId); @@ -210,17 +263,21 @@ public class NoteEditActivity extends Activity implements OnClickListener, return false; } } - //设置软键盘 + // 设置软键盘模式 getWindow().setSoftInputMode( WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN | WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE); } else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) { - // 新建笔记 + // 插入或编辑笔记的意图 + // 获取文件夹ID long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0); + // 获取小部件ID int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID); + // 获取小部件类型 int widgetType = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, Notes.TYPE_WIDGET_INVALIDE); + // 获取背景资源ID int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, ResourceParser.getDefaultBgId(this)); @@ -232,6 +289,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, Log.w(TAG, "The call record number is null"); } long noteId = 0; + // 检查是否已有该通话记录的笔记 if ((noteId = DataUtils.getNoteIdByPhoneNumberAndCallDate(getContentResolver(), phoneNumber, callDate)) > 0) { mWorkingNote = WorkingNote.load(this, noteId); @@ -241,15 +299,18 @@ public class NoteEditActivity extends Activity implements OnClickListener, return false; } } else { + // 创建新的通话记录笔记 mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, widgetType, bgResId); mWorkingNote.convertToCallNote(phoneNumber, callDate); } } else { + // 创建新的普通笔记 mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, widgetType, bgResId); } + // 设置软键盘模式 getWindow().setSoftInputMode( WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE | WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE); @@ -258,72 +319,110 @@ public class NoteEditActivity extends Activity implements OnClickListener, finish(); return false; } + // 设置笔记设置状态改变监听器 mWorkingNote.setOnSettingStatusChangedListener(this); return true; } + /** + * 活动恢复时调用，初始化笔记界面。 + */ @Override - //Activity恢复时调用，初始化笔记界面 protected void onResume() { super.onResume(); initNoteScreen(); } - //设置文本样式、背景等 + + /** + * 初始化笔记界面，设置文本样式、显示内容、背景颜色和提醒信息等。 + */ private void initNoteScreen() { + // 设置笔记编辑器的文本样式 mNoteEditor.setTextAppearance(this, TextAppearanceResources .getTexAppearanceResource(mFontSizeId)); + // 如果是复选列表模式 if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { + // 切换到列表模式 switchToListMode(mWorkingNote.getContent()); } else { + // 设置笔记编辑器的文本并高亮显示查询结果 mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery)); + // 将光标移动到文本末尾 mNoteEditor.setSelection(mNoteEditor.getText().length()); } + // 隐藏所有背景选择的选中状态视图 for (Integer id : sBgSelectorSelectionMap.keySet()) { findViewById(sBgSelectorSelectionMap.get(id)).setVisibility(View.GONE); } + // 设置头部视图面板的背景资源 mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId()); + // 设置笔记编辑器面板的背景资源 mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId()); + // 设置笔记修改日期的显示 mNoteHeaderHolder.tvModified.setText(DateUtils.formatDateTime(this, mWorkingNote.getModifiedDate(), DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_NUMERIC_DATE | DateUtils.FORMAT_SHOW_TIME | DateUtils.FORMAT_SHOW_YEAR)); /** - * TODO: 添加设置提醒的菜单，目前因日期选择器未准备好而禁用 + * TODO: Add the menu for setting alert. Currently disable it because the DateTimePicker + * is not ready */ + // 显示提醒头部信息 showAlertHeader(); } - //显示提醒头部信息，根据是否有提醒的设置显示相应内容 + + /** + * 显示提醒头部信息，根据笔记的提醒状态显示提醒图标和日期。 + */ private void showAlertHeader() { + // 如果笔记有提醒设置 if (mWorkingNote.hasClockAlert()) { long time = System.currentTimeMillis(); + // 如果提醒时间已过 if (time > mWorkingNote.getAlertDate()) { mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired); } else { + // 显示相对提醒时间 mNoteHeaderHolder.tvAlertDate.setText(DateUtils.getRelativeTimeSpanString( mWorkingNote.getAlertDate(), time, DateUtils.MINUTE_IN_MILLIS)); } + // 显示提醒日期和图标 mNoteHeaderHolder.tvAlertDate.setVisibility(View.VISIBLE); mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE); } else { + // 隐藏提醒日期和图标 mNoteHeaderHolder.tvAlertDate.setVisibility(View.GONE); mNoteHeaderHolder.ivAlertIcon.setVisibility(View.GONE); }; } + /** + * 当活动接收到新的意图时调用，重新初始化活动状态。 + * + * @param intent 新的意图 + */ @Override - //重新初始化活动状态 protected void onNewIntent(Intent intent) { super.onNewIntent(intent); initActivityState(intent); } + /** + * 保存活动状态时调用，保存笔记ID到实例状态中。 + * + * @param outState 要保存的实例状态 + */ @Override - //用于保存笔记id protected void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); - //若未保存笔记，则先保存笔记id + // 如果笔记还未保存到数据库中，则先 + /** + * For new note without note id, we should firstly save it to + * generate a id. If the editing note is not worth saving, there + * is no id which is equivalent to create new note + */ if (!mWorkingNote.existInDatabase()) { saveNote(); } @@ -332,7 +431,6 @@ public class NoteEditActivity extends Activity implements OnClickListener, } @Override - //添加触摸事件，处理背景颜色和字体大小选项的显示和隐藏 public boolean dispatchTouchEvent(MotionEvent ev) { if (mNoteBgColorSelector.getVisibility() == View.VISIBLE && !inRangeOfView(mNoteBgColorSelector, ev)) { @@ -373,7 +471,6 @@ public class NoteEditActivity extends Activity implements OnClickListener, mNoteEditor = (EditText) findViewById(R.id.note_edit_view); mNoteEditorPanel = findViewById(R.id.sv_note_edit); mNoteBgColorSelector = findViewById(R.id.note_bg_color_selector); - //为控件添加事件监听器，点击时触发当前类的onClick方法 for (int id : sBgSelectorBtnsMap.keySet()) { ImageView iv = (ImageView) findViewById(id); iv.setOnClickListener(this); @@ -387,9 +484,9 @@ public class NoteEditActivity extends Activity implements OnClickListener, mSharedPrefs = PreferenceManager.getDefaultSharedPreferences(this); mFontSizeId = mSharedPrefs.getInt(PREFERENCE_FONT_SIZE, ResourceParser.BG_DEFAULT_FONT_SIZE); /** - * HACKME: 修复在 SharedPreferences 中存储资源 id 可能出现的问题。 - * * 存储的 id 可能会大于资源数组的长度，在这种情况下， - * * 返回 {@link ResourceParser#BG_DEFAULT_FONT_SIZE} + * HACKME: Fix bug of store the resource id in shared preference. + * The id may larger than the length of resources, in this case, + * return the {@link ResourceParser#BG_DEFAULT_FONT_SIZE} */ if(mFontSizeId >= TextAppearanceResources.getResourcesSize()) { mFontSizeId = ResourceParser.BG_DEFAULT_FONT_SIZE; @@ -398,28 +495,21 @@ public class NoteEditActivity extends Activity implements OnClickListener, } @Override - //当Activity暂停时调用此方法 protected void onPause() { - //调用父类的onPause方法 super.onPause(); - //保存笔记 if(saveNote()) { - //记录日志信息 Log.d(TAG, "Note data was saved with length:" + mWorkingNote.getContent().length()); } - //清除设置状态 clearSettingState(); } - //更新部件的方法 + private void updateWidget() { Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE); - //判断部件的类型，并为intent的目标类设置一定的效果 if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) { intent.setClass(this, NoteWidgetProvider_2x.class); } else if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_4X) { intent.setClass(this, NoteWidgetProvider_4x.class); } else { - //记录错误日志信息 Log.e(TAG, "Unspported widget type"); return; } diff --git a/Notes-master/src/net/micode/notes/ui/NoteEditText.java b/Notes-master/src/net/micode/notes/ui/NoteEditText.java index 2afe2a8..986f58f 100644 --- a/Notes-master/src/net/micode/notes/ui/NoteEditText.java +++ b/Notes-master/src/net/micode/notes/ui/NoteEditText.java @@ -37,83 +37,134 @@ import net.micode.notes.R; import java.util.HashMap; import java.util.Map; +/** + * NoteEditText 类继承自 EditText，用于自定义笔记编辑文本框的行为。 + * 该类处理了按键事件、触摸事件、焦点变化事件和上下文菜单事件， + * 同时提供了与外部活动通信的接口，以便在特定事件发生时通知外部。 + */ public class NoteEditText extends EditText { + // 日志标签，用于调试输出 private static final String TAG = "NoteEditText"; + // 当前编辑文本框的索引，用于标识其在一组编辑文本框中的位置 private int mIndex; + // 删除操作前的选择起始位置 private int mSelectionStartBeforeDelete; + // 定义支持的 URL 协议 private static final String SCHEME_TEL = "tel:" ; private static final String SCHEME_HTTP = "http:" ; private static final String SCHEME_EMAIL = "mailto:" ; + // 存储协议与对应菜单项资源 ID 的映射 private static final Map sSchemaActionResMap = new HashMap(); static { + // 初始化映射，将不同协议与对应的菜单项资源 ID 关联 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); } /** - * Call by the {@link NoteEditActivity} to delete or add edit text + * OnTextViewChangeListener 接口定义了在编辑文本框发生特定事件时的回调方法。 + * 这些方法用于通知外部活动进行相应的处理，如删除、添加编辑文本框或隐藏/显示选项。 */ public interface OnTextViewChangeListener { /** - * Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens - * and the text is null + * 当按下删除键（{@link KeyEvent#KEYCODE_DEL}）且文本为空时，删除当前编辑文本框。 + * @param index 当前编辑文本框的索引 + * @param text 当前编辑文本框中的文本 */ void onEditTextDelete(int index, String text); /** - * Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER} - * happen + * 当按下回车键（{@link KeyEvent#KEYCODE_ENTER}）时，在当前编辑文本框之后添加一个新的编辑文本框。 + * @param index 新编辑文本框的索引 + * @param text 从当前光标位置到文本末尾的文本 */ void onEditTextEnter(int index, String text); /** - * Hide or show item option when text change + * 当文本发生变化时，隐藏或显示选项。 + * @param index 当前编辑文本框的索引 + * @param hasText 文本是否为空 */ void onTextChange(int index, boolean hasText); } + // 外部活动实现的 OnTextViewChangeListener 接口实例 private OnTextViewChangeListener mOnTextViewChangeListener; + /** + * 构造函数，使用默认属性创建 NoteEditText 实例。 + * @param context 上下文对象 + */ public NoteEditText(Context context) { super(context, null); + // 初始化索引为 0 mIndex = 0; } + /** + * 设置当前编辑文本框的索引。 + * @param index 要设置的索引值 + */ public void setIndex(int index) { mIndex = index; } + /** + * 设置 OnTextViewChangeListener 接口实例，用于与外部活动通信。 + * @param listener 实现了 OnTextViewChangeListener 接口的实例 + */ public void setOnTextViewChangeListener(OnTextViewChangeListener listener) { mOnTextViewChangeListener = listener; } + /** + * 构造函数，使用指定的属性集创建 NoteEditText 实例。 + * @param context 上下文对象 + * @param attrs 属性集 + */ public NoteEditText(Context context, AttributeSet attrs) { super(context, attrs, android.R.attr.editTextStyle); } + /** + * 构造函数，使用指定的属性集和默认样式创建 NoteEditText 实例。 + * @param context 上下文对象 + * @param attrs 属性集 + * @param defStyle 默认样式 + */ public NoteEditText(Context context, AttributeSet attrs, int defStyle) { super(context, attrs, defStyle); // TODO Auto-generated constructor stub } + /** + * 处理触摸事件，当触摸按下时，更新文本选择位置。 + * @param event 触摸事件对象 + * @return 处理结果，返回父类的处理结果 + */ @Override public boolean onTouchEvent(MotionEvent event) { switch (event.getAction()) { case MotionEvent.ACTION_DOWN: - + // 获取触摸点的坐标 int x = (int) event.getX(); int y = (int) event.getY(); + // 调整坐标，去除内边距并考虑滚动 x -= getTotalPaddingLeft(); y -= getTotalPaddingTop(); x += getScrollX(); y += getScrollY(); + // 获取文本布局 Layout layout = getLayout(); + // 根据垂直坐标获取所在行 int line = layout.getLineForVertical(y); + // 根据行和水平坐标获取字符偏移量 int off = layout.getOffsetForHorizontal(line, x); + // 设置文本选择位置 Selection.setSelection(getText(), off); break; } @@ -121,15 +172,23 @@ public class NoteEditText extends EditText { return super.onTouchEvent(event); } + /** + * 处理按键按下事件，记录删除操作前的选择起始位置。 + * @param keyCode 按键代码 + * @param event 按键事件对象 + * @return 处理结果，返回父类的处理结果 + */ @Override public boolean onKeyDown(int keyCode, KeyEvent event) { switch (keyCode) { case KeyEvent.KEYCODE_ENTER: + // 如果设置了 OnTextViewChangeListener 接口实例，返回 false if (mOnTextViewChangeListener != null) { return false; } break; case KeyEvent.KEYCODE_DEL: + // 记录删除操作前的选择起始位置 mSelectionStartBeforeDelete = getSelectionStart(); break; default: @@ -138,26 +197,41 @@ public class NoteEditText extends EditText { return super.onKeyDown(keyCode, event); } + /** + * 处理按键释放事件，根据按键代码调用相应的回调方法。 + * @param keyCode 按键代码 + * @param event 按键事件对象 + * @return 处理结果，返回父类的处理结果 + */ @Override public boolean onKeyUp(int keyCode, KeyEvent event) { switch(keyCode) { case KeyEvent.KEYCODE_DEL: + // 如果设置了 OnTextViewChangeListener 接口实例 if (mOnTextViewChangeListener != null) { + // 当选择起始位置为 0 且索引不为 0 时，调用删除回调方法 if (0 == mSelectionStartBeforeDelete && mIndex != 0) { mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString()); return true; } } else { + // 未设置 OnTextViewChangeListener 接口实例，输出日志 Log.d(TAG, "OnTextViewChangeListener was not seted"); } break; case KeyEvent.KEYCODE_ENTER: + // 如果设置了 OnTextViewChangeListener 接口实例 if (mOnTextViewChangeListener != null) { + // 获取当前选择起始位置 int selectionStart = getSelectionStart(); + // 获取从当前光标位置到文本末尾的文本 String text = getText().subSequence(selectionStart, length()).toString(); + // 更新文本，保留当前光标之前的部分 setText(getText().subSequence(0, selectionStart)); + // 调用添加编辑文本框的回调方法 mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text); } else { + // 未设置 OnTextViewChangeListener 接口实例，输出日志 Log.d(TAG, "OnTextViewChangeListener was not seted"); } break; @@ -167,45 +241,68 @@ public class NoteEditText extends EditText { return super.onKeyUp(keyCode, event); } + /** + * 处理焦点变化事件，根据焦点状态和文本内容调用文本变化回调方法。 + * @param focused 是否获得焦点 + * @param direction 焦点变化方向 + * @param previouslyFocusedRect 之前聚焦的矩形区域 + */ @Override protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) { + // 如果设置了 OnTextViewChangeListener 接口实例 if (mOnTextViewChangeListener != null) { + // 当失去焦点且文本为空时，调用文本变化回调方法，传递 false if (!focused && TextUtils.isEmpty(getText())) { mOnTextViewChangeListener.onTextChange(mIndex, false); } else { + // 否则，调用文本变化回调方法，传递 true mOnTextViewChangeListener.onTextChange(mIndex, true); } } super.onFocusChanged(focused, direction, previouslyFocusedRect); } + /** + * 创建上下文菜单，当选择的文本包含 URL 时，添加相应的菜单项。 + * @param menu 上下文菜单对象 + */ @Override protected void onCreateContextMenu(ContextMenu menu) { + // 检查文本是否为 Spanned 类型 if (getText() instanceof Spanned) { + // 获取选择的起始和结束位置 int selStart = getSelectionStart(); int selEnd = getSelectionEnd(); + // 确定选择的最小和最大位置 int min = Math.min(selStart, selEnd); int max = Math.max(selStart, selEnd); + // 获取选择范围内的 URLSpan 数组 final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class); + // 如果只选择了一个 URL if (urls.length == 1) { int defaultResId = 0; + // 遍历支持的协议 for(String schema: sSchemaActionResMap.keySet()) { + // 检查 URL 是否包含当前协议 if(urls[0].getURL().indexOf(schema) >= 0) { + // 获取对应的菜单项资源 ID defaultResId = sSchemaActionResMap.get(schema); break; } } + // 如果未找到匹配的协议，使用默认的菜单项资源 ID if (defaultResId == 0) { defaultResId = R.string.note_link_other; } + // 添加菜单项，并设置点击监听器 menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener( new OnMenuItemClickListener() { public boolean onMenuItemClick(MenuItem item) { - // goto a new intent + // 调用 URLSpan 的点击方法，打开链接 urls[0].onClick(NoteEditText.this); return true; } @@ -214,4 +311,4 @@ public class NoteEditText extends EditText { } super.onCreateContextMenu(menu); } -} +} \ No newline at end of file diff --git a/Notes-master/src/net/micode/notes/ui/NoteItemData.java b/Notes-master/src/net/micode/notes/ui/NoteItemData.java index 0f5a878..dfcf14b 100644 --- a/Notes-master/src/net/micode/notes/ui/NoteItemData.java +++ b/Notes-master/src/net/micode/notes/ui/NoteItemData.java @@ -25,23 +25,28 @@ import net.micode.notes.data.Notes; import net.micode.notes.data.Notes.NoteColumns; import net.micode.notes.tool.DataUtils; - +/** + * NoteItemData 类用于封装从数据库中查询到的笔记项数据。 + * 它提供了从 Cursor 中提取数据的方法，并提供了访问这些数据的 getter 方法。 + */ public class NoteItemData { + // 定义从数据库查询笔记项数据时使用的投影列 static final String [] PROJECTION = new String [] { - NoteColumns.ID, - NoteColumns.ALERTED_DATE, - NoteColumns.BG_COLOR_ID, - NoteColumns.CREATED_DATE, - NoteColumns.HAS_ATTACHMENT, - NoteColumns.MODIFIED_DATE, - NoteColumns.NOTES_COUNT, - NoteColumns.PARENT_ID, - NoteColumns.SNIPPET, - NoteColumns.TYPE, - NoteColumns.WIDGET_ID, - NoteColumns.WIDGET_TYPE, + 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, // 笔记类型 + NoteColumns.WIDGET_ID, // 小部件 ID + NoteColumns.WIDGET_TYPE, // 小部件类型 }; + // 定义投影列在 Cursor 中的索引 private static final int ID_COLUMN = 0; private static final int ALERTED_DATE_COLUMN = 1; private static final int BG_COLOR_ID_COLUMN = 2; @@ -55,28 +60,37 @@ public class NoteItemData { private static final int WIDGET_ID_COLUMN = 10; private static final int WIDGET_TYPE_COLUMN = 11; - private long mId; - private long mAlertDate; - private int mBgColorId; - private long mCreatedDate; - private boolean mHasAttachment; - private long mModifiedDate; - private int mNotesCount; - private long mParentId; - 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; - + // 笔记项的各种属性 + private long mId; // 笔记的 ID + private long mAlertDate; // 提醒日期 + private int mBgColorId; // 背景颜色 ID + 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; // 小部件 ID + private int mWidgetType; // 小部件类型 + private String mName; // 联系人姓名 + private String mPhoneNumber; // 联系人电话号码 + + // 笔记项在列表中的位置状态 + private boolean mIsLastItem; // 是否是列表中的最后一项 + private boolean mIsFirstItem; // 是否是列表中的第一项 + private boolean mIsOnlyOneItem; // 是否是列表中唯一的一项 + private boolean mIsOneNoteFollowingFolder; // 是否是文件夹后面的唯一一条笔记 + private boolean mIsMultiNotesFollowingFolder; // 是否是文件夹后面有多条笔记 + + /** + * 构造函数，从 Cursor 中提取笔记项数据。 + * + * @param context 上下文对象 + * @param cursor 包含笔记项数据的 Cursor + */ public NoteItemData(Context context, Cursor cursor) { + // 从 Cursor 中提取数据并赋值给相应的成员变量 mId = cursor.getLong(ID_COLUMN); mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN); mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN); @@ -86,6 +100,7 @@ public class NoteItemData { 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); @@ -93,11 +108,15 @@ public class NoteItemData { mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN); mPhoneNumber = ""; + // 如果父文件夹 ID 是通话记录文件夹的 ID if (mParentId == Notes.ID_CALL_RECORD_FOLDER) { + // 获取通话记录的电话号码 mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId); if (!TextUtils.isEmpty(mPhoneNumber)) { + // 根据电话号码获取联系人姓名 mName = Contact.getContact(context, mPhoneNumber); if (mName == null) { + // 如果没有联系人姓名，则使用电话号码作为姓名 mName = mPhoneNumber; } } @@ -106,24 +125,37 @@ public class NoteItemData { if (mName == null) { mName = ""; } + // 检查笔记项在列表中的位置状态 checkPostion(cursor); } + /** + * 检查笔记项在列表中的位置状态。 + * + * @param cursor 包含笔记项数据的 Cursor + */ private void checkPostion(Cursor cursor) { + // 判断是否是列表中的最后一项 mIsLastItem = cursor.isLast() ? true : false; + // 判断是否是列表中的第一项 mIsFirstItem = cursor.isFirst() ? true : false; + // 判断是否是列表中唯一的一项 mIsOnlyOneItem = (cursor.getCount() == 1); mIsMultiNotesFollowingFolder = false; mIsOneNoteFollowingFolder = false; + // 如果是笔记类型且不是第一项 if (mType == Notes.TYPE_NOTE && !mIsFirstItem) { int position = cursor.getPosition(); if (cursor.moveToPrevious()) { + // 如果前一项是文件夹或系统类型 if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER || cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) { if (cursor.getCount() > (position + 1)) { + // 如果后面还有多项笔记，则标记为文件夹后面有多条笔记 mIsMultiNotesFollowingFolder = true; } else { + // 如果后面只有一项笔记，则标记为文件夹后面的唯一一条笔记 mIsOneNoteFollowingFolder = true; } } @@ -134,91 +166,202 @@ public class NoteItemData { } } + /** + * 判断是否是文件夹后面的唯一一条笔记。 + * + * @return 如果是则返回 true，否则返回 false + */ public boolean isOneFollowingFolder() { return mIsOneNoteFollowingFolder; } + /** + * 判断是否是文件夹后面有多条笔记。 + * + * @return 如果是则返回 true，否则返回 false + */ public boolean isMultiFollowingFolder() { return mIsMultiNotesFollowingFolder; } + /** + * 判断是否是列表中的最后一项。 + * + * @return 如果是则返回 true，否则返回 false + */ public boolean isLast() { return mIsLastItem; } + /** + * 获取通话记录的联系人姓名。 + * + * @return 联系人姓名 + */ public String getCallName() { return mName; } + /** + * 判断是否是列表中的第一项。 + * + * @return 如果是则返回 true，否则返回 false + */ public boolean isFirst() { return mIsFirstItem; } + /** + * 判断是否是列表中唯一的一项。 + * + * @return 如果是则返回 true，否则返回 false + */ public boolean isSingle() { return mIsOnlyOneItem; } + /** + * 获取笔记的 ID。 + * + * @return 笔记的 ID + */ public long getId() { return mId; } + /** + * 获取笔记的提醒日期。 + * + * @return 提醒日期 + */ public long getAlertDate() { return mAlertDate; } + /** + * 获取笔记的创建日期。 + * + * @return 创建日期 + */ public long getCreatedDate() { return mCreatedDate; } + /** + * 判断笔记是否有附件。 + * + * @return 如果有附件则返回 true，否则返回 false + */ public boolean hasAttachment() { return mHasAttachment; } + /** + * 获取笔记的修改日期。 + * + * @return 修改日期 + */ public long getModifiedDate() { return mModifiedDate; } + /** + * 获取笔记的背景颜色 ID。 + * + * @return 背景颜色 ID + */ public int getBgColorId() { return mBgColorId; } + /** + * 获取笔记的父文件夹 ID。 + * + * @return 父文件夹 ID + */ public long getParentId() { return mParentId; } + /** + * 获取笔记的数量。 + * + * @return 笔记数量 + */ public int getNotesCount() { return mNotesCount; } + /** + * 获取笔记所在的文件夹 ID。 + * + * @return 文件夹 ID + */ public long getFolderId () { return mParentId; } + /** + * 获取笔记的类型。 + * + * @return 笔记类型 + */ public int getType() { return mType; } + /** + * 获取笔记关联的小部件类型。 + * + * @return 小部件类型 + */ public int getWidgetType() { return mWidgetType; } + /** + * 获取笔记关联的小部件 ID。 + * + * @return 小部件 ID + */ public int getWidgetId() { return mWidgetId; } + /** + * 获取笔记的摘要。 + * + * @return 笔记摘要 + */ public String getSnippet() { return mSnippet; } + /** + * 判断笔记是否有提醒。 + * + * @return 如果有提醒则返回 true，否则返回 false + */ public boolean hasAlert() { return (mAlertDate > 0); } + /** + * 判断笔记是否是通话记录。 + * + * @return 如果是通话记录则返回 true，否则返回 false + */ public boolean isCallRecord() { return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber)); } + /** + * 从 Cursor 中获取笔记的类型。 + * + * @param cursor 包含笔记项数据的 Cursor + * @return 笔记类型 + */ public static int getNoteType(Cursor cursor) { return cursor.getInt(TYPE_COLUMN); } -} +} \ No newline at end of file diff --git a/Notes-master/src/net/micode/notes/ui/NotesListActivity.java b/Notes-master/src/net/micode/notes/ui/NotesListActivity.java index cc03dd0..e843aec 100644 --- a/Notes-master/src/net/micode/notes/ui/NotesListActivity.java +++ b/Notes-master/src/net/micode/notes/ui/NotesListActivity.java @@ -79,7 +79,6 @@ import java.io.InputStreamReader; import java.util.HashSet; public class NotesListActivity extends Activity implements OnClickListener, OnItemLongClickListener { - private int mode=-1; private static final int FOLDER_NOTE_LIST_QUERY_TOKEN = 0; private static final int FOLDER_LIST_QUERY_TOKEN = 1; @@ -140,10 +139,6 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.note_list); - - getWindow().setBackgroundDrawableResource(R.drawable.bg1); - getWindow().setBackgroundDrawableResource(R.drawable.bg2); - initResources(); /** @@ -780,27 +775,12 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } else { Log.e(TAG, "Wrong state:" + mState); } - if (mode==-1){ - menu.findItem(R.id.menu_bg1).setVisible(false); - }else if (mode==0){ - menu.findItem(R.id.menu_bg2).setVisible(false); - } return true; } @Override public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { - case R.id.menu_bg1:{ - mode=-1; - getWindow().setBackgroundDrawableResource(R.drawable.bg1); - break; - } - case R.id.menu_bg2:{ - mode=0; - getWindow().setBackgroundDrawableResource(R.drawable.bg2); - break; - } case R.id.menu_new_folder: { showCreateOrModifyFolderDialog(true); break; diff --git a/Notes-master/src/net/micode/notes/ui/NotesListAdapter.java b/Notes-master/src/net/micode/notes/ui/NotesListAdapter.java index 51c9cb9..c04f221 100644 --- a/Notes-master/src/net/micode/notes/ui/NotesListAdapter.java +++ b/Notes-master/src/net/micode/notes/ui/NotesListAdapter.java @@ -30,19 +30,35 @@ import java.util.HashMap; import java.util.HashSet; import java.util.Iterator; - +/** + * 用于在列表中显示便签的适配器。 + * 继承自 CursorAdapter，负责管理便签数据的显示和选择状态。 + */ public class NotesListAdapter extends CursorAdapter { private static final String TAG = "NotesListAdapter"; + // 上下文对象，用于获取资源和执行操作 private Context mContext; + // 存储每个便签位置的选择状态 private HashMap mSelectedIndex; + // 便签的总数 private int mNotesCount; + // 是否处于选择模式 private boolean mChoiceMode; + /** + * 表示便签小部件的属性。 + */ public static class AppWidgetAttribute { + // 小部件的 ID public int widgetId; + // 小部件的类型 public int widgetType; }; + /** + * 构造函数，初始化适配器。 + * @param context 上下文对象 + */ public NotesListAdapter(Context context) { super(context, null); mSelectedIndex = new HashMap(); @@ -50,38 +66,73 @@ public class NotesListAdapter extends CursorAdapter { mNotesCount = 0; } + /** + * 创建新的便签列表项视图。 + * @param context 上下文对象 + * @param cursor 包含便签数据的游标 + * @param parent 父视图组 + * @return 新的便签列表项视图 + */ @Override public View newView(Context context, Cursor cursor, ViewGroup parent) { return new NotesListItem(context); } + /** + * 将便签数据绑定到视图上。 + * @param view 便签列表项视图 + * @param context 上下文对象 + * @param cursor 包含便签数据的游标 + */ @Override public void bindView(View view, Context context, Cursor cursor) { if (view instanceof NotesListItem) { + // 创建便签项数据对象 NoteItemData itemData = new NoteItemData(context, cursor); + // 绑定数据到视图 ((NotesListItem) view).bind(context, itemData, mChoiceMode, isSelectedItem(cursor.getPosition())); } } + /** + * 设置指定位置的便签选择状态。 + * @param position 便签的位置 + * @param checked 是否选择 + */ public void setCheckedItem(final int position, final boolean checked) { mSelectedIndex.put(position, checked); + // 通知适配器数据已更改，刷新视图 notifyDataSetChanged(); } + /** + * 判断是否处于选择模式。 + * @return 如果处于选择模式返回 true，否则返回 false + */ public boolean isInChoiceMode() { return mChoiceMode; } + /** + * 设置选择模式。 + * @param mode 是否开启选择模式 + */ public void setChoiceMode(boolean mode) { + // 清除所有选择状态 mSelectedIndex.clear(); mChoiceMode = mode; } + /** + * 全选或全不选便签。 + * @param checked 是否全选 + */ public void selectAll(boolean checked) { Cursor cursor = getCursor(); for (int i = 0; i < getCount(); i++) { if (cursor.moveToPosition(i)) { + // 只处理便签类型的项 if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) { setCheckedItem(i, checked); } @@ -89,6 +140,10 @@ public class NotesListAdapter extends CursorAdapter { } } + /** + * 获取所有选中便签的 ID。 + * @return 包含选中便签 ID 的集合 + */ public HashSet getSelectedItemIds() { HashSet itemSet = new HashSet(); for (Integer position : mSelectedIndex.keySet()) { @@ -105,6 +160,10 @@ public class NotesListAdapter extends CursorAdapter { return itemSet; } + /** + * 获取所有选中便签的小部件属性。 + * @return 包含选中便签小部件属性的集合 + */ public HashSet getSelectedWidget() { HashSet itemSet = new HashSet(); for (Integer position : mSelectedIndex.keySet()) { @@ -128,6 +187,10 @@ public class NotesListAdapter extends CursorAdapter { return itemSet; } + /** + * 获取选中便签的数量。 + * @return 选中便签的数量 + */ public int getSelectedCount() { Collection values = mSelectedIndex.values(); if (null == values) { @@ -143,11 +206,20 @@ public class NotesListAdapter extends CursorAdapter { return count; } + /** + * 判断是否所有便签都被选中。 + * @return 如果所有便签都被选中返回 true，否则返回 false + */ public boolean isAllSelected() { int checkedCount = getSelectedCount(); return (checkedCount != 0 && checkedCount == mNotesCount); } + /** + * 判断指定位置的便签是否被选中。 + * @param position 便签的位置 + * @return 如果被选中返回 true，否则返回 false + */ public boolean isSelectedItem(final int position) { if (null == mSelectedIndex.get(position)) { return false; @@ -155,23 +227,36 @@ public class NotesListAdapter extends CursorAdapter { return mSelectedIndex.get(position); } + /** + * 当内容发生变化时调用。 + * 重新计算便签的总数。 + */ @Override protected void onContentChanged() { super.onContentChanged(); calcNotesCount(); } + /** + * 更改游标时调用。 + * 重新计算便签的总数。 + * @param cursor 新的游标 + */ @Override public void changeCursor(Cursor cursor) { super.changeCursor(cursor); calcNotesCount(); } + /** + * 计算便签的总数。 + */ private void calcNotesCount() { mNotesCount = 0; for (int i = 0; i < getCount(); i++) { Cursor c = (Cursor) getItem(i); if (c != null) { + // 只统计便签类型的项 if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) { mNotesCount++; } @@ -181,4 +266,4 @@ public class NotesListAdapter extends CursorAdapter { } } } -} +} \ No newline at end of file diff --git a/Notes-master/src/net/micode/notes/ui/NotesPreferenceActivity.java b/Notes-master/src/net/micode/notes/ui/NotesPreferenceActivity.java index 07c5f7e..dccd9f0 100644 --- a/Notes-master/src/net/micode/notes/ui/NotesPreferenceActivity.java +++ b/Notes-master/src/net/micode/notes/ui/NotesPreferenceActivity.java @@ -47,44 +47,57 @@ import net.micode.notes.data.Notes; import net.micode.notes.data.Notes.NoteColumns; import net.micode.notes.gtask.remote.GTaskSyncService; - +/** + * NotesPreferenceActivity 类用于管理便签应用的设置界面。 + * 它允许用户选择同步账户、启动或取消同步，并显示上次同步时间。 + */ 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; - + // 用于接收 GTask 同步服务广播的接收器 private GTaskReceiver mReceiver; - + // 原始的 Google 账户数组 private Account[] mOriAccounts; - + // 标记是否添加了新账户 private boolean mHasAddedAccount; @Override protected void onCreate(Bundle icicle) { super.onCreate(icicle); - /* using the app icon for navigation */ + // 设置 ActionBar 可返回 getActionBar().setDisplayHomeAsUpEnabled(true); + // 加载偏好设置资源 addPreferencesFromResource(R.xml.preferences); + // 找到同步账户的偏好设置类别 mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY); + // 创建 GTask 广播接收器 mReceiver = new GTaskReceiver(); + // 创建意图过滤器，用于接收 GTask 同步服务的广播 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); + // 将头部视图添加到列表视图中 getListView().addHeaderView(header, null, true); } @@ -92,8 +105,7 @@ public class NotesPreferenceActivity extends PreferenceActivity { protected void onResume() { super.onResume(); - // need to set sync account automatically if user has added a new - // account + // 如果添加了新账户，自动设置同步账户 if (mHasAddedAccount) { Account[] accounts = getGoogleAccounts(); if (mOriAccounts != null && accounts.length > mOriAccounts.length) { @@ -113,36 +125,48 @@ public class NotesPreferenceActivity extends PreferenceActivity { } } + // 刷新界面 refreshUI(); } @Override protected void onDestroy() { + // 注销广播接收器 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.makeText(NotesPreferenceActivity.this, R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT) .show(); @@ -151,18 +175,24 @@ public class NotesPreferenceActivity extends PreferenceActivity { } }); + // 将账户偏好设置项添加到账户偏好设置类别中 mAccountCategory.addPreference(accountPref); } + /** + * 加载同步按钮和上次同步时间的显示 + */ private void loadSyncButton() { + // 找到同步按钮和上次同步时间的文本视图 Button syncButton = (Button) findViewById(R.id.preference_sync_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); } }); @@ -170,13 +200,15 @@ public class NotesPreferenceActivity extends PreferenceActivity { 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); @@ -193,30 +225,44 @@ public class NotesPreferenceActivity extends PreferenceActivity { } } + /** + * 刷新界面，重新加载账户偏好设置和同步按钮 + */ private void refreshUI() { loadAccountPreference(); loadSyncButton(); } + /** + * 显示选择账户的对话框 + */ private void showSelectAccountAlertDialog() { + // 创建一个 AlertDialog 构建器 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); + // 获取所有的 Google 账户 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; @@ -227,134 +273,201 @@ public class NotesPreferenceActivity extends PreferenceActivity { } 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; + // 创建一个添加账户的意图 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 构建器 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(); } + /** + * 获取所有的 Google 账户 + * @return 包含所有 Google 账户的数组 + */ private Account[] getGoogleAccounts() { + // 获取账户管理器 AccountManager accountManager = AccountManager.get(this); + // 获取所有的 Google 账户 return accountManager.getAccountsByType("com.google"); } + /** + * 设置同步账户 + * @param account 要设置的账户名称 + */ 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 + // 清空本地的 GTask 相关信息 new Thread(new Runnable() { public void run() { ContentValues values = new ContentValues(); values.put(NoteColumns.GTASK_ID, ""); values.put(NoteColumns.SYNC_ID, 0); + // 更新所有便签的 GTask 相关信息 getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null); } }).start(); + // 显示设置成功的提示信息 Toast.makeText(NotesPreferenceActivity.this, getString(R.string.preferences_toast_success_set_accout, account), Toast.LENGTH_SHORT).show(); } } + /** + * 移除同步账户 + */ 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 + // 清空本地的 GTask 相关信息 new Thread(new Runnable() { public void run() { ContentValues values = new ContentValues(); values.put(NoteColumns.GTASK_ID, ""); values.put(NoteColumns.SYNC_ID, 0); + // 更新所有便签的 GTask 相关信息 getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null); } }).start(); } + /** + * 获取当前的同步账户名称 + * @param context 上下文对象 + * @return 当前的同步账户名称，如果没有设置则返回空字符串 + */ public static String getSyncAccountName(Context context) { + // 获取共享偏好设置 SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE); + // 获取同步账户名称 return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, ""); } + /** + * 设置上次同步时间 + * @param context 上下文对象 + * @param time 上次同步的时间 + */ 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(); } + /** + * 获取上次同步时间 + * @param context 上下文对象 + * @return 上次同步的时间，如果没有同步过则返回 0 + */ public static long getLastSyncTime(Context context) { + // 获取共享偏好设置 SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE); return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0);