ui/DropdownMenu

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);
     }
+
 }