精读 #4

Merged
p42acfr3v merged 1 commits from cy_branch into develop 2 years ago

@ -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;//引入notes.ui开发包
//以下import各种库文件后续需要使用
import android.app.Activity;//导入Activity包
import android.app.AlertDialog;//弹出警告对话框
import android.content.Context;//提供了有关应用程序的全局信息
//content主要是和数据库进行交互,对数据库进行增删改查操作
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;//调用以上三个类及一些android库函数
public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {//继承拓展Activity类并实现两个接口
private long mNoteId;//声明存储在数据库中的便签ID号
private String mSnippet; //闹钟提示的文本内容
private static final int SNIPPET_PREW_MAX_LEN = 60;//声明文本摘要的最大长度为60
MediaPlayer mPlayer;//实例化一个多媒体播放器
@Override
protected void onCreate(Bundle savedInstanceState) {//重写onCreate方法
super.onCreate(savedInstanceState);//使用super调用父类的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);//当使用这个flag时,window manager会报告插入window的矩形大小
}
Intent intent = getIntent();//通过getIntent()获得的Intent用于开启Activity
try {//语句块:异常处理,当要程序出现错误时可以不中断继续运行下去
mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));//获取便签ID
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;//比较片段的长度,若大于最大长度,则截取最大长度+...
} catch (IllegalArgumentException e) {//捕获异常并进行处理
e.printStackTrace();//打印出详细的异常信息
return;
}
mPlayer = new MediaPlayer();//新建媒体播放器
if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {//由该便签的id从数据库中获取其类型判断是否为需要提醒的便签
showActionDialog();//弹出对话框
playAlarmSound();//播放闹钟提示音
} else {
finish();//结束闹钟动作
}
}
private boolean isScreenOn() {//判断是否出现在屏幕上
PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);//获得PowerManager的实例
return pm.isScreenOn();//判断屏幕是否打开
}
private void playAlarmSound() {//播放提示音
Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);//调用系统的铃声管理URI得到闹钟提示音
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 {
mPlayer.setDataSource(this, url);//设置播放器的数据源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);//设置“OK”按钮
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);//设置动作的属性
intent.putExtra(Intent.EXTRA_UID, mNoteId);//附加便签的id
startActivity(intent);//开始动作
break;
default:
break;
}
}
public void onDismiss(DialogInterface dialog) {//提示框消失事件处理
stopAlarmSound();//停止响铃
finish();
}
private void stopAlarmSound() {//关闭闹钟铃音
if (mPlayer != null) {//如果播放器仍然存在
mPlayer.stop();//停止播放
mPlayer.release();//释放
mPlayer = null;//清空播放器资源
}
}
}

