pvg45a2sy
/
git-xiaomibianqian
1
0
Fork 0
Code Issues Pull Requests 2 Projects Releases Wiki Activity

src

Browse Source
pull/3/head
2310175682@qq.com 2 years ago
parent dec32a6956
commit 00ec1c070b
11 changed files with 2099 additions and 0 deletions
Show Stats Download Patch File Download Diff File

159
xkw2/AlarmAlertActivity.java
Unescape View File

@ -0,0 +1,159 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.ui;
import android.app.Activity;
import android.app.AlertDialog;
import android.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.os.Bundle;
import android.os.PowerManager;
import android.provider.Settings;
import android.view.Window;
import android.view.WindowManager;
import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.DataUtils;
import java.io.IOException;
public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
private long mNoteId;//mNoteId可能是笔记的唯一标识符
private String mSnippet;//mSnippet可能是笔记的摘要或预览
private static final int SNIPPET_PREW_MAX_LEN = 60;//SNIPPET_PREW_MAX_LEN可能是规定的摘要或预览的最大长度，初值为60
MediaPlayer mPlayer;//定义了一个名为mPlayer的MediaPlayer对象
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);//调用父类的onCreate
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);
}//检查屏幕是否已经关闭，如果是，则设置一些标志来保持屏幕开启、打开屏幕并允许在屏幕开启时锁定屏幕，并将布局设置为插入装饰
Intent intent = getIntent();
try {
mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);//获取传入的意图并从中获取笔记ID，然后使用该ID从内容提供程序中获取笔记的摘录
mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
: mSnippet;//如果摘录超过了预定义的最大长度，则将其截断并附加一些字符串，该代码将截断后的摘录分配给变量mSnippet
} catch (IllegalArgumentException e) {
e.printStackTrace();
return;
}//从Intent中获取传递的数据，如果数据无效则抛出IllegalArgumentException异常并打印堆栈跟踪信息并返回
mPlayer = new MediaPlayer();//创建一个MediaPlayer对象
if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
showActionDialog();
playAlarmSound();
}//检查当前笔记是否可见于笔记数据库，如果是，则显示操作对话框并播放警报声音
else {
finish();
}//如果不是，结束当前活动
}
private boolean isScreenOn() {
PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);//获取 PowerManager 对象，然后调用其 isScreenOn()
return pm.isScreenOn();//调用其 isScreenOn() 方法，返回当前屏幕是否开启的值
}//判断屏幕是否开启
private void playAlarmSound() {// 获取系统当前默认的闹钟铃声的Uri
Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);// 获取当前静音模式下受影响的流
int silentModeStreams = Settings.System.getInt(getContentResolver(),
Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);// 如果闹钟铃声所在的流也受到了静音模式的影响，则使用受影响的流
if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
mPlayer.setAudioStreamType(silentModeStreams);
} else { // 否则使用闹钟铃声所在的流
mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
}
try { // 设置闹钟铃声的Uri并准备播放
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 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);
} // 显示对话框，并设置对话框消失监听器
dialog.show().setOnDismissListener(this);
}
public void onClick(DialogInterface dialog, int which) {
switch (which) { // 当点击对话框的按钮时触发该方法
case DialogInterface.BUTTON_NEGATIVE:// 如果点击的是对话框的取消按钮
Intent intent = new Intent(this, NoteEditActivity.class);// 创建一个新的意图，指定跳转到NoteEditActivity类
intent.setAction(Intent.ACTION_VIEW); // 设置意图的操作为ACTION_VIEW
intent.putExtra(Intent.EXTRA_UID, mNoteId);// 将笔记的ID作为额外的信息传递给NoteEditActivity类
startActivity(intent);// 启动NoteEditActivity类
break;
default: // 如果点击的不是对话框的取消按钮，则结束
break;
}
}
public void onDismiss(DialogInterface dialog) {// 当对话框消失时执行以下代码
stopAlarmSound();// 停止闹钟声音
finish(); // 结束当前Activity
}
private void stopAlarmSound() {
if (mPlayer != null) {// 如果音频播放器不为空
mPlayer.stop();// 停止播放音频
mPlayer.release();// 释放音频播放器的资源
mPlayer = null;// 将音频播放器置为空
}
}
}

67
xkw2/AlarmInitReceiver.java
Unescape View File

@ -0,0 +1,67 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.ui;
import android.app.AlarmManager;
import android.app.PendingIntent;
import android.content.BroadcastReceiver;
import android.content.ContentUris;
import android.content.Context;
import android.content.Intent;
import android.database.Cursor;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
public class AlarmInitReceiver extends BroadcastReceiver {// AlarmInitReceiver类继承自BroadcastReceiver类
private static final String [] PROJECTION = new String [] {// 定义一个字符串数组PROJECTION
NoteColumns.ID,// 第一个元素为NoteColumns.ID
NoteColumns.ALERTED_DATE// 第二个元素为NoteColumns.ALERTED_DATE
};
private static final int COLUMN_ID = 0; // 定义一个整型变量COLUMN_ID，值为0
private static final int COLUMN_ALERTED_DATE = 1;// 定义一个整型变量COLUMN_ALERTED_DATE，值为1
@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); // 获取提醒时间
Intent sender = new Intent(context, AlarmReceiver.class);// 创建一个新的意图
sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));// 设置意图的数据
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);// 创建一个用于启动广播的PendingIntent
AlarmManager alermManager = (AlarmManager) context// 获取AlarmManager服务
.getSystemService(Context.ALARM_SERVICE);// 设置定时器
alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);// 移动游标到下一行
} while (c.moveToNext());// 关闭游标
}
c.close();
}
}
}

30
xkw2/AlarmReceiver.java
Unescape View File

