diff --git a/java/net/micode/notes/ui/DropdownMenu.java b/java/net/micode/notes/ui/DropdownMenu.java index 613dc74..963f751 100644 --- a/java/net/micode/notes/ui/DropdownMenu.java +++ b/java/net/micode/notes/ui/DropdownMenu.java @@ -27,17 +27,46 @@ import android.widget.PopupMenu.OnMenuItemClickListener; import net.micode.notes.R; +/** + * 封装 PopupMenu 的下拉菜单控件。 + * + * 提供一个按钮触发的下拉菜单功能,用于简化菜单操作流程。 + */ public class DropdownMenu { + + // 下拉菜单绑定的按钮控件 private Button mButton; + + // Android 原生 PopupMenu 实例 private PopupMenu mPopupMenu; + + // 菜单对象,用于操作菜单项 private Menu mMenu; + + /** + * 构造函数:初始化下拉菜单。 + * + * @param context 上下文环境 + * @param button 绑定的按钮控件,点击该按钮弹出菜单 + * @param menuId 菜单资源ID(如 R.menu.xxx) + */ public DropdownMenu(Context context, Button button, int menuId) { mButton = button; + + // 设置按钮背景为下拉图标 mButton.setBackgroundResource(R.drawable.dropdown_icon); + + // 创建 PopupMenu 实例 mPopupMenu = new PopupMenu(context, mButton); + + // 获取菜单对象 mMenu = mPopupMenu.getMenu(); + + // 使用菜单资源填充 PopupMenu mPopupMenu.getMenuInflater().inflate(menuId, mMenu); + + // 设置按钮点击事件,点击时显示菜单 mButton.setOnClickListener(new OnClickListener() { public void onClick(View v) { mPopupMenu.show(); @@ -45,17 +74,34 @@ public class DropdownMenu { }); } + /** + * 设置菜单项点击监听器。 + * + * @param listener 监听器对象 + */ public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) { if (mPopupMenu != null) { mPopupMenu.setOnMenuItemClickListener(listener); } } + /** + * 根据菜单项 ID 查找对应的 MenuItem 对象。 + * + * @param id 菜单项资源 ID + * @return 返回找到的 MenuItem 对象 + */ public MenuItem findItem(int id) { return mMenu.findItem(id); } + /** + * 设置按钮显示的文本标题。 + * + * @param title 要设置的标题文本 + */ public void setTitle(CharSequence title) { mButton.setText(title); } + }