/*
 * 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.
 */

// NoteWidgetProvider_2x.java - 2x2便签小部件提供者
// 主要功能：实现2x2尺寸便签小部件的具体逻辑
package net.micode.notes.widget;

// ======================= 导入区域 =======================
// Android小部件
import android.appwidget.AppWidgetManager;  // 小部件管理器
// Android基础
import android.content.Context;             // 上下文

// 应用内部资源
import net.micode.notes.R;                  // 资源文件R类
// 应用数据模型
import net.micode.notes.data.Notes;         // Notes主类
// 应用资源解析
import net.micode.notes.tool.ResourceParser;  // 资源解析器

// ======================= 2x2便签小部件提供者 =======================
/**
 * NoteWidgetProvider_2x - 2x2便签小部件提供者
 * 继承自NoteWidgetProvider抽象基类
 * 功能：实现2x2尺寸便签小部件的具体逻辑
 * 尺寸：2x2单元格（通常为2行2列）
 * 布局：widget_2x.xml
 */
public class NoteWidgetProvider_2x extends NoteWidgetProvider {

    // ======================= 小部件生命周期方法 =======================

    /**
     * 小部件更新回调
     * 当小部件需要更新时调用，包括创建、定时更新、配置变更等
     * 实现：调用父类的update()方法
     *
     * @param context 上下文
     * @param appWidgetManager 小部件管理器
     * @param appWidgetIds 需要更新的小部件ID数组
     */
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        // 调用父类的update()方法执行通用更新逻辑
        super.update(context, appWidgetManager, appWidgetIds);
    }

    // ======================= 抽象方法实现 =======================

    /**
     * 获取布局ID
     * 返回2x2小部件使用的布局资源ID
     * 布局文件：R.layout.widget_2x
     *
     * @return 2x2小部件布局资源ID
     */
    @Override
    protected int getLayoutId() {
        return R.layout.widget_2x;
    }

    /**
     * 获取背景资源ID
     * 将背景颜色ID映射到2x2小部件的实际Drawable资源ID
     * 通过ResourceParser.WidgetBgResources获取对应资源
     *
     * @param bgId 背景颜色ID
     * @return 2x2小部件背景Drawable资源ID
     */
    @Override
    protected int getBgResourceId(int bgId) {
        return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
    }

    /**
     * 获取小部件类型
     * 返回2x2小部件的类型常量
     * 类型常量定义在Notes类中
     *
     * @return 小部件类型：Notes.TYPE_WIDGET_2X
     */
    @Override
    protected int getWidgetType() {
        return Notes.TYPE_WIDGET_2X;
    }
}