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

/**
 * 文件: DropdownMenu.java
 * 描述: 下拉菜单组件
 * 作用: 提供一个基于按钮和弹出菜单的下拉菜单组件
 * 功能:
 *   1. 将按钮与弹出菜单关联，点击按钮显示菜单
 *   2. 支持设置菜单项点击监听器
 *   3. 支持查找特定菜单项
 *   4. 支持设置按钮标题
 */
package net.micode.notes.ui;

import android.content.Context;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.PopupMenu;
import android.widget.PopupMenu.OnMenuItemClickListener;

import net.micode.notes.R;

/**
 * 下拉菜单组件类
 * 
 * 这个类封装了一个基于按钮和PopupMenu的下拉菜单组件。
 * 用户点击按钮时，会显示一个下拉菜单，用户可以从中选择选项。
 * 组件支持设置菜单项点击监听器，以及查找特定菜单项和设置按钮标题。
 */
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 = button;
        // 设置按钮的背景为下拉图标
        mButton.setBackgroundResource(R.drawable.dropdown_icon);
        
        // 创建弹出菜单，并与按钮关联
        mPopupMenu = new PopupMenu(context, mButton);
        // 获取菜单对象
        mMenu = mPopupMenu.getMenu();
        // 从资源文件中加载菜单项
        mPopupMenu.getMenuInflater().inflate(menuId, mMenu);
        
        // 设置按钮点击监听器，点击时显示菜单
        mButton.setOnClickListener(new OnClickListener() {
            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) {
        return mMenu.findItem(id);
    }

    /**
     * 设置按钮标题文本
     * 
     * @param title 要设置的标题文本
     */
    public void setTitle(CharSequence title) {
        mButton.setText(title);
    }
}