|
|
/*
|
|
|
* 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 - 下拉菜单包装类
|
|
|
// 主要功能：将Button和PopupMenu组合封装，提供简洁的下拉菜单实现
|
|
|
package net.micode.notes.ui;
|
|
|
|
|
|
// ======================= 导入区域 =======================
|
|
|
// Android上下文
|
|
|
import android.content.Context; // 上下文
|
|
|
// Android菜单相关
|
|
|
import android.view.Menu; // 菜单接口
|
|
|
import android.view.MenuItem; // 菜单项
|
|
|
// Android视图相关
|
|
|
import android.view.View; // 视图基类
|
|
|
import android.view.View.OnClickListener; // 点击监听器
|
|
|
// Android控件
|
|
|
import android.widget.Button; // 按钮控件
|
|
|
import android.widget.PopupMenu; // 弹出菜单控件
|
|
|
import android.widget.PopupMenu.OnMenuItemClickListener; // 弹出菜单项点击监听器
|
|
|
|
|
|
// 应用内部资源
|
|
|
import net.micode.notes.R; // 资源文件R类
|
|
|
|
|
|
// ======================= 下拉菜单包装类 =======================
|
|
|
/**
|
|
|
* DropdownMenu - 下拉菜单包装类
|
|
|
* 功能：将Button控件与PopupMenu组合，创建下拉菜单效果
|
|
|
* 使用方式：将Button转换为下拉菜单按钮，点击显示菜单
|
|
|
* 设计模式：外观模式（Facade），简化PopupMenu的使用
|
|
|
*/
|
|
|
public class DropdownMenu {
|
|
|
|
|
|
// ======================= 成员变量 =======================
|
|
|
|
|
|
/** 按钮控件 - 显示为下拉菜单的触发器按钮 */
|
|
|
private Button mButton;
|
|
|
|
|
|
/** 弹出菜单 - 实际的PopupMenu控件，包含菜单项 */
|
|
|
private PopupMenu mPopupMenu;
|
|
|
|
|
|
/** 菜单对象 - 对应PopupMenu中的菜单，用于查找菜单项 */
|
|
|
private Menu mMenu;
|
|
|
|
|
|
// ======================= 构造函数 =======================
|
|
|
|
|
|
/**
|
|
|
* 构造函数
|
|
|
* 初始化下拉菜单，将普通Button转换为下拉菜单按钮
|
|
|
*
|
|
|
* 工作流程：
|
|
|
* 1. 保存Button引用
|
|
|
* 2. 设置Button背景为下拉箭头图标
|
|
|
* 3. 创建PopupMenu并关联到Button
|
|
|
* 4. 获取Menu对象
|
|
|
* 5. 加载菜单布局
|
|
|
* 6. 设置Button点击事件显示菜单
|
|
|
*
|
|
|
* @param context 上下文，用于创建PopupMenu
|
|
|
* @param button 按钮控件，将转换为下拉菜单触发器
|
|
|
* @param menuId 菜单资源ID，对应res/menu目录下的XML文件
|
|
|
*
|
|
|
* 示例：
|
|
|
* new DropdownMenu(context, button, R.menu.note_operation_menu);
|
|
|
*/
|
|
|
public DropdownMenu(Context context, Button button, int menuId) {
|
|
|
// 1. 保存Button引用
|
|
|
mButton = button;
|
|
|
|
|
|
// 2. 设置Button背景为下拉箭头图标
|
|
|
// R.drawable.dropdown_icon: 下拉箭头图标
|
|
|
// 使Button看起来像下拉菜单按钮
|
|
|
mButton.setBackgroundResource(R.drawable.dropdown_icon);
|
|
|
|
|
|
// 3. 创建PopupMenu并关联到Button
|
|
|
// 第二个参数是锚点视图，菜单会显示在Button下方
|
|
|
mPopupMenu = new PopupMenu(context, mButton);
|
|
|
|
|
|
// 4. 获取PopupMenu的Menu对象
|
|
|
mMenu = mPopupMenu.getMenu();
|
|
|
|
|
|
// 5. 加载菜单布局文件
|
|
|
// 从XML资源文件加载菜单项到Menu对象
|
|
|
mPopupMenu.getMenuInflater().inflate(menuId, mMenu);
|
|
|
|
|
|
// 6. 设置Button点击事件
|
|
|
mButton.setOnClickListener(new OnClickListener() {
|
|
|
/**
|
|
|
* Button点击事件处理
|
|
|
* 点击Button时显示弹出菜单
|
|
|
* @param v 被点击的Button视图
|
|
|
*/
|
|
|
public void onClick(View v) {
|
|
|
mPopupMenu.show(); // 显示弹出菜单
|
|
|
}
|
|
|
});
|
|
|
}
|
|
|
|
|
|
// ======================= 菜单项点击监听器设置 =======================
|
|
|
|
|
|
/**
|
|
|
* 设置下拉菜单项点击监听器
|
|
|
* 当用户点击菜单项时触发
|
|
|
*
|
|
|
* @param listener 菜单项点击监听器
|
|
|
* 实现OnMenuItemClickListener接口
|
|
|
*
|
|
|
* 使用示例：
|
|
|
* dropdownMenu.setOnDropdownMenuItemClickListener(new OnMenuItemClickListener() {
|
|
|
* @Override
|
|
|
* public boolean onMenuItemClick(MenuItem item) {
|
|
|
* // 处理菜单项点击
|
|
|
* return true;
|
|
|
* }
|
|
|
* });
|
|
|
*/
|
|
|
public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {
|
|
|
// 安全检查：确保PopupMenu已创建
|
|
|
if (mPopupMenu != null) {
|
|
|
mPopupMenu.setOnMenuItemClickListener(listener);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// ======================= 菜单项查找 =======================
|
|
|
|
|
|
/**
|
|
|
* 根据ID查找菜单项
|
|
|
* 用于动态修改菜单项属性（如启用状态、标题、图标等）
|
|
|
*
|
|
|
* @param id 菜单项资源ID
|
|
|
* @return 找到的MenuItem对象，未找到返回null
|
|
|
*
|
|
|
* 使用示例：
|
|
|
* MenuItem item = dropdownMenu.findItem(R.id.menu_delete);
|
|
|
* if (item != null) {
|
|
|
* item.setEnabled(false); // 禁用删除菜单项
|
|
|
* }
|
|
|
*/
|
|
|
public MenuItem findItem(int id) {
|
|
|
return mMenu.findItem(id);
|
|
|
}
|
|
|
|
|
|
// ======================= 按钮标题设置 =======================
|
|
|
|
|
|
/**
|
|
|
* 设置按钮标题文本
|
|
|
* 用于动态更新下拉按钮显示的文字
|
|
|
*
|
|
|
* @param title 按钮标题文本
|
|
|
*
|
|
|
* 使用示例：
|
|
|
* dropdownMenu.setTitle("操作菜单");
|
|
|
* 或
|
|
|
* dropdownMenu.setTitle(getString(R.string.menu_title));
|
|
|
*/
|
|
|
public void setTitle(CharSequence title) {
|
|
|
mButton.setText(title);
|
|
|
}
|
|
|
} |