@ -0,0 +1,30 @@
/*
* 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.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
public class AlarmReceiver extends BroadcastReceiver {// 定义一个名为AlarmReceiver的广播接收器类，继承自BroadcastReceiver类
@Override
public void onReceive(Context context, Intent intent) {//重写BroadcastReceiver类的onReceive方法，该方法在接收到广播时会被调用
intent.setClass(context, AlarmAlertActivity.class);// 设置Intent的目标Activity为AlarmAlertActivity
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);// 给Intent添加FLAG_ACTIVITY_NEW_TASK标志，表示启动一个新的任务栈
context.startActivity(intent);// 启动Intent所指定的Activity
}
}

502
xkw2/DateTimePicker.java
Unescape View File

@ -0,0 +1,502 @@
/*
* 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 java.text.DateFormatSymbols;
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;
public class DateTimePicker extends FrameLayout {// 定义一个名为DateTimePicker的类，继承自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;
private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0;
private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23;
private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1;
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;
private static final int AMPM_SPINNER_MIN_VAL = 0;
private static final int AMPM_SPINNER_MAX_VAL = 1;
// 定义控件
private final NumberPicker mDateSpinner;
private final NumberPicker mHourSpinner;
private final NumberPicker mMinuteSpinner;
private final NumberPicker mAmPmSpinner;
private Calendar mDate; // 定义日历对象
private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK]; // 定义字符串数组
private boolean mIsAm; // 定义布尔型变量
private boolean mIs24HourView; // 是否为24小时制
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 cal = Calendar.getInstance();// 获取当前时间的日历对象
if (!mIs24HourView) { // 如果不是24小时制
// 如果从上午11点变成下午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);// 将日期加1天
isDateChanged = true; // 标记日期已改变
} // 如果从下午12点变成上午11点
else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
cal.setTimeInMillis(mDate.getTimeInMillis());// 设置时间为当前时间
cal.add(Calendar.DAY_OF_YEAR, -1);// 将日期减1天
isDateChanged = true;// 标记日期已改变
}// 如果从11点到12点或从12点到11点
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;// 切换上下午标记
updateAmPmControl();// 更新上下午控件
}
} // 如果是24小时制
else {// 如果从23点到0点
if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {
cal.setTimeInMillis(mDate.getTimeInMillis()); // 设置时间为当前时间
cal.add(Calendar.DAY_OF_YEAR, 1);// 将日期加1天
isDateChanged = true;// 标记日期已改变
}// 如果从0点到23点
else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) {
cal.setTimeInMillis(mDate.getTimeInMillis());// 设置时间为当前时间
cal.add(Calendar.DAY_OF_YEAR, -1);// 将日期减1天
isDateChanged = true;// 标记日期已改变
}
}
int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY);
// 获取小时数，对半天的小时数取模，如果是下午，加上半天的小时数
// 这一行代码的作用是将 12 小时制转换为 24 小时制
// mHourSpinner 是一个 Spinner 控件，用于选择小时数
// HOURS_IN_HALF_DAY 是常量，表示半天的小时数
// mIsAm 是一个布尔值，表示当前是否是上午
mDate.set(Calendar.HOUR_OF_DAY, newHour);
// 将新的小时数设置到 Calendar 对象中
// Calendar 是一个日期时间类，用于处理日期时间相关的操作
onDateTimeChanged();// 调用 onDateTimeChanged() 方法，通知界面更新日期时间显示
if (isDateChanged) {
setCurrentYear(cal.get(Calendar.YEAR));
setCurrentMonth(cal.get(Calendar.MONTH));
setCurrentDay(cal.get(Calendar.DAY_OF_MONTH));
}// 如果日期有变化，更新当前年、月、日的显示
// cal 是一个 Calendar 对象，表示当前的日期时间
}
};
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;
} // 如果偏移量不为0，那么更新日期和小时选择器的值
if (offset != 0) {
mDate.add(Calendar.HOUR_OF_DAY, offset);
mHourSpinner.setValue(getCurrentHour());
updateDateControl();// 获取当前的小时数
int newHour = getCurrentHourOfDay(); // 如果小时数大于等于12，那么设置上午/下午为下午
if (newHour >= HOURS_IN_HALF_DAY) {
mIsAm = false;
updateAmPmControl();// 否则设置上午/下午为上午
} else {
mIsAm = true;
updateAmPmControl();
}
} // 设置日期的分钟数为新值
mDate.set(Calendar.MINUTE, newVal); // 调用日期时间改变的回调函数
onDateTimeChanged();
}
};
private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() {// 重写监听器的onValueChange方法
@Override
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
mIsAm = !mIsAm; // 反转mIsAm的布尔值
if (mIsAm) {// 如果mIsAm为true，则将mDate时间减去12小时
mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY);
} else {// 如果mIsAm为false，则将mDate时间加上12小时
mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY);
}// 更新上午/下午控件的状态
updateAmPmControl();
onDateTimeChanged();// 调用onDateTimeChanged方法
}
};
public interface OnDateTimeChangedListener {// 定义一个OnDateTimeChangedListener接口
void onDateTimeChanged(DateTimePicker view, int year, int month,
int dayOfMonth, int hourOfDay, int minute);
}// 定义onDateTimeChanged方法，传入日期时间选择器的年、月、日、时、分等参数
public DateTimePicker(Context context)// 定义一个公共的构造函数，传入上下文参数
{
this(context, System.currentTimeMillis());// 调用另一个构造函数，传入上下文和当前时间的毫秒数
}// 调用父类的构造函数，传入上下文、时间毫秒数和是否为24小时制参数。这里用到了Java中的this关键字，表示当前对象。
public DateTimePicker(Context context, long date) {// 定义一个公共的构造函数，传入上下文和时间毫秒数参数
this(context, date, DateFormat.is24HourFormat(context));// 调用另一个构造函数，传入上下文、时间毫秒数和是否为24小时制参数
}
public DateTimePicker(Context context, long date, boolean is24HourView) {// 定义一个公共的日期选择器类，继承自View类
super(context);// 调用父类的构造函数
mDate = Calendar.getInstance(); // 获取当前时间
mInitialising = true; // 设置初始化状态为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);// 设置长按分钟选择器按钮的更新间隔为100毫秒
mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener);// 设置分钟选择器的值改变监听器
String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings();
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();// 更新小时选择器的控件状态
updateAmPmControl();// 更新上午/下午选择器的控件状态
set24HourView(is24HourView);//设置是否为24小时制
// set to current time
setCurrentDate(date);// 设置当前时间
setEnabled(isEnabled());// 设置是否可用
// set the content descriptions
mInitialising = false;// 设置内容描述
}
@Override
public void setEnabled(boolean enabled) {
if (mIsEnabled == enabled) {// 设置控件是否可用的方法
return; // 如果当前可用状态与要设置的状态一致，则直接返回，不进行任何操作
}
super.setEnabled(enabled);// 调用父类的setEnabled方法，设置控件是否可用
mDateSpinner.setEnabled(enabled);// 设置日期选择器是否可用
mMinuteSpinner.setEnabled(enabled);// 设置分钟选择器是否可用
mHourSpinner.setEnabled(enabled);// 设置小时选择器是否可用
mAmPmSpinner.setEnabled(enabled);// 设置上午/下午选择器是否可用
mIsEnabled = enabled;// 更新当前可用状态
}
@Override
public boolean isEnabled() {
return mIsEnabled;
}// 判断是否启用
/**
* Get the current date in millis
*
* @return the current date in millis
*/
public long getCurrentDateInTimeMillis() {
return mDate.getTimeInMillis();
}// 获取当前时间的毫秒数
/**
* Set the current date
*
* @param date The current date in millis
*/
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
*/
public void setCurrentDate(int year, int month,
int dayOfMonth, int hourOfDay, int minute) {// 设置当前日期
setCurrentYear(year);// 设置年份
setCurrentMonth(month); // 设置月份
setCurrentDay(dayOfMonth);// 设置日期
setCurrentHour(hourOfDay);// 设置小时
setCurrentMinute(minute);// 设置分钟
}
/**
* Get current year
*
* @return The current year
*/
public int getCurrentYear() {
return mDate.get(Calendar.YEAR);
}// 获取当前年份
/**
* Set current year
*
* @param year The current year
*/
public void setCurrentYear(int year) {
if (!mInitialising && year == getCurrentYear()) {
return;
} // 如果不是初始化，并且年份与当前年份相同，则不进行任何操作
mDate.set(Calendar.YEAR, year);// 设置当前年份
updateDateControl();// 更新日期控件
onDateTimeChanged();// 触发日期时间改变事件
}
/**
* Get current month in the year
*
* @return The current month in the year
*/
public int getCurrentMonth() {
return mDate.get(Calendar.MONTH);
} // 获取当前月份
/**
* Set current month in the year
*
* @param month The month in the year
*/
public void setCurrentMonth(int month) {
if (!mInitialising && month == getCurrentMonth()) {
return;
}// 如果不是初始化，并且月份与当前月份相同，则不进行任何操作
mDate.set(Calendar.MONTH, month); // 设置当前月份
updateDateControl();// 更新日期控件
onDateTimeChanged(); // 触发日期时间改变事件
}
/**
* Get current day of the month
*
* @return The day of the month
*/
public int getCurrentDay() {
return mDate.get(Calendar.DAY_OF_MONTH);
}// 获取当前日期
/**
* Set current day of the month
*
* @param dayOfMonth The day of the month
*/
public void setCurrentDay(int dayOfMonth) {
if (!mInitialising && dayOfMonth == getCurrentDay()) {
return;
} // 如果不是初始化，并且日期与当前日期相同，则不进行任何操作
mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);// 设置当前日期
updateDateControl();// 更新日期控件
onDateTimeChanged(); // 触发日期时间改变事件
}
/**
* Get current hour in 24 hour mode, in the range (0~23)
* @return The current hour in 24 hour mode
*/
public int getCurrentHourOfDay() {
return mDate.get(Calendar.HOUR_OF_DAY);
}// 获取当前小时数（24小时制）
private int getCurrentHour() {
if (mIs24HourView){ // 如果是24小时制
return getCurrentHourOfDay();// 直接返回当前小时数
} else {// 如果是12小时制
int hour = getCurrentHourOfDay();// 获取当前小时数
if (hour > HOURS_IN_HALF_DAY) {// 如果当前小时数大于12
return hour - HOURS_IN_HALF_DAY;// 返回减去12的小时数
} else {// 如果当前小时数小于等于12
return hour == 0 ? HOURS_IN_HALF_DAY : hour;// 如果当前小时数为0，则返回12，否则返回当前小时数
}
}
}
/**
* Set current hour in 24 hour mode, in the range (0~23)
*
* @param hourOfDay
*/
public void setCurrentHour(int hourOfDay) {
if (!mInitialising && hourOfDay == getCurrentHourOfDay()) {
return;// 如果不是初始化并且设置的小时数与当前小时数相同，则直接返回
}
mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);// 设置日期的小时数为设置的小时数
if (!mIs24HourView) {// 如果是12小时制
if (hourOfDay >= HOURS_IN_HALF_DAY) {// 如果设置的小时数大于等于12
mIsAm = false;// 设置为下午
if (hourOfDay > HOURS_IN_HALF_DAY) {// 如果设置的小时数大于12
hourOfDay -= HOURS_IN_HALF_DAY;// 小时数减去12
}
} else {// 如果设置的小时数小于12
mIsAm = true;// 设置为上午
if (hourOfDay == 0) {// 如果设置的小时数为0
hourOfDay = HOURS_IN_HALF_DAY;// 小时数设置为12
}
}
updateAmPmControl();// 更新上午/下午控件
}
mHourSpinner.setValue(hourOfDay);// 设置小时数的Spinner的值为设置的小时数
onDateTimeChanged();// 调用日期时间改变的回调方法
}
/**
* Get currentMinute
*
* @return The Current Minute
*/
public int getCurrentMinute() {
return mDate.get(Calendar.MINUTE);
}// 获取当前时间的分钟数
/**
* Set current minute
*/
public void setCurrentMinute(int minute) {// 设置当前时间的分钟数
if (!mInitialising && minute == getCurrentMinute()) {
return;
}// 如果不是初始化过程并且传入的分钟数等于当前分钟数，则直接返回
mMinuteSpinner.setValue(minute);// 设置分钟数的滚轮控件的值
mDate.set(Calendar.MINUTE, minute); // 设置时间对象的分钟数
onDateTimeChanged();// 调用日期时间改变的回调方法
}
/**
* @return true if this is in 24 hour view else false.
*/
public boolean is24HourView () {
return mIs24HourView;
}
/**
* Set whether in 24 hour or AM/PM mode.
*
* @param is24HourView True for 24 hour mode. False for AM/PM mode.
*/
public void set24HourView(boolean is24HourView) {
if (mIs24HourView == is24HourView) {
return;
}// 判断是否为24小时制
mIs24HourView = is24HourView;// 设置是否为24小时制
mAmPmSpinner.setVisibility(is24HourView ? View.GONE : View.VISIBLE); // 如果传入的值和当前值相等，则直接返回
int hour = getCurrentHourOfDay();// 获取当前小时数
updateHourControl();// 更新小时数的控件
setCurrentHour(hour); // 设置当前小时数
updateAmPmControl();// 更新上下午的控件
}
private void updateDateControl() {// 更新日期控件
Calendar cal = Calendar.getInstance();// 获取当前时间对象
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, -DAYS_IN_ALL_WEEK / 2 - 1);//将时间对象的日期减去一周的一半再减一天，作为起始日期
mDateSpinner.setDisplayedValues(null); // 清空日期滚轮控件的显示值
for (int i = 0; i < DAYS_IN_ALL_WEEK; ++i) {// 循环添加一周的日期到日期滚轮控件的显示值中
cal.add(Calendar.DAY_OF_YEAR, 1);
mDateDisplayValues[i] = (String) DateFormat.format("MM.dd EEEE", cal);
}
mDateSpinner.setDisplayedValues(mDateDisplayValues);// 设置日期滚轮控件的显示值和当前选中的值
mDateSpinner.setValue(DAYS_IN_ALL_WEEK / 2);
mDateSpinner.invalidate();
}
private void updateAmPmControl() {// 更新上午/下午控件的显示状态
if (mIs24HourView) {// 如果是24小时制
mAmPmSpinner.setVisibility(View.GONE);// 隐藏上午/下午控件
} else {// 如果是12小时制
int index = mIsAm ? Calendar.AM : Calendar.PM;// 获取当前时间是上午还是下午
mAmPmSpinner.setValue(index); // 设置上午/下午控件的值
mAmPmSpinner.setVisibility(View.VISIBLE);// 显示上午/下午控件
}
}
private void updateHourControl() {// 更新小时控件的显示范围
if (mIs24HourView) { // 如果是24小时制
mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW); // 设置小时控件的最小值为0
mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW);// 设置小时控件的最大值为23
} else {
mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW);// 设置小时控件的最小值为1
mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW);// 设置小时控件的最大值为12
}
}
/**
* Set the callback that indicates the 'Set' button has been pressed.
* @param callback the callback, if null will do nothing
*/
public void setOnDateTimeChangedListener(OnDateTimeChangedListener callback) {
mOnDateTimeChangedListener = callback;
}// 设置日期时间变化监听器
private void onDateTimeChanged() {// 当日期时间发生变化时调用此方法
if (mOnDateTimeChangedListener != null) {// 如果日期时间变化监听器不为空
mOnDateTimeChangedListener.onDateTimeChanged(this, getCurrentYear(),
getCurrentMonth(), getCurrentDay(), getCurrentHourOfDay(), getCurrentMinute());
}// 调用日期时间变化监听器的onDateTimeChanged方法，传递当前日期时间的各个参数
}
}

