/*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package net.micode.notes.widget;

import android.appwidget.AppWidgetManager;
import android.content.Context;

import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.ResourceParser;

/**
 * 4x4尺寸便签小部件提供者
 * 继承自NoteWidgetProvider抽象基类，实现4x4大尺寸小部件的具体行为
 * 负责管理桌面4x4网格尺寸的便签小部件显示和交互，提供更大的显示区域
 */
public class NoteWidgetProvider_4x extends NoteWidgetProvider {

    /**
     * 小部件更新回调方法
     * 当小部件需要更新显示内容时调用，复用父类的通用更新逻辑
     * 4x4小部件使用与2x2相同的更新机制，但显示布局和背景资源不同
     *
     * @param context 上下文对象，用于访问应用资源和服务
     * @param appWidgetManager 小部件管理器实例，用于执行小部件更新操作
     * @param appWidgetIds 需要更新的小部件ID数组，支持批量更新多个小部件实例
     */
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        // 直接调用父类的通用更新逻辑，避免代码重复
        // 父类已实现数据查询、界面绑定、点击事件等完整的小部件更新流程
        super.update(context, appWidgetManager, appWidgetIds);
    }

    /**
     * 获取4x4小部件专用布局资源ID
     * 实现抽象方法，返回针对4x4网格尺寸优化的布局文件
     * 4x4布局相比2x2具有更大的显示区域，可以展示更多内容
     *
     * @return 4x4小部件的布局资源ID，定义在R.layout.widget_4x中
     */
    @Override
    protected int getLayoutId() {
        // 返回4x4尺寸专用的布局文件
        // 该布局针对4x4网格进行了优化，可能包含更大的文本区域或额外的显示元素
        return R.layout.widget_4x;
    }

    /**
     * 根据背景颜色ID获取4x4小部件的背景资源ID
     * 实现抽象方法，提供4x4尺寸专用的背景图片映射
     * 4x4背景图片在尺寸和比例上与2x2不同，适配更大的显示区域
     *
     * @param bgId 背景颜色ID（Notes.COLOR_YELLOW, Notes.COLOR_BLUE等颜色常量）
     * @return 对应颜色的4x4小部件背景图片资源ID
     */
    @Override
    protected int getBgResourceId(int bgId) {
        // 通过资源解析器获取4x4尺寸专用的背景图片资源
        // ResourceParser.WidgetBgResources.getWidget4xBgResource()专门处理4x4尺寸的背景映射
        return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);
    }

    /**
     * 获取小部件类型标识符
     * 实现抽象方法，返回4x4小部件的唯一类型常量
     * 该标识符用于在数据库和Intent中区分不同尺寸的小部件
     *
     * @return 4x4小部件的类型标识符，值为Notes.TYPE_WIDGET_4X
     */
    @Override
    protected int getWidgetType() {
        // 返回4x4小部件的类型常量
        // 这个值会存储在数据库中，用于关联便签数据和小部件实例
        return Notes.TYPE_WIDGET_4X;
    }
}