diff --git a/src/notes/ui/AlarmAlertActivity.java b/src/notes/ui/AlarmAlertActivity.java new file mode 100644 index 0000000..aea9c89 --- /dev/null +++ b/src/notes/ui/AlarmAlertActivity.java @@ -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;//清空播放器资源 + } + } +} diff --git a/src/notes/ui/AlarmInitReceiver.java b/src/notes/ui/AlarmInitReceiver.java new file mode 100644 index 0000000..edccf4b --- /dev/null +++ b/src/notes/ui/AlarmInitReceiver.java @@ -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();//关闭游标 + } + } +} diff --git a/src/notes/ui/AlarmReceiver.java b/src/notes/ui/AlarmReceiver.java new file mode 100644 index 0000000..f5ed4f5 --- /dev/null +++ b/src/notes/ui/AlarmReceiver.java @@ -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 + } +} diff --git a/src/notes/ui/DateTimePicker.java b/src/notes/ui/DateTimePicker.java new file mode 100644 index 0000000..8199eee --- /dev/null +++ b/src/notes/ui/DateTimePicker.java @@ -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()); + } + } +} diff --git a/src/notes/ui/DateTimePickerDialog.java b/src/notes/ui/DateTimePickerDialog.java new file mode 100644 index 0000000..529d59e --- /dev/null +++ b/src/notes/ui/DateTimePickerDialog.java @@ -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()); + } + } + +} \ No newline at end of file diff --git a/src/notes/ui/DropdownMenu.java b/src/notes/ui/DropdownMenu.java new file mode 100644 index 0000000..d983983 --- /dev/null +++ b/src/notes/ui/DropdownMenu.java @@ -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); + }//根据索引搜索菜单需要的选项 +} diff --git a/src/notes/ui/FoldersListAdapter.java b/src/notes/ui/FoldersListAdapter.java new file mode 100644 index 0000000..eaab14f --- /dev/null +++ b/src/notes/ui/FoldersListAdapter.java @@ -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); + }//绑定文件夹名称 + } + +} diff --git a/src/notes/ui/NoteEditActivity.java b/src/notes/ui/NoteEditActivity.java new file mode 100644 index 0000000..bab9e9f --- /dev/null +++ b/src/notes/ui/NoteEditActivity.java @@ -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 sBgSelectorBtnsMap = new HashMap();//运用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 sBgSelectorSelectionMap = new HashMap();//实现资源解析器中的颜色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 sFontSizeBtnsMap = new HashMap();//将字体的大小与相对应的选择相连接 + 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 sFontSelectorSelectionMap = new HashMap();//实现资源解析器中字号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 ids = new HashSet(); + 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消息的文本内容 + } +} diff --git a/src/notes/ui/NoteEditText.java b/src/notes/ui/NoteEditText.java new file mode 100644 index 0000000..09e3987 --- /dev/null +++ b/src/notes/ui/NoteEditText.java @@ -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 sSchemaActionResMap = new HashMap();//设置映射，将文本内容（电话、网址、邮件）做链接处理 + 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);//创建文本菜单 + } +}