90
xkw2/DateTimePickerDialog.java
Unescape View File

@ -0,0 +1,90 @@
/*
* 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 java.util.Calendar;
import net.micode.notes.R;
import net.micode.notes.ui.DateTimePicker;
import net.micode.notes.ui.DateTimePicker.OnDateTimeChangedListener;
import android.app.AlertDialog;
import android.content.Context;
import android.content.DialogInterface;
import android.content.DialogInterface.OnClickListener;
import android.text.format.DateFormat;
import android.text.format.DateUtils;
public class DateTimePickerDialog extends AlertDialog implements OnClickListener {// 创建一个日期时间选择器对话框类，继承自AlertDialog类，并实现OnClickListener接口。
private Calendar mDate = Calendar.getInstance();// 创建一个日期时间选择器对话框类，继承自AlertDialog类，并实现OnClickListener接口。
private boolean mIs24HourView;// 创建一个日期时间选择器对话框类，继承自AlertDialog类，并实现OnClickListener接口。
private OnDateTimeSetListener mOnDateTimeSetListener;// 创建一个日期时间选择器对话框类，继承自AlertDialog类，并实现OnClickListener接口。
private DateTimePicker mDateTimePicker;// 创建一个日期时间选择器对话框类，继承自AlertDialog类，并实现OnClickListener接口。
public interface OnDateTimeSetListener {// 创建一个日期时间设置监听器接口OnDateTimeSetListener。
void OnDateTimeSet(AlertDialog dialog, long date);// 创建一个日期时间设置监听器接口OnDateTimeSetListener。
}
public DateTimePickerDialog(Context context, long date) {// 构造函数，接收一个上下文和一个日期的时间
super(context);// 构造函数，接收一个上下文和一个日期的时间
mDateTimePicker = new DateTimePicker(context);// 构造函数，接收一个上下文和一个日期的时间
setView(mDateTimePicker);// 构造函数，接收一个上下文和一个日期的时间
mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() {// 构造函数，接收一个上下文和一个日期的时间
public void onDateTimeChanged(DateTimePicker view, int year, int month,
int dayOfMonth, int hourOfDay, int minute) {// 当日期时间改变时，回调该方法
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()); // 更新对话框的标题
}
});
mDate.setTimeInMillis(date);// 设置时间为指定的时间
mDate.set(Calendar.SECOND, 0);// 将秒数设置为0，防止影响时间的精确度
mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());// 将时间设置到日期时间选择器中
setButton(context.getString(R.string.datetime_dialog_ok), this);// 设置确定和取消按钮的文本
setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);
set24HourView(DateFormat.is24HourFormat(this.getContext()));// 设置时间格式为24小时制或12小时制
updateTitle(mDate.getTimeInMillis());// 更新对话框标题，显示当前选择的时间
}
public void set24HourView(boolean is24HourView) {
mIs24HourView = is24HourView; //将传入的值赋值给mIs24HourView变量
} //设置是否是24小时制的方法，传入一个boolean值
public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {//设置日期时间设置监听器的方法，传入一个OnDateTimeSetListener对象
mOnDateTimeSetListener = callBack; //设置日期时间设置监听器的方法，传入一个OnDateTimeSetListener对象
}
private void updateTitle(long date) {//更新对话框标题的方法，传入一个日期时间的long型值
int flag =//更新对话框标题的方法，传入一个日期时间的long型值
DateUtils.FORMAT_SHOW_YEAR | //显示年份
DateUtils.FORMAT_SHOW_DATE | //显示日期
DateUtils.FORMAT_SHOW_TIME; //显示时间
flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;//根据mIs24HourView变量的值，判断是否显示24小时制，将标志位赋值给flag变量
setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));//根据传入的日期时间值和标志位，格式化日期时间并设置为对话框标题
}
public void onClick(DialogInterface arg0, int arg1) {
if (mOnDateTimeSetListener != null) {
mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());//当用户点击对话框上的“确认”按钮时，如果设置了日期时间设置监听器，则调用该监听器的OnDateTimeSet方法
}
}
}

62
xkw2/DropdownMenu.java
Unescape View File

@ -0,0 +1,62 @@
/*
* 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.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.PopupMenu;
import android.widget.PopupMenu.OnMenuItemClickListener;
import net.micode.notes.R;
public class DropdownMenu {
private Button mButton;// 按钮控件
private PopupMenu mPopupMenu;// 弹出菜单控件
private Menu mMenu; // 菜单控件
public DropdownMenu(Context context, Button button, int menuId) { // 构造函数，传入上下文、按钮控件和菜单 ID
mButton = button; // 初始化按钮控件
mButton.setBackgroundResource(R.drawable.dropdown_icon); // 设置按钮控件背景为下拉菜单图标
mPopupMenu = new PopupMenu(context, mButton);// 初始化弹出菜单控件，传入上下文和按钮控件
mMenu = mPopupMenu.getMenu();// 初始化弹出菜单控件，传入上下文和按钮控件
mPopupMenu.getMenuInflater().inflate(menuId, mMenu);// 从菜单资源 ID 中填充菜单控件
mButton.setOnClickListener(new OnClickListener() {// 从菜单资源 ID 中填充菜单控件
public void onClick(View v)// 点击事件处理
{
mPopupMenu.show();// 显示弹出菜单控件
}
});
}
public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {
if (mPopupMenu != null) {
mPopupMenu.setOnMenuItemClickListener(listener);
}
} // 设置下拉菜单项的点击监听器
public MenuItem findItem(int id) {
return mMenu.findItem(id);
}// 查找指定id的菜单项
public void setTitle(CharSequence title) {
mButton.setText(title);
}// 设置按钮的标题文字
}

81
xkw2/FoldersListAdapter.java
Unescape View File

@ -0,0 +1,81 @@
/*
* 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.view.View;
import android.view.ViewGroup;
import android.widget.CursorAdapter;
import android.widget.LinearLayout;
import android.widget.TextView;
import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
public class FoldersListAdapter extends CursorAdapter { // 文件夹列表适配器类，继承自CursorAdapter
public static final String [] PROJECTION = {// 查询列的数组，包含ID和SNIPPET两列
NoteColumns.ID,
NoteColumns.SNIPPET
};
public static final int ID_COLUMN = 0;// ID列的索引为0
public static final int NAME_COLUMN = 1;// SNIPPET列的索引为1
public FoldersListAdapter(Context context, Cursor c) {// 构造函数，接收上下文和游标作为参数
super(context, c);
// TODO Auto-generated constructor stub
}
@Override
public View newView(Context context, Cursor cursor, ViewGroup parent) {// 创建新的视图
return new FolderListItem(context); // 返回自定义的文件夹列表项视图
}
@Override
public void bindView(View view, Context context, Cursor cursor) {// 绑定视图和数据
if (view instanceof FolderListItem) { // 判断视图类型是否为FolderListItem
// 获取文件夹名称
String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
.getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);// 绑定文件夹名称到视图
((FolderListItem) view).bind(folderName);
}
}
public String getFolderName(Context context, int position) {// 获取指定位置的Cursor对象
Cursor cursor = (Cursor) getItem(position);// 获取文件夹名称
return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
.getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
}
private class FolderListItem extends LinearLayout {//私有类 FolderListItem，继承自 LinearLayout
private TextView mName;
public FolderListItem(Context context) {
super(context);//调用了 super(context) 来初始化父类 LinearLayout
inflate(context, R.layout.folder_list_item, this);//过 inflate 方法将布局文件 R.layout.folder_list_item 填充到当前 LinearLayout 中
mName = (TextView) findViewById(R.id.tv_folder_name);//通过 findViewById 方法获取到布局文件中的 TextView 控件 tv_folder_name，并将其赋值给成员变量 mName
}
public void bind(String name) {
mName.setText(name);
}//定义了一个 bind 方法，用于将文件夹的名称绑定到 mName 控件上。在该方法中，通过 mName.setText(name) 将名称显示在 TextView 上
}
}

879
xkw2/NoteEditActivity.java
Unescape View File

@ -0,0 +1,879 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.ui;
import android.app.Activity;
import android.app.AlarmManager;
import android.app.AlertDialog;
import android.app.PendingIntent;
import android.app.SearchManager;
import android.appwidget.AppWidgetManager;
import android.content.ContentUris;
import android.content.Context;
import android.content.DialogInterface;
import android.content.Intent;
import android.content.SharedPreferences;
import android.graphics.Paint;
import android.os.Bundle;
import android.preference.PreferenceManager;
import android.text.Spannable;
import android.text.SpannableString;
import android.text.TextUtils;
import android.text.format.DateUtils;
import android.text.style.BackgroundColorSpan;
import android.util.Log;
import android.view.LayoutInflater;
import android.view.Menu;
import android.view.MenuItem;
import android.view.MotionEvent;
import android.view.View;
import android.view.View.OnClickListener;
import android.view.WindowManager;
import android.widget.CheckBox;
import android.widget.CompoundButton;
import android.widget.CompoundButton.OnCheckedChangeListener;
import android.widget.EditText;
import android.widget.ImageView;
import android.widget.LinearLayout;
import android.widget.TextView;
import android.widget.Toast;
import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.TextNote;
import net.micode.notes.model.WorkingNote;
import net.micode.notes.model.WorkingNote.NoteSettingChangedListener;
import net.micode.notes.tool.DataUtils;
import net.micode.notes.tool.ResourceParser;
import net.micode.notes.tool.ResourceParser.TextAppearanceResources;
import net.micode.notes.ui.DateTimePickerDialog.OnDateTimeSetListener;
import net.micode.notes.ui.NoteEditText.OnTextViewChangeListener;
import net.micode.notes.widget.NoteWidgetProvider_2x;
import net.micode.notes.widget.NoteWidgetProvider_4x;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class NoteEditActivity extends Activity implements OnClickListener,
NoteSettingChangedListener, OnTextViewChangeListener {
private class HeadViewHolder {// 内部类HeadViewHolder，用于存储标题栏的控件
public TextView tvModified;// 最后修改时间的TextView
public ImageView ivAlertIcon;// 提醒图标的ImageView
public TextView tvAlertDate;// 提醒图标的ImageView
public ImageView ibSetBgColor;// 设置背景颜色的ImageView
}
private static final Map<Integer, Integer> sBgSelectorBtnsMap = new HashMap<Integer, Integer>();
static {
sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW);
sBgSelectorBtnsMap.put(R.id.iv_bg_red, ResourceParser.RED);
sBgSelectorBtnsMap.put(R.id.iv_bg_blue, ResourceParser.BLUE);
sBgSelectorBtnsMap.put(R.id.iv_bg_green, ResourceParser.GREEN);
sBgSelectorBtnsMap.put(R.id.iv_bg_white, ResourceParser.WHITE);
}
private static final Map<Integer, Integer> sBgSelectorSelectionMap = new HashMap<Integer, Integer>();
static {// 静态代码块，初始化sBgSelectorBtnsMap
sBgSelectorSelectionMap.put(ResourceParser.YELLOW, R.id.iv_bg_yellow_select);// 将黄色按钮id和黄色颜色值放入sBgSelectorBtnsMap中
sBgSelectorSelectionMap.put(ResourceParser.RED, R.id.iv_bg_red_select);// 将红色按钮id和红色颜色值放入sBgSelectorBtnsMap中
sBgSelectorSelectionMap.put(ResourceParser.BLUE, R.id.iv_bg_blue_select); // 将蓝色按钮id和蓝色颜色值放入sBgSelectorBtnsMap中
sBgSelectorSelectionMap.put(ResourceParser.GREEN, R.id.iv_bg_green_select);// 将绿色按钮id和绿色颜色值放入sBgSelectorBtnsMap中
sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select);// 将白色按钮id和白色颜色值放入sBgSelectorBtnsMap中
}
private static final Map<Integer, Integer> sFontSizeBtnsMap = new HashMap<Integer, Integer>();// 定义一个静态的、不可变的Map，用于存储字体大小按钮的ID和对应的字体大小值
static {
sFontSizeBtnsMap.put(R.id.ll_font_large, ResourceParser.TEXT_LARGE);// 将“大号字体”按钮的ID和字体大小值存入Map中
sFontSizeBtnsMap.put(R.id.ll_font_small, ResourceParser.TEXT_SMALL);// 将“小号字体”按钮的ID和字体大小值存入Map中
sFontSizeBtnsMap.put(R.id.ll_font_normal, ResourceParser.TEXT_MEDIUM); // 将“中号字体”按钮的ID和字体大小值存入Map中
sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER);// 将“超大号字体”按钮的ID和字体大小值存入Map中
}
private static final Map<Integer, Integer> sFontSelectorSelectionMap = new HashMap<Integer, Integer>();// 定义一个静态的、不可变的Map，用于存储字体大小值和对应的字体选择器选中状态的ID
static {
sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE, R.id.iv_large_select);// 将字体大小值为“大号字体”的选中状态ID存入Map中
sFontSelectorSelectionMap.put(ResourceParser.TEXT_SMALL, R.id.iv_small_select); // 将字体大小值为“小号字体”的选中状态ID存入Map中
sFontSelectorSelectionMap.put(ResourceParser.TEXT_MEDIUM, R.id.iv_medium_select);// 将字体大小值为“中号字体”的选中状态ID存入Map中
sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select);// 将字体大小值为“超大号字体”的选中状态ID存入Map中
}
private static final String TAG = "NoteEditActivity";// 定义常量TAG为字符串"NoteEditActivity"
// 声明变量
private HeadViewHolder mNoteHeaderHolder;// 头部视图的持有者
private View mHeadViewPanel; // 头部视图面板
private View mNoteBgColorSelector;// 笔记背景颜色选择器
private View mFontSizeSelector;// 笔记字体大小选择器
private EditText mNoteEditor;// 笔记编辑器
private View mNoteEditorPanel;// 笔记编辑器面板
private WorkingNote mWorkingNote;// 工作笔记
private SharedPreferences mSharedPrefs; // 共享偏好设置
private int mFontSizeId; // 字体大小ID
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;// 模式匹配对象
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);//调用父类的onCreate方法
this.setContentView(R.layout.note_edit); //设置当前Activity的布局文件为note_edit.xml
if (savedInstanceState == null && !initActivityState(getIntent())) {//如果savedInstanceState为空且initActivityState方法返回false
finish(); //结束当前Activity
return; //返回
}
initResources();//初始化资源
}
/**
* Current activity may be killed when the memory is low. Once it is killed, for another time
* user load this activity, we should restore the former state
*/
@Override
protected void onRestoreInstanceState(Bundle savedInstanceState) {//重写onRestoreInstanceState方法
super.onRestoreInstanceState(savedInstanceState); //调用父类的onRestoreInstanceState方法
if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) {//如果savedInstanceState不为空且包含Intent.EXTRA_UID键
Intent intent = new Intent(Intent.ACTION_VIEW);//创建一个ACTION_VIEW的Intent对象
intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID)); //将Intent.EXTRA_UID键对应的值放入Intent中
if (!initActivityState(intent)) {//如果initActivityState方法返回false
finish();//结束当前Activity
return;
}
Log.d(TAG, "Restoring from killed activity"); //在Logcat中输出一条调试信息
}
}
private boolean initActivityState(Intent intent) {{ // 初始化Activity状态的方法，传入一个Intent对象
/**
* If the user specified the {@link Intent#ACTION_VIEW} but not provided with id,
* then jump to the NotesListActivity
*/
mWorkingNote = null;{ // 初始化Activity状态的方法，传入一个Intent对象
if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) { // 如果Intent的动作是ACTION_VIEW
long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0); // 获取Intent中的noteId，如果没有则默认为0
mUserQuery = "";// 初始化mUserQuery为空字符串
/**
* Starting from the searched result
*/
if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) {// 初始化mUserQuery为空字符串
noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY));// 获取搜索结果的noteId
mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY);// 获取用户查询的字符串
}
if (!DataUtils.visibleInNoteDatabase(getContentResolver(), noteId, Notes.TYPE_NOTE)) {// 如果noteId在Note数据库中不可见
Intent jump = new Intent(this, NotesListActivity.class); // 创建一个跳转到NotesListActivity的Intent
startActivity(jump); // 启动该Intent
showToast(R.string.error_note_not_exist); // 显示提示信息
finish(); // 结束当前Activity
return false; // 返回false
} else {// 如果noteId在Note数据库中可见
mWorkingNote = WorkingNote.load(this, noteId);// 加载指定noteId对应的WorkingNote对象
if (mWorkingNote == null) {// 如果加载失败
Log.e(TAG, "load note failed with note id" + noteId);// 记录错误信息
finish();
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())) {// 如果Intent的动作是ACTION_INSERT_OR_EDIT
// New note
long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0);// 获取文件夹id
int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID,
AppWidgetManager.INVALID_APPWIDGET_ID);// 获取小部件id
int widgetType = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_TYPE,
Notes.TYPE_WIDGET_INVALIDE); // 获取小部件类型
int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, // 获取背景资源id
ResourceParser.getDefaultBgId(this));
// Parse call-record note
String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER); // 获取电话号码
long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE, 0);// 获取通话记录日期
if (callDate != 0 && phoneNumber != null) {//如果通话日期和电话号码都存在
if (TextUtils.isEmpty(phoneNumber)) {//如果电话号码为空
Log.w(TAG, "The call record number is null");//输出警告信息
}
long noteId = 0; //定义笔记id变量
if ((noteId = DataUtils.getNoteIdByPhoneNumberAndCallDate(getContentResolver(),
phoneNumber, callDate)) > 0) {//如果能够通过电话号码和通话日期获取到笔记id
mWorkingNote = WorkingNote.load(this, noteId);//加载笔记
if (mWorkingNote == null) {//如果笔记加载失败
Log.e(TAG, "load call note failed with note id" + noteId); //输出错误信息
finish();
return false;
}
} else { //如果无法通过电话号码和通话日期获取到笔记id
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);
} else { //如果意图未指定操作
Log.e(TAG, "Intent not specified action, should not support"); //输出错误信息
finish();
return false;
}
mWorkingNote.setOnSettingStatusChangedListener(this);//设置 mWorkingNote 对象的状态改变监听器为当前类（this）
return true;
}
@Override
protected void onResume() {
super.onResume();
initNoteScreen();
}//在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: 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);// 隐藏警报图标
};
}
@Override
protected void onNewIntent(Intent intent) {// 当用户从其它界面返回到此界面时调用的方法
super.onNewIntent(intent); // 调用父类的方法
initActivityState(intent);// 初始化Activity的状态
}
@Override
protected void onSaveInstanceState(Bundle outState) { // 当Activity被销毁时调用的方法，用于保存Activity的状态
super.onSaveInstanceState(outState);
/**
* 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();// 保存笔记
}
outState.putLong(Intent.EXTRA_UID, mWorkingNote.getNoteId());// 将工作笔记的ID放入保存状态中
Log.d(TAG, "Save working note id: " + mWorkingNote.getNoteId() + " onSaveInstanceState");
}// 在日志中记录保存的工作笔记ID
// 触摸事件分发函数
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
if (mNoteBgColorSelector.getVisibility() == View.VISIBLE
&& !inRangeOfView(mNoteBgColorSelector, ev))// 如果笔记背景颜色选择器可见且触摸位置不在选择器内部
{
mNoteBgColorSelector.setVisibility(View.GONE);// 隐藏笔记背景颜色选择器
return true;
}
if (mFontSizeSelector.getVisibility() == View.VISIBLE// 如果字号选择器可见且触摸位置不在选择器内部
&& !inRangeOfView(mFontSizeSelector, ev)) {
mFontSizeSelector.setVisibility(View.GONE);// 隐藏字号选择器
return true;
}// 调用父类的触摸事件分发函数
return super.dispatchTouchEvent(ev);
}
// 判断触摸位置是否在视图范围内
private boolean inRangeOfView(View view, MotionEvent ev) {// 获取视图在屏幕上的位置
int []location = new int[2];
view.getLocationOnScreen(location);
int x = location[0];
int y = location[1];// 获取视图在屏幕上的位置
if (ev.getX() < x
|| ev.getX() > (x + view.getWidth())
|| ev.getY() < y
|| ev.getY() > (y + view.getHeight())) {
return false;
}// 触摸位置在视图范围内
return true;
}
private void initResources() {// 获取笔记标题视图面板
mHeadViewPanel = findViewById(R.id.note_title);// 获取笔记标题视图面板
mNoteHeaderHolder = new HeadViewHolder();// 获取笔记标题视图面板
mNoteHeaderHolder.tvModified = (TextView) findViewById(R.id.tv_modified_date);// 获取笔记标题视图面板
mNoteHeaderHolder.ivAlertIcon = (ImageView) findViewById(R.id.iv_alert_icon);// 获取提醒时间文本视图
mNoteHeaderHolder.tvAlertDate = (TextView) findViewById(R.id.tv_alert_date);// 获取设置背景颜色按钮视图
mNoteHeaderHolder.ibSetBgColor = (ImageView) findViewById(R.id.btn_set_bg_color);// 设置设置背景颜色按钮的点击监听器
mNoteHeaderHolder.ibSetBgColor.setOnClickListener(this);// 获取笔记编辑器视图
mNoteEditor = (EditText) findViewById(R.id.note_edit_view);// 获取笔记编辑器面板视图
mNoteEditorPanel = findViewById(R.id.sv_note_edit);// 获取笔记背景颜色选择器视图
mNoteBgColorSelector = findViewById(R.id.note_bg_color_selector);// 为所有背景选择器按钮设置点击监听器
for (int id : sBgSelectorBtnsMap.keySet()) {
ImageView iv = (ImageView) findViewById(id);
iv.setOnClickListener(this);
}
mFontSizeSelector = findViewById(R.id.font_size_selector);// 设置字体大小选择器控件
for (int id : sFontSizeBtnsMap.keySet()) {
View view = findViewById(id);
view.setOnClickListener(this);
};// 遍历字体大小按钮映射表，并为每个按钮设置点击事件监听器
mSharedPrefs = PreferenceManager.getDefaultSharedPreferences(this);// 获取默认的共享首选项对象
mFontSizeId = mSharedPrefs.getInt(PREFERENCE_FONT_SIZE, ResourceParser.BG_DEFAULT_FONT_SIZE);// 获取上一次使用的字体大小ID，如果没有则使用默认值
/**
* 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;
}//ID可能大于资源长度，在这种情况下，
mEditTextList = (LinearLayout) findViewById(R.id.note_edit_list);
}// 获取笔记编辑列表布局
@Override
protected void 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);// 创建更新小部件的意图
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;
}// 如果小部件类型不支持，则输出错误日志并返回
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {
mWorkingNote.getWidgetId()
});// 将当前笔记的小部件ID添加到意图中
sendBroadcast(intent);// 发送广播更新小部件
setResult(RESULT_OK, intent);// 设置结果为“操作成功”
}
public void onClick(View v) {// 点击事件监听器
int id = v.getId();// 获取被点击的 View 的 ID
if (id == R.id.btn_set_bg_color) {// 如果被点击的是设置背景颜色的按钮
mNoteBgColorSelector.setVisibility(View.VISIBLE);// 显示背景颜色选择器
findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
- View.VISIBLE); // 显示当前背景颜色的选中状态
} else if (sBgSelectorBtnsMap.containsKey(id)) { // 如果被点击的是背景颜色选择器中的按钮
findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
View.GONE);// 隐藏之前选中的背景颜色的选中状态
mWorkingNote.setBgColorId(sBgSelectorBtnsMap.get(id)); // 设置笔记的背景颜色 ID
mNoteBgColorSelector.setVisibility(View.GONE); // 隐藏背景颜色选择器
} else if (sFontSizeBtnsMap.containsKey(id)) {// 如果被点击的是字体大小选择器中的按钮
findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.GONE); // 隐藏之前选中的字体大小的选中状态
mFontSizeId = sFontSizeBtnsMap.get(id);// 设置笔记的字体大小 ID
mSharedPrefs.edit().putInt(PREFERENCE_FONT_SIZE, mFontSizeId).commit();// 将字体大小 ID 存储到 SharedPreferences 中
findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);// 显示新选中的字体大小的选中状态
if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {//如果当前笔记处于待办事项模式
getWorkingText();//获取当前笔记的文本内容；
switchToListMode(mWorkingNote.getContent());//将当前笔记的编辑器切换为列表模式
} else {
mNoteEditor.setTextAppearance(this,
TextAppearanceResources.getTexAppearanceResource(mFontSizeId));//将当前笔记的编辑器文本外观设置为指定字体大小
}
mFontSizeSelector.setVisibility(View.GONE);//隐藏字体大小选择器
}
}
@Override
public void onBackPressed() { // 当用户按下返回键时执行该方法
if(clearSettingState()) { // 如果设置状态已经被清除，则直接返回
return;
}
saveNote(); // 保存笔记
super.onBackPressed(); // 调用父类的onBackPressed方法，关闭当前Activity
}
private boolean clearSettingState() {// 清除设置状态的方法
if (mNoteBgColorSelector.getVisibility() == View.VISIBLE) {// 如果笔记背景颜色选择器可见
mNoteBgColorSelector.setVisibility(View.GONE);// 如果笔记背景颜色选择器可见
return true; // 返回true，表示设置状态已经被清除
} else if (mFontSizeSelector.getVisibility() == View.VISIBLE) {// 否则如果字体大小选择器可见
mFontSizeSelector.setVisibility(View.GONE); // 隐藏字体大小选择器
return true; // 返回true，表示设置状态已经被清除
}
return false; // 返回false，表示设置状态未被清除
}
public void onBackgroundColorChanged() {// 当笔记背景颜色改变时执行该方法
findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
View.VISIBLE); // 根据当前背景颜色id获取对应的选择器，并将其设置为可见
mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId()); // 根据当前背景颜色id获取对应的选择器，并将其设置为可见
mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId()); // 设置笔记标题栏的背景颜色为当前选择的背景颜色
}
@Override
public boolean onPrepareOptionsMenu(Menu menu) {// 当准备显示选项菜单时调用
if (isFinishing()) {// 如果Activity正在被销毁，则返回true
return true;
}
clearSettingState(); // 清除设置状态（即隐藏字体大小选择器和背景颜色选择器）
menu.clear();// 清除菜单项
if (mWorkingNote.getFolderId() == Notes.ID_CALL_RECORD_FOLDER) { // 如果当前笔记所在的文件夹是通话记录文件夹，则加载通话记录编辑菜单项
getMenuInflater().inflate(R.menu.call_note_edit, menu);
} else { // 否则加载笔记编辑菜单项
getMenuInflater().inflate(R.menu.note_edit, menu);
}
if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { // 如果当前是清单模式，则将选项菜单中的“清单模式”改为“正常模式”
menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_normal_mode);
} else {// 否则将选项菜单中的“正常模式”改为“清单模式”
menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_list_mode);
}
if (mWorkingNote.hasClockAlert()) { // 如果当前笔记设置了提醒，则隐藏“添加提醒”菜单项
menu.findItem(R.id.menu_alert).setVisible(false);
} else { // 否则隐藏“删除提醒”菜单项
menu.findItem(R.id.menu_delete_remind).setVisible(false);
}
return true; // 返回true表示已准备好显示选项菜单
}
@Override
public boolean onOptionsItemSelected(MenuItem item) { // 当用户点击菜单项时执行该方法
switch (item.getItemId()) {// 获取用户点击的菜单项ID
case R.id.menu_new_note:// 如果用户点击的是新建笔记菜单项
createNewNote();// 调用创建新笔记的方法
break;
case R.id.menu_delete:// 如果用户点击的是删除笔记菜单项
AlertDialog.Builder builder = new AlertDialog.Builder(this);// 创建一个对话框
builder.setTitle(getString(R.string.alert_title_delete)); // 设置对话框标题
builder.setIcon(android.R.drawable.ic_dialog_alert);// 设置对话框图标
builder.setMessage(getString(R.string.alert_message_delete_note)); // 设置对话框提示信息
builder.setPositiveButton(android.R.string.ok,// 设置对话框确认按钮的点击事件
new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int which) { // 当用户点击确认按钮时执行该方法
deleteCurrentNote(); // 调用删除笔记的方法
finish(); // 关闭当前活动
}
});
builder.setNegativeButton(android.R.string.cancel, null); // 设置对话框取消按钮的点击事件
builder.show();// 显示对话框
break;
case R.id.menu_font_size:// 如果用户点击的是字体大小菜单项
mFontSizeSelector.setVisibility(View.VISIBLE); // 显示字体大小选择器
findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);// 显示当前选中的字体大小
break;
case R.id.menu_list_mode: // 如果用户点击的是清单模式菜单项
mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ?// 切换清单模式
TextNote.MODE_CHECK_LIST : 0);
break;
case R.id.menu_share:// 如果用户点击的是分享菜单项
getWorkingText();// 获取当前笔记的内容
sendTo(this, mWorkingNote.getContent());// 调用分享方法，将笔记内容分享到其他应用
break;
case R.id.menu_send_to_desktop:// 如果用户点击的是发送到桌面菜单项
sendToDesktop(); // 调用发送到桌面的方法
break;
case R.id.menu_alert:// 如果用户点击的是设置提醒菜单项
setReminder();// 调用设置提醒的方法
break;
case R.id.menu_delete_remind: // 如果用户点击的是删除提醒菜单项
mWorkingNote.setAlertDate(0, false);// 将笔记的提醒日期设置为0，表示删除提醒
break;
default:// 如果用户点击的是其他菜单项
break;
}
return true;// 返回true表示菜单项已经被处理
}
private void setReminder() {// 设置提醒时间
DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis());// 创建日期时间选择对话框
d.setOnDateTimeSetListener(new OnDateTimeSetListener() { // 设置日期时间选择监听器
public void OnDateTimeSet(AlertDialog dialog, long date) { // 在日期时间选择监听器中设置提醒时间
mWorkingNote.setAlertDate(date , true);// 设置提醒时间
}
});
d.show(); // 显示日期时间选择对话框
}
/**
* Share note to apps that support {@link Intent#ACTION_SEND} action
* and {@text/plain} type
*/
private void sendTo(Context context, String info) { // 分享笔记到其他应用
Intent intent = new Intent(Intent.ACTION_SEND); // 创建发送意图
intent.putExtra(Intent.EXTRA_TEXT, info);// 设置分享内容
intent.setType("text/plain");// 设置分享内容
context.startActivity(intent);// 启动分享应用
}
private void createNewNote() { // 创建新笔记
// Firstly, save current editing notes
saveNote();// 保存笔记
// For safety, start a new NoteEditActivity
finish();// 结束当前Activity
Intent intent = new Intent(this, NoteEditActivity.class);// 结束当前Activity
intent.setAction(Intent.ACTION_INSERT_OR_EDIT); // 设置意图的操作为插入或编辑
intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mWorkingNote.getFolderId()); // 设置意图的操作为插入或编辑
startActivity(intent);// 启动新笔记的Activity
}
private void deleteCurrentNote() {// 删除当前笔记
if (mWorkingNote.existInDatabase()) {// 如果当前笔记存在于数据库中
HashSet<Long> ids = new HashSet<Long>();// 初始化一个HashSet用于存储笔记的id
long id = mWorkingNote.getNoteId();// 初始化一个HashSet用于存储笔记的id
if (id != Notes.ID_ROOT_FOLDER) {// 如果id不是根文件夹的id
ids.add(id);
} else {
Log.d(TAG, "Wrong note id, should not happen");// 把id添加到HashSet中
}
if (!isSyncMode()) {// 把id添加到HashSet中
if (!DataUtils.batchDeleteNotes(getContentResolver(), ids)) {// 批量删除笔记
Log.e(TAG, "Delete Note error");// 输出错误日志
}
} else {
if (!DataUtils.batchMoveToFolder(getContentResolver(), ids, Notes.ID_TRASH_FOLER)) {// 批量移动笔记到垃圾箱
Log.e(TAG, "Move notes to trash folder error, should not happens");// 输出错误日志
}
}
}
mWorkingNote.markDeleted(true);// 标记当前笔记已被删除
}
private boolean isSyncMode() {// 判断是否为同步模式
return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
}
public void onClockAlertChanged(long date, boolean set) {// 监听提醒时间的变化
/**
* User could set clock to an unsaved note, so before setting the
* alert clock, we should save the note first
*/
if (!mWorkingNote.existInDatabase()) {
saveNote();
}// 如果笔记已保存到数据库中
if (mWorkingNote.getNoteId() > 0) {
Intent intent = new Intent(this, AlarmReceiver.class);// 初始化一个意图用于启动闹钟接收器
intent.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mWorkingNote.getNoteId()));// 设置意图的数据为当前笔记的Uri
PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0, intent, 0);// 获取一个用于启动闹钟接收器的PendingIntent
AlarmManager alarmManager = ((AlarmManager) getSystemService(ALARM_SERVICE));// 获取一个闹钟管理器
showAlertHeader();// 获取一个闹钟管理器
if(!set) {// 如果不设置提醒时间
alarmManager.cancel(pendingIntent);// 如果不设置提醒时间
} else {
alarmManager.set(AlarmManager.RTC_WAKEUP, date, pendingIntent);// 设置当前闹钟
}
} else {
/**
* There is the condition that user has input nothing (the note is
* not worthy saving), we have no note id, remind the user that he
* should input something
*/
Log.e(TAG, "Clock alert setting error");
showToast(R.string.error_note_empty_for_clock);
}
}
public void onWidgetChanged() {// 当小部件发生改变时触发该方法
updateWidget();// 更新小部件
}
public void onEditTextDelete(int index, String text) {// 当删除编辑文本时触发该方法，index表示编辑文本的索引，text表示删除的文本内容
int childCount = mEditTextList.getChildCount();// 获取编辑文本列表中的子项数量
if (childCount == 1) {// 如果只有一个子项，则不进行删除操作
return;
}
for (int i = index + 1; i < childCount; i++) {// 循环遍历编辑文本列表，将所有索引大于被删除文本的索引的文本的索引减1
((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text))
.setIndex(i - 1);
}
mEditTextList.removeViewAt(index); // 移除被删除的编辑文本
NoteEditText edit = null;
if(index == 0) { // 如果被删除的是第一个编辑文本，则将焦点设置到第一个编辑文本
edit = (NoteEditText) mEditTextList.getChildAt(0).findViewById(
R.id.et_edit_text);
} else { // 如果被删除的是第一个编辑文本，则将焦点设置到第一个编辑文本
edit = (NoteEditText) mEditTextList.getChildAt(index - 1).findViewById(
R.id.et_edit_text);
}
int length = edit.length();// 获取编辑文本的长度
edit.append(text);// 将被删除的文本追加到编辑文本上
edit.requestFocus();// 获取焦点
edit.setSelection(length); // 设置光标位置为文本末尾
}
public void onEditTextEnter(int index, String text) {// 当添加编辑文本时触发该方法，index表示编辑文本的索引，text表示添加的文本内容
/**
* Should not happen, check for debug
*/
if(index > mEditTextList.getChildCount()) {// 如果索引大于编辑文本列表中的子项数量，则输出错误日志
Log.e(TAG, "Index out of mEditTextList boundrary, should not happen");
}
View view = getListItem(text, index); // 根据传入的文本和索引获取列表项视图
mEditTextList.addView(view, index);// 将列表项添加到编辑文本列表中
NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);
edit.requestFocus();// 获取焦点
edit.setSelection(0); // 设置光标位置为文本开头
for (int i = index + 1; i < mEditTextList.getChildCount(); i++) {// 循环遍历编辑文本列表，将所有索引大于被添加文本的索引的文本的索引加1
((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text))
.setIndex(i);
}
}
private void switchToListMode(String text) {// 切换到列表模式
mEditTextList.removeAllViews();// 移除所有的 View
String[] items = text.split("\n");// 以换行符为分隔符，将字符串 text 分割成多个条目
int index = 0;
for (String item : items) {// 遍历每个条目
if(!TextUtils.isEmpty(item)) {// 如果条目不为空
mEditTextList.addView(getListItem(item, index));// 将新建的条目添加到 mEditTextList 中
index++;
}
}
mEditTextList.addView(getListItem("", index));// 添加一个空条目
mEditTextList.getChildAt(index).findViewById(R.id.et_edit_text).requestFocus();// 获取最后一个条目中的 NoteEditText，并将其设为焦点
mNoteEditor.setVisibility(View.GONE);// 隐藏 mNoteEditor
mEditTextList.setVisibility(View.VISIBLE);// 显示 mEditTextList
}
private Spannable getHighlightQueryResult(String fullText, String userQuery) {// 获取高亮显示查询结果的 Spannable 对象
SpannableString spannable = new SpannableString(fullText == null ? "" : fullText);// 将 fullText 转换为 SpannableString 对象
if (!TextUtils.isEmpty(userQuery)) {// 使用正则表达式匹配 userQuery
mPattern = Pattern.compile(userQuery);
Matcher m = mPattern.matcher(fullText);
int start = 0;
while (m.find(start)) {// 将匹配到的字符串进行高亮显示
spannable.setSpan(
new BackgroundColorSpan(this.getResources().getColor(
R.color.user_query_highlight)), m.start(), m.end(),
Spannable.SPAN_INCLUSIVE_EXCLUSIVE);
start = m.end();
}
}
return spannable;
}
private View getListItem(String item, int index) {// 获取列表项视图
View view = LayoutInflater.from(this).inflate(R.layout.note_edit_list_item, null);// 从布局文件中加载视图
final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);// 获取编辑框
edit.setTextAppearance(this, TextAppearanceResources.getTexAppearanceResource(mFontSizeId));// 设置编辑框文本的外观样式
CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item));// 获取复选框
cb.setOnCheckedChangeListener(new OnCheckedChangeListener() {// 设置复选框状态改变的监听器
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {// 复选框状态改变时的回调方法
if (isChecked) {// 如果被选中，则在编辑框中添加删除线
edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG);
} else {// 否则，编辑框中的文本恢复正常样式
edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG);
}
}
});
if (item.startsWith(TAG_CHECKED)) {// 否则，编辑框中的文本恢复正常样式
cb.setChecked(true); // 设置复选框为选中状态
edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG); // 在编辑框中添加删除线
item = item.substring(TAG_CHECKED.length(), item.length()).trim();// 截取文本内容
} else if (item.startsWith(TAG_UNCHECKED)) { // 未选中
cb.setChecked(false); // 设置复选框为未选中状态
edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG); // 编辑框中的文本恢复正常样式
item = item.substring(TAG_UNCHECKED.length(), item.length()).trim(); // 截取文本内容
}
edit.setOnTextViewChangeListener(this);// 设置编辑框的文本内容变化监听器
edit.setIndex(index);// 设置编辑框的索引值
edit.setText(getHighlightQueryResult(item, mUserQuery));// 设置编辑框的文本内容，并高亮显示用户查询结果
return view;// 返回列表项视图
}
public void onTextChange(int index, boolean hasText) {
if (index >= mEditTextList.getChildCount()) {// 当文本框的内容改变时，根据文本框的索引和是否有文本来显示或隐藏复选框
Log.e(TAG, "Wrong index, should not happen");
return;// 如果索引超出范围，打印错误日志并返回
}
if(hasText) {
mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.VISIBLE);// 如果有文本，显示复选框
} else {
mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.GONE);// 如果没有文本，隐藏复选框
}
}
public void onCheckListModeChanged(int oldMode, int newMode) {// 当清单模式改变时
if (newMode == TextNote.MODE_CHECK_LIST) { // 如果新模式是清单模式
switchToListMode(mNoteEditor.getText().toString()); // 切换到清单模式
} else { // 如果新模式不是清单模式
if (!getWorkingText()) { // 如果当前没有工作文本
mWorkingNote.setWorkingText(mWorkingNote.getContent().replace(TAG_UNCHECKED + " ",
"")); // 将工作文本设置为去掉未勾选标记的内容
}
mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));// 设置文本框的内容为高亮查询结果
mEditTextList.setVisibility(View.GONE); // 隐藏文本框列表
mNoteEditor.setVisibility(View.VISIBLE); // 显示文本框
}
}
private boolean getWorkingText() {//获取当前编辑的文本内容，包括已完成和未完成的任务列表
boolean hasChecked = false;//标记是否有已完成的任务
if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {//如果目前是任务列表模式
StringBuilder sb = new StringBuilder(); //创建一个字符串构建器
for (int i = 0; i < mEditTextList.getChildCount(); i++) { //循环遍历所有的子项
View view = mEditTextList.getChildAt(i);//获取当前子项的视图
NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);//获取当前子项的编辑框
if (!TextUtils.isEmpty(edit.getText())) { //如果编辑框不为空
if (((CheckBox) view.findViewById(R.id.cb_edit_item)).isChecked()) { //如果当前项被选中
sb.append(TAG_CHECKED).append(" ").append(edit.getText()).append("\n");//在字符串构建器中添加已完成的任务项
hasChecked = true;//标记有已完成的任务
} else {//如果当前项未被选中
sb.append(TAG_UNCHECKED).append(" ").append(edit.getText()).append("\n");//在字符串构建器中添加未完成的任务项
}
}
}
mWorkingNote.setWorkingText(sb.toString()); //将构建好的字符串设置为当前工作的文本内容
} else { //如果不是任务列表模式
mWorkingNote.setWorkingText(mNoteEditor.getText().toString()); //将编辑框中的文本设置为当前工作的文本内容
}
return hasChecked; //返回是否有已完成的任务项的标记
}
private boolean saveNote() {// 保存笔记到数据库中
getWorkingText();// 获取编辑框中的文本内容
boolean saved = mWorkingNote.saveNote();// 将笔记保存到数据库中
if (saved) {
/**
* There are two modes from List view to edit view, open one note,
* create/edit a node. Opening node requires to the original
* position in the list when back from edit view, while creating a
* new node requires to the top of the list. This code
* {@link #RESULT_OK} is used to identify the create/edit state
*/
setResult(RESULT_OK);// 设置返回结果为RESULT_OK
}
return saved; // 返回是否保存成功的结果
}
private void sendToDesktop() {
/**
* Before send message to home, we should make sure that current
* editing note is exists in databases. So, for new note, firstly
* save it
*/
if (!mWorkingNote.existInDatabase()) {
saveNote(); // 如果笔记不存在于数据库中，则先保存笔记
}
if (mWorkingNote.getNoteId() > 0) { // 如果笔记存在于数据库中
Intent sender = new Intent(); // 创建Intent对象
Intent shortcutIntent = new Intent(this, NoteEditActivity.class); // 创建快捷方式Intent对象
shortcutIntent.setAction(Intent.ACTION_VIEW); // 设置快捷方式Intent的Action为ACTION_VIEW
shortcutIntent.putExtra(Intent.EXTRA_UID, mWorkingNote.getNoteId()); // 设置快捷方式Intent的额外数据
sender.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent); // 设置发送Intent的额外数据
sender.putExtra(Intent.EXTRA_SHORTCUT_NAME,
makeShortcutIconTitle(mWorkingNote.getContent())); // 设置发送Intent的额外数据
sender.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,
Intent.ShortcutIconResource.fromContext(this, R.drawable.icon_app)); // 设置发送Intent的额外数据
sender.putExtra("duplicate", true); // 设置发送Intent的额外数据
sender.setAction("com.android.launcher.action.INSTALL_SHORTCUT"); // 设置发送Intent的Action为INSTALL_SHORTCUT
showToast(R.string.info_note_enter_desktop);// 显示Toast提示信息
sendBroadcast(sender); // 发送广播
} else {
/**
* There is the condition that user has input nothing (the note is
* not worthy saving), we have no note id, remind the user that he
* should input something
*/
Log.e(TAG, "Send to desktop error");// 打印错误日志信息
showToast(R.string.error_note_empty_for_send_to_desktop); // 显示Toast提示信息
}
}
private String makeShortcutIconTitle(String content) { // 生成快捷方式的图标标题，去掉勾选框的标记
content = content.replace(TAG_CHECKED, ""); // 去掉已勾选的标记
content = content.replace(TAG_UNCHECKED, ""); // 去掉未勾选的标记
return content.length() > SHORTCUT_ICON_TITLE_MAX_LEN ? content.substring(0,
SHORTCUT_ICON_TITLE_MAX_LEN) : content; // 如果标题超出指定长度，截取前 SHORTCUT_ICON_TITLE_MAX_LEN 个字符作为标题
}
private void showToast(int resId) { // 显示短时间的提示信息
showToast(resId, Toast.LENGTH_SHORT);
}
private void showToast(int resId, int duration) { // 显示指定时间的提示信息
Toast.makeText(this, resId, duration).show();
}
}

