ui-菜单点击监听器注释

src/Notes-master/src/net/micode/notes/ui/DropdownMenu.java

@@ -27,17 +27,31 @@ import android.widget.PopupMenu.OnMenuItemClickListener;
 
 import net.micode.notes.R;
 
+/**
+ * 下拉菜单控件类，用于在按钮上显示一个弹出式菜单
+ */
 public class DropdownMenu {
-    private Button mButton;
+    private Button mButton;          // 触发下拉菜单的按钮
-    private PopupMenu mPopupMenu;
+    private PopupMenu mPopupMenu;    // 弹出菜单对象
-    private Menu mMenu;
+    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();
@@ -45,16 +59,29 @@ public class DropdownMenu {
         });
     }
 
+    /**
+     * 设置菜单项点击监听器
+     * @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);
     }