AndroidAnnotations——Handling options menu处理选项菜单

Handling options menu

Since AndroidAnnotations 2.2

You can easily add options menu support in your activities, with the @OptionsMenu and@OptionsItem annotations.

你可以使用 @OptionsMenu 和@OptionsItem 注解更方便地为你的activities添加选项菜单支持。

• @OptionsMenu lets you specify the menu resource to use
• @OptionsMenu  让你指定要使用的menu资源
• @OptionsItem marks methods that receives menu selection events
• @OptionsItem  标记接收菜单选择事件的方法。

Both annotations can be used independently.两个注解都可以独立使用。

Here is a simple example on how to use them:下面是一个简单的例子：

@EActivity@OptionsMenu(R.menu.my_menu)public class MyActivity extends Activity {        @OptionMenuItem        MenuItem menuSearch;        @OptionsItem(R.id.menuShare)        void myMethod() {          // You can specify the ID in the annotation, or use the naming convention        }        @OptionsItem        void homeSelected() {          // home was selected in the action bar          // The "Selected" keyword is optional        }        @OptionsItem        boolean menuSearch() {          menuSearch.setVisible(false);          // menuSearch was selected          // the return type may be void or boolean (false to allow normal menu processing to proceed, true to consume it here)          return true;        }        @OptionsItem({ R.id.menu_search, R.id.menu_delete })        void multipleMenuItems() {          // You can specify multiple menu item IDs in @OptionsItem        }        @OptionsItem        void menu_add(MenuItem item) {          // You can add a MenuItem parameter to access it        }}

Injecting Menu items

Since AndroidAnnotations 3.0

@OptionMenuItem can be used to inject a MenuItem in an attribute.@OptionMenuItem 用来注入一个菜单项到属性中。

Be careful : Injected menu items can't be used in @AfterInject nor @AfterViews annotated methods, because of Android activity lifecycle. More information are available here. 注意：因为Android activity的生命周期，注入菜单项不可以使用或者注解方法。更多信息请看这里。

Multiple Options Menu

Since AndroidAnnotations 2.7

You can combine multiple xml menus with @OptionsMenu:你使用 @OptionsMenu注解可以组合多个xml菜单：

@EActivity@OptionsMenu({R.menu.my_menu1, R.menu.my_menu2})public class MyActivity extends Activity {}

Fragment support

Since AndroidAnnotations 2.7

You can also use @OptionsMenu and @OptionsItem in Fragments:你也可以在Fragments中使用@OptionsMenu 和@OptionsItem ：

@EFragment@OptionsMenu(R.menu.my_fragment_menu)public class MyFragment extends Fragment {        @OptionsItem        void menuRefreshSelected() {        }        }