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

// 声明该类所在的包，表明该类属于 net.micode.notes.ui 模块
package net.micode.notes.ui;

// 导入 Android 上下文类，用于获取应用程序环境信息
import android.content.Context;
// 导入 Android 菜单类，用于创建和管理菜单
import android.view.Menu;
// 导入 Android 菜单项类，用于表示菜单中的每一项
import android.view.MenuItem;
// 导入 Android 视图类，是所有 UI 组件的基类
import android.view.View;
// 导入 Android 视图点击监听器接口，用于处理视图的点击事件
import android.view.View.OnClickListener;
// 导入 Android 按钮类，用于创建可点击的按钮
import android.widget.Button;
// 导入 Android 弹出菜单类，用于创建弹出式菜单
import android.widget.PopupMenu;
// 导入 Android 弹出菜单项点击监听器接口，用于处理弹出菜单项的点击事件
import android.widget.PopupMenu.OnMenuItemClickListener;

// 导入应用资源类，用于访问应用中的资源，如布局、字符串等
import net.micode.notes.R;

/**
 * DropdownMenu 类用于创建一个下拉菜单，通过点击按钮来显示弹出式菜单。
 */
public class DropdownMenu {
    // 声明一个按钮对象，用于触发下拉菜单的显示
    private Button mButton;
    // 声明一个弹出菜单对象，用于显示下拉菜单的内容
    private PopupMenu mPopupMenu;
    // 声明一个菜单对象，用于管理弹出菜单中的菜单项
    private Menu mMenu;

    /**
     * 构造函数，用于初始化下拉菜单。
     *
     * @param context 应用程序上下文，用于创建弹出菜单
     * @param button  触发下拉菜单的按钮
     * @param menuId  菜单资源的 ID，用于指定菜单的布局
     */
    public DropdownMenu(Context context, Button button, int menuId) {
        // 将传入的按钮赋值给成员变量 mButton
        mButton = button;
        // 为按钮设置背景资源，使用下拉图标
        mButton.setBackgroundResource(R.drawable.dropdown_icon);
        // 创建一个弹出菜单对象，关联到传入的按钮上
        mPopupMenu = new PopupMenu(context, mButton);
        // 获取弹出菜单的菜单对象
        mMenu = mPopupMenu.getMenu();
        // 使用菜单布局资源 ID 来填充菜单内容
        mPopupMenu.getMenuInflater().inflate(menuId, mMenu);
        // 为按钮设置点击监听器
        mButton.setOnClickListener(new OnClickListener() {
            /**
             * 当按钮被点击时，显示弹出菜单。
             *
             * @param v 被点击的视图对象
             */
            public void onClick(View v) {
                // 显示弹出菜单
                mPopupMenu.show();
            }
        });
    }

    /**
     * 设置下拉菜单项的点击监听器。
     *
     * @param listener 菜单项点击监听器
     */
    public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {
        // 检查弹出菜单对象是否不为空
        if (mPopupMenu != null) {
            // 为弹出菜单设置菜单项点击监听器
            mPopupMenu.setOnMenuItemClickListener(listener);
        }
    }

    /**
     * 根据菜单项的 ID 查找菜单项。
     *
     * @param id 菜单项的 ID
     * @return 找到的菜单项，如果未找到则返回 null
     */
    public MenuItem findItem(int id) {
        // 在菜单中查找指定 ID 的菜单项
        return mMenu.findItem(id);
    }

    /**
     * 设置按钮的标题。
     *
     * @param title 按钮的标题文本
     */
    public void setTitle(CharSequence title) {
        // 设置按钮的文本内容为传入的标题
        mButton.setText(title);
    }
}