diff --git a/NoteWidgetProvider_2x.java b/NoteWidgetProvider_2x.java index fde2df2..9a547d2 100644 --- a/NoteWidgetProvider_2x.java +++ b/NoteWidgetProvider_2x.java @@ -7,60 +7,70 @@ * 代码开始 */ +// 定义包名,组织代码模块化管理 package net.micode.notes.widget; +// 导入Android小部件相关类和应用的资源类 import android.appwidget.AppWidgetManager; import android.content.Context; -import net.micode.notes.R; -import net.micode.notes.data.Notes; -import net.micode.notes.tool.ResourceParser; +import net.micode.notes.R; // 导入资源文件R类,用于访问布局和其他资源 +import net.micode.notes.data.Notes; // 导入笔记相关的数据类 +import net.micode.notes.tool.ResourceParser; // 导入资源解析工具类 /** - * 2x版本的NoteWidgetProvider,负责处理2x大小的小部件更新和其他操作。 + * 2x版本的小部件提供者类。 + * 该类继承自 NoteWidgetProvider,专门处理 2x2 尺寸的笔记小部件。 */ public class NoteWidgetProvider_2x extends NoteWidgetProvider { /** - * 当小部件需要更新时调用此方法。 + * 当系统需要更新小部件时,会调用此方法。 + * 此方法通过调用父类的 `update` 方法来处理小部件更新的逻辑。 * - * @param context 上下文环境,用于访问应用全局功能。 - * @param appWidgetManager 管理当前应用中所有小部件的AppWidgetManager实例。 - * @param appWidgetIds 当前需要更新的小部件ID数组。 + * @param context 上下文环境,用于获取应用程序资源和操作。 + * @param appWidgetManager 管理当前应用中所有小部件的 AppWidgetManager 实例。 + * @param appWidgetIds 当前需要更新的小部件 ID 数组。 */ @Override public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { + // 调用父类的 update 方法,完成小部件的更新逻辑 super.update(context, appWidgetManager, appWidgetIds); } /** - * 获取小部件布局的ID。 + * 获取小部件布局的资源 ID。 + * 此方法返回当前小部件所使用的布局文件的资源 ID。 + * 该布局文件定义了小部件在屏幕上的外观。 * - * @return 布局资源ID。 + * @return 布局资源的 ID,对应 `res/layout/widget_2x.xml` 文件。 */ @Override protected int getLayoutId() { - return R.layout.widget_2x; + return R.layout.widget_2x; // 返回 2x 小部件的布局资源 ID } /** - * 根据背景ID获取对应的背景资源ID。 + * 根据背景 ID 获取对应的背景资源 ID。 + * 小部件有不同的背景样式(如不同颜色或主题),通过背景 ID 选择对应的资源。 * - * @param bgId 背景资源的索引ID。 - * @return 背景资源的ID。 + * @param bgId 背景资源的索引 ID,表示选择哪一种背景样式。 + * @return 背景资源的 ID,用于设置小部件的背景。 */ @Override protected int getBgResourceId(int bgId) { + // 使用 ResourceParser 工具类,根据背景 ID 获取 2x 小部件的背景资源 ID return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId); } /** - * 获取小部件的类型。 + * 获取当前小部件的类型。 + * 该方法返回一个常量,用于标识当前小部件的类型。 + * 不同尺寸的小部件有不同的类型常量,例如 2x 和 4x 小部件。 * - * @return 小部件类型的常量。 + * @return 小部件类型的常量值,表示当前为 2x 尺寸的小部件。 */ @Override protected int getWidgetType() { - return Notes.TYPE_WIDGET_2X; + return Notes.TYPE_WIDGET_2X; // 返回表示 2x 小部件类型的常量 } } -