@ -0,0 +1,65 @@
/*
* 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 {//实现接受闹铃启动消息的功能
private static final String [] PROJECTION = new String [] {//声明PROJECTION每个元素包括id和提醒日期
NoteColumns.ID,
NoteColumns.ALERTED_DATE
};
private static final int COLUMN_ID = 0;
private static final int COLUMN_ALERTED_DATE = 1;//设定ID和闹钟信息的初始值
@Override
public void onReceive(Context context, Intent intent) {//接收广播后的处理过程
long currentDate = System.currentTimeMillis();//通过系统函数获了当前时间存入currentDate变量。
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);//类型转换将long类型的currentDate转变为String类
if (c != null) {
if (c.moveToFirst()) {//游标移动到开始位置
do {
long alertDate = c.getLong(COLUMN_ALERTED_DATE);//获取要提醒的日期
Intent sender = new Intent(context, AlarmReceiver.class);//新建一个intent类来指向alarmreceiver 来传输数据
sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));//设置数据为便签的uri和id
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);//创建一个广播组件,可以在手机广播栏显示相应内容
AlarmManager alermManager = (AlarmManager) context//新建系统的闹钟服务
.getSystemService(Context.ALARM_SERVICE);
alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);//设置一系列需要传输的数据
} while (c.moveToNext());//游标移动到下一位置
}
c.close();//关闭游标
}
}
}

@ -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;//接收广播并启动 AlarmAlertActivity类
import android.content.Context;//环境
import android.content.Intent;//文本意向
public class AlarmReceiver extends BroadcastReceiver {//闹钟接收器,继承自广播接收器
@Override
public void onReceive(Context context, Intent intent) {//重载Onreceive()方法,实现对广播的侦听,由此实现对接受闹铃启动消息的功能
intent.setClass(context, AlarmAlertActivity.class);//从当前的Intent启动AlarmAlertActivity即组件之间的跳转
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);//为该intent添加flag使其加入一个新的task栈中
context.startActivity(intent);//使用intent启动Activity
}
}

@ -0,0 +1,485 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.ui;//引入ui包
import 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 {//继承FrameLayout类时间日期选择器
private static final boolean DEFAULT_ENABLE_STATE = true;
//以下设置时间参数与变量
private static final int HOURS_IN_HALF_DAY = 12;//半天12小时
private static final int HOURS_IN_ALL_DAY = 24;//一整天24小时
private static final int DAYS_IN_ALL_WEEK = 7;//一周七天
private static final int DATE_SPINNER_MIN_VAL = 0;//日期循环最小值为0
private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1;//日期轮转最大值为6
private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0;//24小时制小时最小值为0
private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23;//24小时制小时最大值为23
private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1;//12小时制最小为1
private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12;//12小时制最大为12
private static final int MINUT_SPINNER_MIN_VAL = 0;//分钟数最小值为0
private static final int MINUT_SPINNER_MAX_VAL = 59;//分钟数最大值为59
private static final int AMPM_SPINNER_MIN_VAL = 0;//上午开始为0
private static final int AMPM_SPINNER_MAX_VAL = 1;//下午开始标志为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() {//监听日期变化传送给mDate并进行同步更新操作
@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小时制
if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) {//对于12小时制11点和12点进行交替时的操作
cal.setTimeInMillis(mDate.getTimeInMillis());//将参数的值作为系统时间
cal.add(Calendar.DAY_OF_YEAR, 1);//日期值加1
isDateChanged = true;//日期变化标志置为true
} else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {// 在凌晨12时变化到前一天夜晚11时的时候
cal.setTimeInMillis(mDate.getTimeInMillis());//设定日期
cal.add(Calendar.DAY_OF_YEAR, -1);//日期值减1
isDateChanged = true;
}
if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY ||
oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {//对于12小时制对am 和pm的操作
mIsAm = !mIsAm;//上下午标志转换
updateAmPmControl();//更新上下午标志
}
} else {
if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {//对于24小时制时晚上11点和12点交替时对日期的更改
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, 1);//日期值加1
isDateChanged = true;
} else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) {//这里是对于12小时制时凌晨11点和12点交替时对日期的更改
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, -1);
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));
}
}
};
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;//设置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();//得到现在的小时数来决定是否修改am或是pm
if (newHour >= HOURS_IN_HALF_DAY) {//如果现在的时间大于或者等于12就设置为pm
mIsAm = false;
updateAmPmControl();
} else {//新时间在12点前为am
mIsAm = true;
updateAmPmControl();
}
}
mDate.set(Calendar.MINUTE, newVal);//更新分钟数
onDateTimeChanged();//监听时间变化
}
};
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);
}
updateAmPmControl();
onDateTimeChanged();
}
};
public interface OnDateTimeChangedListener {//检测日期的变化
void onDateTimeChanged(DateTimePicker view, int year, int month,
int dayOfMonth, int hourOfDay, int minute);
}
public DateTimePicker(Context context) {
this(context, System.currentTimeMillis());
}//访问数据库,获取系统时间
public DateTimePicker(Context context, long date) {//将获得的系统时间转化为我们需要的数据
this(context, date, DateFormat.is24HourFormat(context));
}
public DateTimePicker(Context context, long date, boolean is24HourView) {//选择时间
super(context);
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);//设置监听长按时间间隔为100ms
mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener);
String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings();//对24小时下的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();//更新小时控制使其为初态
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);
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) {//设置当前的时间参数是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);
}//获取当前年、月、日、时、分、12/24表示、AM/PM表示并修改
/**
* 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();//返回24小时制的小时数
} else {//返回12小时制的小时数
int hour = getCurrentHourOfDay();
if (hour > HOURS_IN_HALF_DAY) {//与之前标注一样
return hour - HOURS_IN_HALF_DAY;
} else {
return hour == 0 ? HOURS_IN_HALF_DAY : hour;
}
}
}
/**
* 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;//pm
if (hourOfDay > HOURS_IN_HALF_DAY) {//晚上11点到第二天更改小时数
hourOfDay -= HOURS_IN_HALF_DAY;
}
} else {
mIsAm = true;
if (hourOfDay == 0) {
hourOfDay = HOURS_IN_HALF_DAY;
}
}
updateAmPmControl();
}
mHourSpinner.setValue(hourOfDay);
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;
}//判断是否为24小时视图
/**
* 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) {//设置24小时视图
if (mIs24HourView == is24HourView) {
return;
}
mIs24HourView = is24HourView;
mAmPmSpinner.setVisibility(is24HourView ? View.GONE : View.VISIBLE);//如果是12小时制则显示上午还是下午
int hour = getCurrentHourOfDay();//定义hour为当前24小时下的小时数
updateHourControl();//更新小时操作
setCurrentHour(hour);//设置小时数
updateAmPmControl();//更新am和pm操作
}
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) {//循环当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 {
int index = mIsAm ? Calendar.AM : Calendar.PM;//判断当前是上午还是下午
mAmPmSpinner.setValue(index);//设置上下午转轮的值
mAmPmSpinner.setVisibility(View.VISIBLE);//使上下午转轮可见
}
}
private void updateHourControl() {//更新小时控制
if (mIs24HourView) {//根据当前小时制设置时间
mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW);//设置最小轮转为24小时
mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW);//设置最大轮转为24小时
} else {
mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW);//设置最小轮转为12小时
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());
}
}
}

@ -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;//引入ui包
import java.util.Calendar;//导入日历工具包
import net.micode.notes.R;//引入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 {//时间日期选择器对话框
private Calendar mDate = Calendar.getInstance();//声明一个calendar类的对象用于操作日期
private boolean mIs24HourView;//判断当前设置是否为24小时模式
private OnDateTimeSetListener mOnDateTimeSetListener;//声明一个日期设置监听控件
private DateTimePicker mDateTimePicker;//声明日期选择器,运行时会产生数字的选择列表
public interface OnDateTimeSetListener {//设置一个接口当时期时间设置时进行的操作
void OnDateTimeSet(AlertDialog dialog, long date);//设置时间监听器
}
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);//将year设置为mNote的年份
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());//根据从mdate中获取的当前时间设置现有时间
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小时显示
updateTitle(mDate.getTimeInMillis());//更新标题时间
}
public void set24HourView(boolean is24HourView) {
mIs24HourView = is24HourView;
}//设置24小时视图
public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {//设置一个时期时间设置的监听器
mOnDateTimeSetListener = callBack;//回收日期监听器
}
private void updateTitle(long date) {//根据时间更新标题
int flag =//通过DataUtils按照24时制显示
DateUtils.FORMAT_SHOW_YEAR |//根据date和显示格式设置标题
DateUtils.FORMAT_SHOW_DATE |
DateUtils.FORMAT_SHOW_TIME;
flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;//是否为24小时
setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));//设置标题
}
public void onClick(DialogInterface arg0, int arg1) {//arg0接收到点击事件的对话框arg1是该对话框上的按钮
if (mOnDateTimeSetListener != null) {//设置日期时间
mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
}
}
}

@ -0,0 +1,61 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.ui;//导入ui包
import android.content.Context;//引入需要使用的Context、Menu等包
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) {//设置显示一个菜单
mButton = button;//设置按钮样式
mButton.setBackgroundResource(R.drawable.dropdown_icon);//设置其背景资源为下拉菜单的图标
mPopupMenu = new PopupMenu(context, mButton);//实例化一个弹出式菜单
mMenu = mPopupMenu.getMenu();//获得弹出式菜单的菜单项
mPopupMenu.getMenuInflater().inflate(menuId, mMenu);//获得弹出式菜单的菜单项
mButton.setOnClickListener(new OnClickListener() {//当我们点击mButton时会弹出菜单
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);
}//对于菜单选项的初始化,根据索引搜索菜单需要的选项
public void setTitle(CharSequence title) {
mButton.setText(title);
}//根据索引搜索菜单需要的选项
}

@ -0,0 +1,80 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.ui;//导入ui包
//以下导入各种包
import android.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 {//文件夹列表配适器,用于显示文件夹的列表
public static final String [] PROJECTION = {//调用数据库中便签的ID和片段
NoteColumns.ID,
NoteColumns.SNIPPET
};
public static final int ID_COLUMN = 0;//定义常量文件夹ID栏编号
public static final int NAME_COLUMN = 1;//初始化常量NAME
public FoldersListAdapter(Context context, Cursor c) {//调用父类的构造函数
super(context, c);//引用父类方法
// TODO Auto-generated constructor stub
}//构造函数调用父类的构造器将c中的数据传输进该context
@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) {//判断视图是否是文件夹列表的一项
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) {//根据数据库中标签的ID得到标签的各项内容
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 {//设置文件夹项目列表的名称
private TextView mName;
public FolderListItem(Context context) {//文件夹项的构造函数
super(context);//操作数据库
inflate(context, R.layout.folder_list_item, this);//根据布局文件的名字等信息将其找出来
mName = (TextView) findViewById(R.id.tv_folder_name);//根据ID寻找文件的名字等信息
}
public void bind(String name) {
mName.setText(name);
}//绑定文件夹名称
}
}

@ -0,0 +1,873 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.ui;//导入ui包
import android.app.Activity;
import android.app.AlarmManager;//安卓系统应用开发
import android.app.AlertDialog;// 闹钟管理器
import android.app.PendingIntent;
import android.app.SearchManager;//搜索管理器
import android.appwidget.AppWidgetManager;//App工具管理器
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;//便签宽度为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 {//继承Activity,实现了便签的编辑功能,同时对三个监听接口的方法进行实现
private class HeadViewHolder {//创建一个类用于显示文本与图片
public TextView tvModified;//当前文本视图
public ImageView ivAlertIcon;//提醒的图标
public TextView tvAlertDate;//设置的提醒的时间
public ImageView ibSetBgColor;//设置背景颜色
}
private static final Map<Integer, Integer> sBgSelectorBtnsMap = new HashMap<Integer, Integer>();//运用Hashmap类将颜色按钮和对应的资源解析器中的相应颜色关联
static {//对HashMap进行初始化主要是颜色的对应
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>();//实现资源解析器中的颜色ID与背景颜色选择选择按钮已选择对应
static {
sBgSelectorSelectionMap.put(ResourceParser.YELLOW, R.id.iv_bg_yellow_select);//将资源剖析器与选择器相连
sBgSelectorSelectionMap.put(ResourceParser.RED, R.id.iv_bg_red_select);
sBgSelectorSelectionMap.put(ResourceParser.BLUE, R.id.iv_bg_blue_select);
sBgSelectorSelectionMap.put(ResourceParser.GREEN, R.id.iv_bg_green_select);
sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select);
}//提供了一个用户选择主界面颜色的功能
private static final Map<Integer, Integer> sFontSizeBtnsMap = new HashMap<Integer, Integer>();//将字体的大小与相对应的选择相连接
static {//提供各种大小字体的选择
sFontSizeBtnsMap.put(R.id.ll_font_large, ResourceParser.TEXT_LARGE);//大
sFontSizeBtnsMap.put(R.id.ll_font_small, ResourceParser.TEXT_SMALL);//小
sFontSizeBtnsMap.put(R.id.ll_font_normal, ResourceParser.TEXT_MEDIUM);//普通
sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER);//超大
}
private static final Map<Integer, Integer> sFontSelectorSelectionMap = new HashMap<Integer, Integer>();//实现资源解析器中字号ID与字体大小按钮已选择对应
static {//选择字体大小的界面
sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE, R.id.iv_large_select);
sFontSelectorSelectionMap.put(ResourceParser.TEXT_SMALL, R.id.iv_small_select);
sFontSelectorSelectionMap.put(ResourceParser.TEXT_MEDIUM, R.id.iv_medium_select);
sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select);
}
private static final String TAG = "NoteEditActivity";//编辑文本的activity
private HeadViewHolder mNoteHeaderHolder;//设置头部布局
private View mHeadViewPanel;//对表头的操作
private View mNoteBgColorSelector;//便签的背景色选择器
private View mFontSizeSelector;//便签的字体大小选择器
private EditText mNoteEditor;//便签编辑器
private View mNoteEditorPanel;//文本编辑控制板
private WorkingNote mWorkingNote;//对模板WorkingNote的初始化
private SharedPreferences mSharedPrefs;//私有化SharedPreferences的数据存储方式
private int mFontSizeId;//操作字体大小
private static final String PREFERENCE_FONT_SIZE = "pref_font_size";//字体大小设置
private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10;//设置标题最大长度为10
public static final String TAG_CHECKED = String.valueOf('\u221A');//定义final字符串表明已标记
public static final String TAG_UNCHECKED = String.valueOf('\u25A1');//定义final字符串表明未标记
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);//设置活动的显示布局
if (savedInstanceState == null && !initActivityState(getIntent())) {
finish();
return;
}//如果未保存实例状态且当前Activity未初始化完成则结束当前Activity
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) {//保存当前界面状态
super.onRestoreInstanceState(savedInstanceState);//调用父类函数
if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) {//如果保存了关闭前的实例状态且其中包含着便签标识符则将该标识符添加到初始化Activity的Intent中
Intent intent = new Intent(Intent.ACTION_VIEW);//新建一个intent
intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID));//利用此前的extra_uid初始化一个intent
if (!initActivityState(intent)) {//初始化活动状态失败则结束Activity
finish();
return;
}
Log.d(TAG, "Restoring from killed activity");//记录操作信息到日志中
}
}
private boolean initActivityState(Intent intent) {//初始化活动状态
/**
* If the user specified the {@link Intent#ACTION_VIEW} but not provided with id,
* then jump to the NotesListActivity
*///如果找不到便签则返回NotesListActivity并报错“便签不存在”//
mWorkingNote = null;// 初始化便签数据
if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) {//触摸动作的原始32位信息包括事件的动作触控点信息
long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0);//获取到便签id
mUserQuery = "";//
/**
* Starting from the searched result
*/
if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) {//若intent中含有搜索的数据
noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY));//获取便签ID
mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY);//将用户请求的字符串保存在变量mUserQuery中
}
if (!DataUtils.visibleInNoteDatabase(getContentResolver(), noteId, Notes.TYPE_NOTE)) {//如果在数据库中查找不到
Intent jump = new Intent(this, NotesListActivity.class);//设置Intent目的组件为NotesListActivity
startActivity(jump);
showToast(R.string.error_note_not_exist);//设置Intent目的组件为NotesListActivity
finish();
return false;
} else {
mWorkingNote = WorkingNote.load(this, noteId);//加载对应id的便签项
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);//使Edit界面适应软键盘弹出
} else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) {//通过 getAction得到的字符串来决定做什么
// New note
long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0);//获取intent中传入的父文件夹id默认为0
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,
ResourceParser.getDefaultBgId(this));//获取背景颜色资源id默认为随机背景色
// Parse call-record note
String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER);//解析电话簿记录
long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE, 0);//获取提醒时间默认为0
if (callDate != 0 && phoneNumber != null) {//如果通话日期与号码均存在
if (TextUtils.isEmpty(phoneNumber)) {//如果记录的通话号码为空,则显示警告
Log.w(TAG, "The call record number is null");
}
long noteId = 0;//这里根据获取到的电话号字符串从数据库中获取相应的noteid
if ((noteId = DataUtils.getNoteIdByPhoneNumberAndCallDate(getContentResolver(),
phoneNumber, callDate)) > 0) {//通过通话号码和通话日期在数据库中查找noteId
mWorkingNote = WorkingNote.load(this, noteId);//导入这个便签
if (mWorkingNote == null) {//noteId对应的内容为空输出报错信息返回错误初始化失败
Log.e(TAG, "load call note failed with note id" + noteId);
finish();
return false;
}
} else {//将电话号码与手机的号码簿相关
mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId,
widgetType, bgResId);//没有查找到noteId信息则重新建立空便签使用之前默认参量对便签进行初始化
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);//为这个便签设置一个设置变化的监听器
return true;//返回true表示初始化该Activity成功
}
@Override
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());//设置文本编辑框中显示的文字是workingnote类中包含的便签文字并且设置文本被选中
}
for (Integer id : sBgSelectorSelectionMap.keySet()) {//对于背景里的图片选择做for循环遍历
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);//初始化活动状态
}
@Override
protected void onSaveInstanceState(Bundle outState) {//保存当前活动的状态
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()) {//如果该workingnote实例无法在数据库中找到
saveNote();//保存标签
}
outState.putLong(Intent.EXTRA_UID, mWorkingNote.getNoteId());//将生成的noteId保存到outState中
Log.d(TAG, "Save working note id: " + mWorkingNote.getNoteId() + " onSaveInstanceState");//使用Log输出debug信息保存的执行便签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) {//判断触摸事件发生的位置是否在View控件范围内
int []location = new int[2];
view.getLocationOnScreen(location);//声明location数组用于存放屏幕位置的横纵坐标x-y
int x = location[0];
int y = location[1];
if (ev.getX() < x//如果触控的位置超出了给定的范围返回false
|| 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();//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;//将其设置为默认长度缺省值为1
}
mEditTextList = (LinearLayout) findViewById(R.id.note_edit_list);//得到标签编辑的列表
}
@Override
protected void onPause() {//重写onPause方法将便签编辑界面暂停
super.onPause();
if(saveNote()) {//保存便签的内容
Log.d(TAG, "Note data was saved with length:" + mWorkingNote.getContent().length());// 暂停时即进行便签的存储,记录log文件
}
clearSettingState();//清除状态设置
}
private void updateWidget() {//更新窗口与桌面小窗口同步
Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);//实例化Intent用于和AppWidgetManager进行消息交换
if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) {//根据workingnote的widget类型大小设置intent中映射的类
intent.setClass(this, NoteWidgetProvider_2x.class);
} else if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_4X) {//如果是4倍大小
intent.setClass(this, NoteWidgetProvider_4x.class);
} else {
Log.e(TAG, "Unspported widget type");//Log输出error信息不支持的widget类型
return;
}
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {//将桌面挂件的标识作为附加信息添加到Intent中
mWorkingNote.getWidgetId()//以广播形式发送intent
});
sendBroadcast(intent);//把intent信息广播发送
setResult(RESULT_OK, intent);//设置当前Activity结束后将结束信息发送给其父活动
}
public void onClick(View v) {//当点击事件发生时执行该方法
int id = v.getId();//获取到点击事件的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);//获取字号
mSharedPrefs.edit().putInt(PREFERENCE_FONT_SIZE, mFontSizeId).commit();//将共享设置中的字体进行修改
findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);//将字体设置设为可见
if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {//如果workingNote模式为核对列表模式
getWorkingText();//.获取到正在编辑的文本
switchToListMode(mWorkingNote.getContent());//将便签内容显示切换到列表模式
} else {
mNoteEditor.setTextAppearance(this,
TextAppearanceResources.getTexAppearanceResource(mFontSizeId));//如果不是check模式则设置文字编辑器中文字为相应字体大小
}
mFontSizeSelector.setVisibility(View.GONE);//最后将文字大小选择器设置为不可见
}
}
@Override
public void onBackPressed() {//点击返回键时的操作
if(clearSettingState()) {//如果无界面打开,则直接返回,否则关闭再返回
return;
}
saveNote();//保存便签
super.onBackPressed();
}
private boolean clearSettingState() {//清除设置状态
if (mNoteBgColorSelector.getVisibility() == View.VISIBLE) {
mNoteBgColorSelector.setVisibility(View.GONE);//如果背景色选择器可见,设置为不可见
return true;
} else if (mFontSizeSelector.getVisibility() == View.VISIBLE) {
mFontSizeSelector.setVisibility(View.GONE);//如果文字大小选择器可见,则将其设置为不可见
return true;
}
return false;
}
public void onBackgroundColorChanged() {//背景颜色改变
findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
View.VISIBLE);//通过workingnote对象中存储的背景色id从预定义哈希表中找到对应项设置为可见
mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());//根据workingNote的背景颜色资源id设置便签编辑器的背景资源
mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());//将便签头的背景资源设置为标题的背景色
}
@Override
public boolean onPrepareOptionsMenu(Menu menu) {//对选择菜单的准备
if (isFinishing()) {//如果窗口正在关闭,则不做处理
return true;
}
clearSettingState();//清除设置状态
menu.clear();//清除菜单项
if (mWorkingNote.getFolderId() == Notes.ID_CALL_RECORD_FOLDER) {//如果便签所在的文件夹为便签的通话记录文件夹
getMenuInflater().inflate(R.menu.call_note_edit, menu);//MenuInflater是用来实例化Menu目录下的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 {//如果workingNote对象中没有时钟提醒事项则把删除提醒的菜单选项设置为不可见
menu.findItem(R.id.menu_delete_remind).setVisible(false);
}
return 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);//通过id找到相应字体的大小
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());//用sendto函数将运行文本发送到遍历的本文内
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);
break;
default:
break;
}
return true;
}
private void setReminder() {//建立事件提醒器
DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis());//建立修改时间日期的对话框
d.setOnDateTimeSetListener(new OnDateTimeSetListener() {//置日期时间设定的监听器
public void OnDateTimeSet(AlertDialog dialog, long date) {//设置日期提醒
mWorkingNote.setAlertDate(date , true);//设置提醒时间
}
});
d.show();//显示该控件
}
/**
* 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);//将需要传递的便签信息放入text文件中
intent.setType("text/plain");//编辑连接器的类型
context.startActivity(intent);//使用context启动intent对应的活动
}
private void createNewNote() {//创建新的便签
// Firstly, save current editing notes
saveNote();//保存已有便签
// For safety, start a new NoteEditActivity
finish();
Intent intent = new Intent(this, NoteEditActivity.class);//设置一个新的便签活动编辑器
intent.setAction(Intent.ACTION_INSERT_OR_EDIT);//将当前活动设置为插入或者编辑
intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mWorkingNote.getFolderId());//将运行便签的ID添加到Intent中
startActivity(intent);//开始activity并链接
}
private void deleteCurrentNote() {//删除当前的便签
if (mWorkingNote.existInDatabase()) {//判断便签是否在数据库中
HashSet<Long> ids = new HashSet<Long>();
long id = mWorkingNote.getNoteId();//获取当前便签的id
if (id != Notes.ID_ROOT_FOLDER) {//如果不是头文件夹建立一个hash表把便签id存起来
ids.add(id);
} else {//否则输出错误
Log.d(TAG, "Wrong note id, should not happen");
}
if (!isSyncMode()) {//在非同步模式情况下
if (!DataUtils.batchDeleteNotes(getContentResolver(), ids)) {//使用DataUtils的批量删除便签将ids中的所有便签删除
Log.e(TAG, "Delete Note error");//删除操作
}
} else {
if (!DataUtils.batchMoveToFolder(getContentResolver(), ids, Notes.ID_TRASH_FOLER)) {//如果是同步模式则将ids中的便签批量移动到“垃圾”文件夹。
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;//返回同步的用户名长度如果大于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) {//若当前编辑的便签的id>0
Intent intent = new Intent(this, AlarmReceiver.class);//新建一个intent指向活动AlarmReceiver
intent.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mWorkingNote.getNoteId()));//若有运行的便签就将便签的ID放置在URI中去
PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0, intent, 0);//设置延迟触发Intent
AlarmManager alarmManager = ((AlarmManager) getSystemService(ALARM_SERVICE));//获得闹钟服务
showAlertHeader();//设置提醒管理器
if(!set) {
alarmManager.cancel(pendingIntent);//如果没有确定设置提醒 ,则闹钟管理器取消该提醒
} else {
alarmManager.set(AlarmManager.RTC_WAKEUP, date, pendingIntent);//将提醒时间、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");//如果便签id不存在输出error信息
showToast(R.string.error_note_empty_for_clock);//显示消息提示框,为未编辑的便签设置闹钟
}
}
public void onWidgetChanged() {
updateWidget();
}//当widget变化时执行更新widget这个函数
public void onEditTextDelete(int index, String text) {//删除编辑的文本框所出发的事件
int childCount = mEditTextList.getChildCount();//获取EditText列表里EditText项的数量
if (childCount == 1) {
return;//如果EditText项数为1不做操作返回
}
for (int i = index + 1; i < childCount; i++) {//修改删除文本之后的Index
((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text))//通过id把编辑框存在便签编辑框中
.setIndex(i - 1);
}
mEditTextList.removeViewAt(index);//移除特定位置的视图
NoteEditText edit = null;
if(index == 0) {////如果index为0则将edit定位到第一个EditText项
edit = (NoteEditText) mEditTextList.getChildAt(0).findViewById(
R.id.et_edit_text);
} else {//通过id把编辑框存在空的NoteEditText中
edit = (NoteEditText) mEditTextList.getChildAt(index - 1).findViewById(
R.id.et_edit_text);
}
int length = edit.length();//获取edit的长度
edit.append(text);//将后面的文本加入到edit中
edit.requestFocus();//请求优先完成该此编辑
edit.setSelection(length);//定位到length位置处的条目
}
public void onEditTextEnter(int index, String 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);//根据文本和index获取到列表项的view
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++) {//遍历子文本框并设置对应对下标
((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text))
.setIndex(i);
}
}
private void switchToListMode(String text) {//切换至列表模式
mEditTextList.removeAllViews();//移除所有子视图
String[] items = text.split("\n");//根据换行符分割字符串
int index = 0;//清空所有视图,初始化下标
for (String item : items) {//遍历所有文本单元并添加到文本列表中
if(!TextUtils.isEmpty(item)) {//如果item不是空的
mEditTextList.addView(getListItem(item, index));//添加新的视图
index++;
}
}
mEditTextList.addView(getListItem("", index));//添加最后一行的相关标签
mEditTextList.getChildAt(index).findViewById(R.id.et_edit_text).requestFocus();//获取当前列表项焦点
mNoteEditor.setVisibility(View.GONE);//便签编辑器不可见
mEditTextList.setVisibility(View.VISIBLE);//将文本编辑框置为可见
}
private Spannable getHighlightQueryResult(String fullText, String userQuery) {//获取高亮效果的反馈情况
SpannableString spannable = new SpannableString(fullText == null ? "" : fullText);//新建一个效果选项
if (!TextUtils.isEmpty(userQuery)) {//如果搜索结果不为空
mPattern = Pattern.compile(userQuery);//将用户的请求编译为正则表达式
Matcher m = mPattern.matcher(fullText);//建立一个状态机检查pattern并进行匹配
int start = 0;//初始化start
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) {//如果CheckBox已勾选
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);//选择框设置为true
edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG);
item = item.substring(TAG_CHECKED.length(), item.length()).trim();//去掉TAG_CHECKED和空格
} else if (item.startsWith(TAG_UNCHECKED)) {//选择不勾选
cb.setChecked(false);//设置为false
edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG);//绘画
item = item.substring(TAG_UNCHECKED.length(), item.length()).trim();//去掉unchecked与空格
}
edit.setOnTextViewChangeListener(this);//监听文本视图的变化
edit.setIndex(index);//运行编辑框的监听器对该行为作出反应,并设置下标及文本内容
edit.setText(getHighlightQueryResult(item, mUserQuery));//设置用户输入为高亮
return view;
}
public void onTextChange(int index, boolean hasText) {//便签内容发生改变
if (index >= mEditTextList.getChildCount()) {//index超出EditText列表项数
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()) {//如果未获取到workingText
mWorkingNote.setWorkingText(mWorkingNote.getContent().replace(TAG_UNCHECKED + " ",
""));//设置工作文本
}
mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));//设置高亮文本
mEditTextList.setVisibility(View.GONE);//便签文本列表设置为不可见
mNoteEditor.setVisibility(View.VISIBLE);//便签编辑器设置为可见
}
}
private boolean getWorkingText() {//得到工作文本
boolean hasChecked = false;//初始化check的标记
if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {//判断是否是清单模式
StringBuilder sb = new StringBuilder();//创建可变字符串
for (int i = 0; i < mEditTextList.getChildCount(); i++) {//for循环遍历EditTextList的项
View view = mEditTextList.getChildAt(i);//获取当前文本编辑列表的第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");//扩展字符串为已打钩并把标记置true
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);//代表是通过编辑的方式打开便签,而非新建便签
}
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 shortcutIntent = new Intent(this, NoteEditActivity.class);//从当前活动跳转到编辑便签页面NoteEditActivity
shortcutIntent.setAction(Intent.ACTION_VIEW);//链接内容为一个视图
shortcutIntent.putExtra(Intent.EXTRA_UID, mWorkingNote.getNoteId());//将便签的相关信息都添加到要发送的文件里
sender.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent);//将shortcut的图标标题存入sender中
sender.putExtra(Intent.EXTRA_SHORTCUT_NAME,
makeShortcutIconTitle(mWorkingNote.getContent()));//设置图标
sender.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,
Intent.ShortcutIconResource.fromContext(this, R.drawable.icon_app));//将便签的相关信息都添加到要发送的文件里
sender.putExtra("duplicate", true);
sender.setAction("com.android.launcher.action.INSTALL_SHORTCUT");//设置sneder的行为是发送
showToast(R.string.info_note_enter_desktop);//显示消息提示框表示文本已经增加到home中
sendBroadcast(sender);//显示到桌面
} else {//如果便签的id错误则保存提醒用户
/**
* 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;//直接设置为content中的内容并返回有勾选和未勾选2种
}
private void showToast(int resId) {
showToast(resId, Toast.LENGTH_SHORT);
}//显示提示的视图
private void showToast(int resId, int duration) {//持续显示提示的视图
Toast.makeText(this, resId, duration).show();//设置toast消息的文本内容
}
}

@ -0,0 +1,216 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.ui;//导入ui包
import android.content.Context;//环境内容
import android.graphics.Rect;//图形
import android.text.Layout;//文本布局
import android.text.Selection;//文本选择
import android.text.Spanned;
import android.text.TextUtils;//文本单元
import android.text.style.URLSpan;//URL格式
import android.util.AttributeSet;// 属性,特征
import android.util.Log;//日志
import android.view.ContextMenu;//菜单内容视图
import android.view.KeyEvent;//关键事件
import android.view.MenuItem;//菜单选项
import android.view.MenuItem.OnMenuItemClickListener;//菜单点击监听器
import android.view.MotionEvent;//动作事件
import android.widget.EditText;//编辑文本
import net.micode.notes.R;
import java.util.HashMap;
import java.util.Map;
public class NoteEditText extends EditText {//继承edittext设置便签设置文本框
private static final String TAG = "NoteEditText";//标志为字符串"NoteEditText"
private int mIndex;//建立字符整型的HASH表用于进行电话、网站、邮箱的链接
private int mSelectionStartBeforeDelete;//声明整型变量,获取删除文本前的位置
private static final String SCHEME_TEL = "tel:" ;//文本中电话号码内容
private static final String SCHEME_HTTP = "http:" ;//文本中网页内容
private static final String SCHEME_EMAIL = "mailto:" ;//文本中邮件内容
private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();//设置映射,将文本内容(电话、网址、邮件)做链接处理
static {//在NoteEditActivity中删除或增添文本的操作
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
*/
public interface OnTextViewChangeListener {//实现对TextView组件中的文字信息进行修改
/**
* Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens
* and the text is null
*/
void onEditTextDelete(int index, String text);//当触发删除文本KeyEvent时删除文本
/**
* Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER}
* happen
*/
void onEditTextEnter(int index, String text);//处理进入按键时的操作
/**
* Hide or show item option when text change
*/
void onTextChange(int index, boolean hasText);//文字更改时隐藏或显示项目选项
}
private OnTextViewChangeListener mOnTextViewChangeListener;//声明文本视图变化监听器
public NoteEditText(Context context) {//根据context设置文本
super(context, null);//用super引用父类变量
mIndex = 0;//设置当前光标
}
public void setIndex(int index) {
mIndex = index;
}//初始化文本修改标记
public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {//设置一个文本改变的监听器
mOnTextViewChangeListener = listener;//设置文本视图变化监听器
}
public NoteEditText(Context context, AttributeSet attrs) {//初始化便签
super(context, attrs, android.R.attr.editTextStyle);//第三个参数就是xml文件的资源编辑风格
}
public NoteEditText(Context context, AttributeSet attrs, int defStyle) {//根据defstyle自动初始化
super(context, attrs, defStyle);
// TODO Auto-generated constructor stub
}
@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();//layout布局控件设置新的位置
int line = layout.getLineForVertical(y);//获取纵向的行数
int off = layout.getOffsetForHorizontal(line, x);//获得横向的偏移量
Selection.setSelection(getText(), off);//定位光标的位置
break;
}
return super.onTouchEvent(event);//继续调用父类的监听事件方法
}
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {//处理用户按下一个键盘按键时会触发的事件
switch (keyCode) {//根据按键的KeyCode来处理
case KeyEvent.KEYCODE_ENTER://根据按键的 Unicode 编码值来处理
if (mOnTextViewChangeListener != null) {//进入键
return false;//返回false
}
break;
case KeyEvent.KEYCODE_DEL://按下删除时设置了光标位置
mSelectionStartBeforeDelete = getSelectionStart();//获取删除文本的开始位置
break;
default://其他情况,我们返回父类的onKeyDown值
break;
}
return super.onKeyDown(keyCode, event);//父类其他键盘事件
}
@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {//当用户松开按键瞬间系统的响应
switch(keyCode) {//据按键的 Unicode 编码值来处理有删除和进入2种操作根
case KeyEvent.KEYCODE_DEL://抬起删除键
if (mOnTextViewChangeListener != null) {//如果文本视图发生变化
if (0 == mSelectionStartBeforeDelete && mIndex != 0) {//如果文本视图发生变化
mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());//监听文本的删除
return true;
}
} else {
Log.d(TAG, "OnTextViewChangeListener was not seted");//其他情况报错,文档的改动监听器并没有建立
}
break;
case KeyEvent.KEYCODE_ENTER://抬起回车键
if (mOnTextViewChangeListener != null) {//如果文本视图发生变化
int selectionStart = getSelectionStart();//获取当前位置
String text = getText().subSequence(selectionStart, length()).toString();//获取当前文本
setText(getText().subSequence(0, selectionStart));//根据获取的文本设置当前文本
mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text);//将选择区域内的文字移到下一行
} else {
Log.d(TAG, "OnTextViewChangeListener was not seted");//其他情况报错,文档的改动监听器并没有建立
}
break;
default:
break;
}
return super.onKeyUp(keyCode, event);//继续执行父类的其他按键弹起的事件
}
@Override
protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {//规定了编辑文本焦点改变时的系统响应
if (mOnTextViewChangeListener != null) {//若监听器已经建立
if (!focused && TextUtils.isEmpty(getText())) {//获取焦点文本不为空
mOnTextViewChangeListener.onTextChange(mIndex, false);//置false隐藏事件选项
} else {
mOnTextViewChangeListener.onTextChange(mIndex, true);//置true显示事件选项
}
}
super.onFocusChanged(focused, direction, previouslyFocusedRect);//置true显示事件选项
}
@Override
protected void onCreateContextMenu(ContextMenu menu) {//定义了新建文本菜单的过程
if (getText() instanceof Spanned) {//有文本存在
int selStart = getSelectionStart();//获取文本开始结尾位置
int selEnd = getSelectionEnd();//获取文本开始和结尾位置
int min = Math.min(selStart, selEnd);//获取开始到结尾的最小值
int max = Math.max(selStart, selEnd);//开始到结尾的最大值
final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);//设置url的信息的范围值
if (urls.length == 1) {//设置url的信息的范围值
int defaultResId = 0;//默认的资源ID值为0
for(String schema: sSchemaActionResMap.keySet()) {//获取计划表中所有的key值
if(urls[0].getURL().indexOf(schema) >= 0) {//若url可以添加则在添加后将defaultResId置为key所映射的值
defaultResId = sSchemaActionResMap.get(schema);//若url可以添加则在添加后将defaultResId置为key所映射的值
break;
}
}
if (defaultResId == 0) {//defaultResId == 0则说明url并没有添加任何东西所以置为打开map的值
defaultResId = R.string.note_link_other;
}
menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener(//建立菜单
new OnMenuItemClickListener() {//实例化菜单监听器
public boolean onMenuItemClick(MenuItem item) {
// goto a new intent
urls[0].onClick(NoteEditText.this);//根据相应的文本设置菜单的按键
return true;
}
});
}
}
super.onCreateContextMenu(menu);//创建文本菜单
}
}
Loading…
Cancel
Save