136
xkw2/NoteWidgetProvider.java
Unescape View File

@ -0,0 +1,136 @@
/*
* 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.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
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;
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 {
public static final String [] PROJECTION = new String [] {
NoteColumns.ID,//便签的ID
NoteColumns.BG_COLOR_ID,//背景颜色ID
NoteColumns.SNIPPET//摘录
};//定义了一个抽象类NoteWidgetProvider，它继承了AppWidgetProvider类
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";//定义字符串变量TAG用于在日志中标记该类的信息。
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
ContentValues values = new ContentValues();//通过使用 ContentResolver.update()方法来更新 Notes.CONTENT_NOTE_URI 数据库中的笔记数据实现的。
values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
for (int i = 0; i < appWidgetIds.length; i++) {
context.getContentResolver().update(Notes.CONTENT_NOTE_URI,
values,
NoteColumns.WIDGET_ID + "=?",
new String[] { String.valueOf(appWidgetIds[i])});
}//更新操作使用 NoteColumns.WIDGET_ID + "=?" 作为查询条件，将笔记中 widget id 与当前 appWidgetId 匹配的记录进行更新。
}
private Cursor getNoteWidgetInfo(Context context, int widgetId) {
return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
PROJECTION,//查询便签内容提供程序的Notes表，查询的投影为PROJECTION
NoteColumns.WIDGET_ID + "=? AND " + NoteColumns.PARENT_ID + "<>?",
new String[] { String.valueOf(widgetId), String.valueOf(Notes.ID_TRASH_FOLER) },
null);//查询的条件为NoteColumns.WIDGET_ID = widgetId且NoteColumns.PARENT_ID不等于Notes.ID_TRASH_FOLER。查询结果返回一个Cursor对象。
}//一个私有方法，用于获取指定widgetId的便签小部件信息。它接收两个参数：上下文Context和widgetId
protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
update(context, appWidgetManager, appWidgetIds, false);
}//调用了另一个重载的 update 方法，并将最后一个参数设置为 false
private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds,
boolean privacyMode) {
for (int i = 0; i < appWidgetIds.length; i++) {
if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {
int bgId = ResourceParser.getDefaultBgId(context);
String snippet = "";
Intent intent = new Intent(context, NoteEditActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetIds[i]);
intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType());//获取默认的背景ID和空字符串片段，并创建一个Intent对象，该对象指向NoteEditActivity类
Cursor c = getNoteWidgetInfo(context, appWidgetIds[i]);//调用 getNoteWidgetInfo() 方法获取 widget 的信息
if (c != null && c.moveToFirst()) {
if (c.getCount() > 1) {
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);
intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID));
intent.setAction(Intent.ACTION_VIEW);
} //如果获取到了信息，就从 Cursor 对象中获取 snippet 和背景图像 ID，并将这些数据设置到 Intent 对象中。
else {
snippet = context.getResources().getString(R.string.widget_havenot_content);
intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
}//如果没有获取到信息，就设置 snippet 为默认的文本内容，并将 Intent 对象的 action 设置为 ACTION_INSERT_OR_EDIT。
if (c != null) {
c.close();
}
RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());//创建一个 RemoteViews 对象，并设置背景图像和文本内容
rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));
intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId);//根据 privacyMode 的值，为 RemoteViews 对象设置一个点击事件
/**
* 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);
}//如果 privacyMode 为 true，就将文本内容设置为“正在访问模式下”，并创建一个 PendingIntent 对象，指向 NotesListActivity 类
else {
rv.setTextViewText(R.id.widget_text, snippet);
pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], intent,
PendingIntent.FLAG_UPDATE_CURRENT);
}//如果 privacyMode 为 false，就将文本内容设置为 snippet，并创建一个 PendingIntent 对象，指向 NoteEditActivity 类
rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent);//PendingIntent 对象设置为 RemoteViews 对象的点击事件
appWidgetManager.updateAppWidget(appWidgetIds[i], rv);//使用 AppWidgetManager 对象更新 widget。
}//检查每个ID是否为INVALID_APPWIDGET_ID， for 循环遍历 appWidgetIds 数组中的每个 widget，并对每个 widget 进行更新。
}
}
protected abstract int getBgResourceId(int bgId);//根据给定的背景资源ID获取背景资源的资源ID
protected abstract int getLayoutId();//获取布局文件的资源ID
protected abstract int getWidgetType();//获取小部件的类型
}

47
xkw2/NoteWidgetProvider_2x.java
Unescape View File

@ -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;
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 {
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
super.update(context, appWidgetManager, appWidgetIds);//重写了 onUpdate() 方法，调用了父类的 update() 方法
}//继承自 NoteWidgetProvider 类
@Override
protected int getLayoutId() {
return R.layout.widget_2x;
}//重写了 getLayoutId() 方法，返回小部件布局的 ID
@Override
protected int getBgResourceId(int bgId) {
return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
}//重写了 getBgResourceId() 方法，返回小部件背景资源的 ID
@Override
protected int getWidgetType() {
return Notes.TYPE_WIDGET_2X;
}
}//重写了 getWidgetType() 方法，返回小部件的类型

46
xkw2/NoteWidgetProvider_4x.java
Unescape View File

@ -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 {
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
super.update(context, appWidgetManager, appWidgetIds);
}//调用了父类NoteWidgetProvider的update方法，更新了widget
protected int getLayoutId() {
return R.layout.widget_4x;
}//返回了widget布局文件的资源id，即R.layout.widget_4x
@Override
protected int getBgResourceId(int bgId) {
return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);
}//据传入的背景id，获取对应的widget背景资源id，具体实现在ResourceParser.WidgetBgResources类中
@Override
protected int getWidgetType() {
return Notes.TYPE_WIDGET_4X;
}
}//返回了widget类型，即Notes.TYPE_WIDGET_4X
Write Preview
Loading…
Cancel
Save