/*
 * 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
 * 描述: 2x尺寸便签小部件提供者实现类
 * 作用: 提供2x尺寸的便签小部件功能，继承自NoteWidgetProvider基类
 */
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;

/**
 * 2x尺寸便签小部件提供者类
 * 
 * 该类继承自NoteWidgetProvider，实现了2x尺寸便签小部件的具体功能。
 * 2x尺寸是指Android桌面网格中占用2x2个单元格的小部件。
 */
public class NoteWidgetProvider_2x extends NoteWidgetProvider {
    /**
     * 当小部件更新时调用
     * 
     * 系统会在小部件添加到桌面、系统启动或其他需要更新小部件时调用此方法
     * 
     * @param context 上下文环境
     * @param appWidgetManager 小部件管理器
     * @param appWidgetIds 需要更新的小部件ID数组
     */
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        // 调用父类的update方法更新小部件
        super.update(context, appWidgetManager, appWidgetIds);
    }

    /**
     * 获取小部件布局资源ID
     * 
     * 实现父类的抽象方法，提供2x尺寸小部件的布局资源
     * 
     * @return 2x小部件布局资源ID
     */
    @Override
    protected int getLayoutId() {
        return R.layout.widget_2x;
    }

    /**
     * 获取小部件背景资源ID
     * 
     * 实现父类的抽象方法，根据背景颜色ID获取对应的2x尺寸小部件背景资源
     * 
     * @param bgId 背景颜色ID
     * @return 对应的2x小部件背景资源ID
     */
    @Override
    protected int getBgResourceId(int bgId) {
        // 使用ResourceParser工具类获取2x小部件的背景资源
        return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
    }

    /**
     * 获取小部件类型
     * 
     * 实现父类的抽象方法，提供2x小部件的类型标识
     * 
     * @return 2x小部件类型常量
     */
    @Override
    protected int getWidgetType() {
        return Notes.TYPE_WIDGET_2X;
    }
}