From 4fe3e53e854b0056b774bfe25e3d1a2d4841aa32 Mon Sep 17 00:00:00 2001
From: Scott Main A menu resource defines an application menu (Options Menu, Context Menu, or Sub Menu) that
+ A menu resource defines an application menu (Options Menu, Context Menu, or submenu) that
can be inflated with {@link android.view.MenuInflater}. For a guide to using menus, see the Creating
+Menus document.
Introduced in API Level HONEYCOMB.
+Introduced in API Level 11.
android:showAsAction| Value | Description |
|---|---|
ifRoom | Only place this item in the Action Bar if @@ -131,14 +134,14 @@ with other UI in the action bar. |
See Using the Action Bar for more information.
-Introduced in API Level HONEYCOMB.
+Introduced in API Level 11.
android:actionViewLayoutSee Using the Action Bar for more information.
-Introduced in API Level HONEYCOMB.
Introduced in API Level 11.
android:actionViewClassNameIntroduced in API Level HONEYCOMB.
Introduced in API Level 11.
android:alphabeticShortcutNote: The {@code android:showAsAction} attribute is -available only on Android X.X (API Level HONEYCOMB) and greater.
+available only on Android 3.0 (API Level 11) and greater. diff --git a/docs/html/guide/topics/ui/menus.jd b/docs/html/guide/topics/ui/menus.jd index d1c0ff8b481d8..984bf8fcd202a 100644 --- a/docs/html/guide/topics/ui/menus.jd +++ b/docs/html/guide/topics/ui/menus.jd @@ -7,11 +7,11 @@ parent.link=index.htmlMenus are an important part of an application that provide a familiar interface for the user -to access application functions and settings. Android offers an easy programming interface -for you to provide application menus in your application.
+Menus are an important part of an activity's user interface, which provide users a familiar +way to perform actions. Android offers a simple framework for you to add standard +menus to your application.
-Android provides three types of application menus:
+There are three types of application menus:
This document shows you how to create each type of menu, using XML to define the content of +the menu and callback methods in your activity to respond when the user selects an item.
-Instead of instantiating a {@link android.view.Menu} in your application code, you should define a menu and all its items in an XML menu resource, then inflate the menu -resource (load it as a programmable object) in your application code. Defining your menus in XML is -a good practice because it separates your interface design from your application code (the same as -when you define your Activity -layout).
+resource (load it as a programmable object) in your application code. Using a menu resource to +define your menu is a good practice because it separates the content for the menu from your +application code. It's also easier to visualize the structure and content of a menu in XML. -To define a menu, create an XML file inside your project's res/menu/
+
To create a menu resource, create an XML file inside your project's res/menu/
directory and build the menu with the following elements:
<menu><menu> element must be the root node for the file and can hold one or more
+<item> and <group> elements.<item><menu> element in order to create a submenu.<group>For example, here is a file in res/menu/ named game_menu.xml:
Here's an example menu named game_menu.xml:
<?xml version="1.0" encoding="utf-8"?> <menu xmlns:android="http://schemas.android.com/apk/res/android"> @@ -100,28 +108,33 @@ href="#groups">Menu groups. </menu>-
This example defines a menu with two menu items. Each item includes the attributes:
+This example defines a menu with two items. Each item includes the attributes:
For more about the XML syntax and attributes for a menu resource, see the There are many more attributes you can include in an {@code <item>}, including some that + specify how the item may appear in the Action Bar. For more information about the XML +syntax and attributes for a menu resource, see the Menu Resource reference.
+You can inflate your menu resource (convert the XML resource into a programmable object) using +
From your application code, you can inflate a menu resource (convert the XML resource into a
+programmable object) using
{@link android.view.MenuInflater#inflate(int,Menu) MenuInflater.inflate()}. For
-example, the following code inflates the game_menu.xml file defined above during the
-{@link android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} callback method, to be
-used for the Options Menu:
game_menu.xml file defined above, during the
+{@link android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} callback method, to
+use the menu as the activity's Options Menu:
@Override
@@ -133,59 +146,47 @@ public boolean onCreateOptionsMenu(Menu menu) {
The {@link android.app.Activity#getMenuInflater()} method returns a {@link
-android.view.MenuInflater} for the Activity. With this object, you can call {@link
+android.view.MenuInflater} for the activity. With this object, you can call {@link
android.view.MenuInflater#inflate(int,Menu) inflate()}, which inflates a menu resource into a
{@link android.view.Menu} object. In this example, the menu resource defined by
game_menu.xml
is inflated into the {@link android.view.Menu} that was passed into {@link
android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()}. (This callback method for
-creating an option menu is discussed more in the next section.)
- Figure 1. Screenshot of an Options Menu.
+
+ Figure 1. Screenshot of the Options Menu in the +Browser.
The Options Menu is where you should include basic application functions and necessary navigation +
The Options Menu is where you should include basic activity actions and necessary navigation items (for example, a button to open the application settings). Items in the Options Menu are -accessible in two distinct ways: in the Action Bar and in the menu revealed by the MENU -key.
+accessible in two distinct ways: the MENU button or in the Action Bar (on devices running Android 3.0 +or higher). -The Action Bar is an optional widget that appears at the top of the activity in place of the -title bar. It can display several menu items that you choose from the Options Menu, but items in -the Action Bar display only an icon (no title text). Users can reveal the other menu items in the -Options Menu with the MENU key.
+When running on a device with Android 2.3 and lower, the Options Menu appears at the bottom of +the screen, as shown in figure 1. When opened, the first visible portion of the Options Menu is +the icon menu. It holds the first six menu items. If you add more than six items to the +Options Menu, Android places the sixth item and those after it into the overflow menu, which the +user can open by touching the "More" menu item.
-If you include the Action Bar in your activity, the menu items that are not placed in the Action -Bar can appear in two different styles:
-The first visible portion of the Standard Options Menu is called the Icon Menu. -It holds the first six menu items (excluding any added to the Action Bar), with icons and title -text. If there are more than six items, Android adds a "More" item as the sixth menu item and places -the remaining items into the Expanded Menu, which the user can open by selecting "More". The -Expanded Menu displays menu items only by their title text (no icon)
-On Android 3.0 and higher, items from the Options Menu is placed in the Action Bar, which appears +at the top of the activity in place of the traditional title bar. By default all items from the +Options Menu are placed in the overflow menu, which the user can open by touching the menu icon +on the right side of the Action Bar. However, you can place select menu items directly in the +Action Bar as "action items," for instant access, as shown in figure 2.
-When the user opens the Options Menu for the first time, Android calls your Activity's -{@link android.app.Activity#onCreateOptionsMenu(Menu) -onCreateOptionsMenu()} method. Override this method in your Activity -and populate the {@link android.view.Menu} that is passed into the method. Populate the -{@link android.view.Menu} by inflating a menu resource as described in When the Android system creates the Options Menu for the first time, it calls your +activity's {@link android.app.Activity#onCreateOptionsMenu(Menu) +onCreateOptionsMenu()} method. Override this method in your activity +and populate the {@link android.view.Menu} that is passed into the method, +{@link android.view.Menu} by inflating a menu resource as described above in Inflating a Menu Resource. For example:
@@ -197,17 +198,31 @@ public boolean onCreateOptionsMenu(Menu menu) {
}
-(You can also populate the menu in code, using {@link android.view.Menu#add(int,int,int,int) -add()} to add items to the {@link android.view.Menu}.)
+Figure 2. Screenshot of the Action Bar in the Email +application, with two action items from the Options Menu, plus the overflow menu.
+When the user selects a menu item from the Options Menu (including items selected from the -Action Bar), the system calls your Activity's +
You can also populate the menu in code, using {@link android.view.Menu#add(int,int,int,int) +add()} to add items to the {@link android.view.Menu}.
+ +Note: On Android 2.3 and lower, the system calls {@link +android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} to create the Options Menu +when the user opens it for the first time, but on Android 3.0 and greater, the system creates it as +soon as the activity is created, in order to populate the Action Bar.
+ + +When the user selects a menu item from the Options Menu (including action items in the +Action Bar), the system calls your activity's {@link android.app.Activity#onOptionsItemSelected(MenuItem) onOptionsItemSelected()} method. This method passes the {@link android.view.MenuItem} that the user selected. You can identify the menu item by calling {@link android.view.MenuItem#getItemId()}, which returns the unique ID for the menu -item (defined by the {@code android:id} attribute in the menu resource or with an integer passed -to the {@link android.view.Menu#add(int,int,int,int) add()} method). You can match this ID +item (defined by the {@code android:id} attribute in the menu resource or with an integer +given to the {@link android.view.Menu#add(int,int,int,int) add()} method). You can match this ID against known menu items and perform the appropriate action. For example:
@@ -229,45 +244,67 @@ public boolean onOptionsItemSelected(MenuItem item) {
In this example, {@link android.view.MenuItem#getItemId()} queries the ID for the selected menu
item and the switch statement compares the ID against the resource IDs that were assigned to menu
-items in the XML resource. When a switch case successfully handles the item, it
-returns "true" to indicate that the item selection was handled. Otherwise, the default statement
-passes the menu item to the super class in
+items in the XML resource. When a switch case successfully handles the menu item, it
+returns {@code true} to indicate that the item selection was handled. Otherwise, the default
+statement passes the menu item to the super class, in
case it can handle the item selected. (If you've directly extended the {@link android.app.Activity}
-class, then the super class returns "false", but it's a good practice to
-pass unhandled menu items to the super class instead of directly returning "false".)
+class, then the super class returns {@code false}, but it's a good practice to
+pass unhandled menu items to the super class instead of directly returning {@code false}.)
+
+Additionally, Android 3.0 adds the ability for you to define the on-click behavior for a menu
+item in the menu resource XML,
+using the {@code android:onClick} attribute. So you don't need to implement {@link
+android.app.Activity#onOptionsItemSelected(MenuItem) onOptionsItemSelected()}. Using the {@code
+android:onClick} attribute, you can specify a method to call when the user selects the menu item.
+Your activity must then implement the method specified in the {@code android:onClick} attribute so
+that it accepts a single {@link android.view.MenuItem} parameter—when the system calls this
+method, it passes the menu item selected.
Tip: If your application contains multiple activities and
some of them provide the same Options Menu, consider creating
-an Activity that implements nothing except the {@link android.app.Activity#onCreateOptionsMenu(Menu)
+an activity that implements nothing except the {@link android.app.Activity#onCreateOptionsMenu(Menu)
onCreateOptionsMenu()} and {@link android.app.Activity#onOptionsItemSelected(MenuItem)
-onOptionsItemSelected()} methods. Then extend this class for each Activity that should share the
+onOptionsItemSelected()} methods. Then extend this class for each activity that should share the
same Options Menu. This way, you have to manage only one set of code for handling menu
actions and each descendant class inherits the menu behaviors.
If you want to add menu items to one of your descendant activities,
override {@link android.app.Activity#onCreateOptionsMenu(Menu)
-onCreateOptionsMenu()} in that Activity. Call {@code super.onCreateOptionsMenu(menu)} so the
+onCreateOptionsMenu()} in that activity. Call {@code super.onCreateOptionsMenu(menu)} so the
original menu items are created, then add new menu items with {@link
android.view.Menu#add(int,int,int,int) menu.add()}. You can also override the super class's
behavior for individual menu items.
-Changing the menu when it opens
+Changing menu items at runtime
-The {@link android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} method is
-called only the first time the Options Menu is opened. The system keeps and re-uses the {@link
-android.view.Menu} you define in this method until your Activity is destroyed. If you want to change
-the Options Menu each time it opens, you must override the
+
Once the activity is created, the {@link android.app.Activity#onCreateOptionsMenu(Menu)
+onCreateOptionsMenu()} method is
+called only once, as described above. The system keeps and re-uses the {@link
+android.view.Menu} you define in this method until your activity is destroyed. If you want to change
+the Options Menu any time after it's first created, you must override the
{@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()} method. This passes
you the {@link android.view.Menu} object as it currently exists. This is useful if you'd like to
remove, add, disable, or enable menu items depending on the current state of your application.
+On Android 2.3 and lower, the system calls {@link android.app.Activity#onPrepareOptionsMenu(Menu)
+onPrepareOptionsMenu()} each time the user opens the Options Menu.
+
+On Android 3.0 and higher, you must call {@link android.app.Activity#invalidateOptionsMenu
+invalidateOptionsMenu()} when you want to update the menu, because the menu is always open. The
+system will then call {@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()}
+so you can update the menu items.
+
Note:
You should never change items in the Options Menu based on the {@link android.view.View} currently
-in focus. When in touch mode (when the user is not using a trackball or d-pad), Views
+in focus. When in touch mode (when the user is not using a trackball or d-pad), views
cannot take focus, so you should never use focus as the basis for modifying
items in the Options Menu. If you want to provide menu items that are context-sensitive to a {@link
android.view.View}, use a Context Menu.
+If you're developing for Android 3.0 or higher, be sure to also read Using the Action Bar.
+
+
Creating a Context Menu
@@ -287,7 +324,7 @@ feature.)
Register a ListView
-If your Activity uses a {@link android.widget.ListView} and
+
If your activity uses a {@link android.widget.ListView} and
you want all list items to provide a context menu, register all items for a context
menu by passing the {@link android.widget.ListView} to {@link
android.app.Activity#registerForContextMenu(View) registerForContextMenu()}. For
@@ -301,7 +338,7 @@ menu. Call {@link android.app.Activity#registerForContextMenu(View) registerForC
pass it the {@link android.view.View} you want to give a context menu. When this View then
receives a long-press, it displays a context menu.
-To define the context menu's appearance and behavior, override your Activity's context menu
+
To define the context menu's appearance and behavior, override your activity's context menu
callback methods, {@link android.app.Activity#onCreateContextMenu(ContextMenu,View,ContextMenuInfo)
onCreateContextMenu()} and
{@link android.app.Activity#onContextItemSelected(MenuItem) onContextItemSelected()}.
@@ -325,7 +362,7 @@ href="{@docRoot}guide/topics/resources/menu-resource.html">menu resource. (Y
parameters include the {@link android.view.View}
that the user selected and a {@link android.view.ContextMenu.ContextMenuInfo} object that provides
additional information about the item selected. You might use these parameters to determine
-which context menu should be created, but in this example, all context menus for the Activity are
+which context menu should be created, but in this example, all context menus for the activity are
the same.
Then when the user selects an item from the context menu, the system calls {@link
@@ -387,9 +424,9 @@ resource, you can create a submenu by adding a {@code <menu>} element
android:icon="@drawable/file"
android:title="@string/file" >
<!-- "file" submenu -->
- <menu">
- <item android:id="@+id/new"
- android:title="@string/new" />
+ <menu>
+ <item android:id="@+id/create_new"
+ android:title="@string/create_new" />
<item android:id="@+id/open"
android:title="@string/open" />
</menu>
@@ -456,8 +493,9 @@ items in the group by referencing the group ID and using the methods listed abov
Checkable menu items
-
- Figure 2. Screenshot of checkable menu items
+
+ Figure 3. Screenshot of a submenu with checkable
+items.
A menu can be useful as an interface for turning options on and off, using a checkbox for
@@ -525,7 +563,7 @@ public boolean onOptionsItemSelected(MenuItem item) {
If you don't set the checked state this way, then the visible state of the item (the checkbox or
radio button) will not
-change when the user selects it. When you do set the state, the Activity preserves the checked state
+change when the user selects it. When you do set the state, the activity preserves the checked state
of the item so that when the user opens the menu later, the checked state that you
set is visible.
@@ -538,7 +576,8 @@ href="{@docRoot}guide/topics/data/data-storage.html#pref">Shared Preferences
Shortcut keys
-You can add quick-access shortcut keys using letters and/or numbers to menu items with the
+
To facilitate quick access to items in the Options Menu when the user's device has a hardware
+keyboard, you can add quick-access shortcut keys using letters and/or numbers, with the
{@code android:alphabeticShortcut} and {@code android:numericShortcut} attributes in the {@code
<item>} element. You can also use the methods {@link
android.view.MenuItem#setAlphabeticShortcut(char)} and {@link
@@ -546,57 +585,46 @@ android.view.MenuItem#setNumericShortcut(char)}. Shortcut keys are not
case sensitive.
For example, if you apply the "s" character as an alphabetic shortcut to a "save" menu item, then
-when the menu is open (or while the user holds the MENU key) and the user presses the "s" key,
+when the menu is open (or while the user holds the MENU button) and the user presses the "s" key,
the "save" menu item is selected.
This shortcut key is displayed as a tip in the menu item, below the menu item name
(except for items in the Icon Menu, which are displayed only if the user holds the MENU
-key).
+button).
Note: Shortcut keys for menu items only work on devices with a
hardware keyboard. Shortcuts cannot be added to items in a Context Menu.
-Intents for menu items
-Sometimes you'll want a menu item to launch an Activity using an Intent (whether it's an
-Activity in your application or another application). When you know the Intent you want to use and
-have a specific menu item that should initiate the Intent, you can execute the Intent with {@link
-android.app.Activity#startActivity(Intent) startActivity()} during the appropriate on-item-selected
-callback method (such as the {@link android.app.Activity#onOptionsItemSelected(MenuItem)
-onOptionsItemSelected()} callback).
+Dynamically adding menu intents
+
+Sometimes you'll want a menu item to launch an activity using an {@link android.content.Intent}
+(whether it's an activity in your application or another application). When you know the intent you
+want to use and have a specific menu item that should initiate the intent, you can execute the
+intent with {@link android.app.Activity#startActivity(Intent) startActivity()} during the
+appropriate on-item-selected callback method (such as the {@link
+android.app.Activity#onOptionsItemSelected(MenuItem) onOptionsItemSelected()} callback).
However, if you are not certain that the user's device
-contains an application that handles the Intent, then adding a menu item that executes the
-Intent can result in a non-functioning menu item, because the Intent might not resolve to an
-Activity that accepts it. To solve this, Android lets you dynamically add menu items to your menu
-when Android finds activities on the device that handle your Intent.
+contains an application that handles the intent, then adding a menu item that invokes it can result
+in a non-functioning menu item, because the intent might not resolve to an
+activity. To solve this, Android lets you dynamically add menu items to your menu
+when Android finds activities on the device that handle your intent.
-If you're not familiar with creating Intents, read the Intents and Intent Filters.
-
-
-Dynamically adding Intents
-
-When you don't know if the user's device has an application that handles a specific Intent,
-you can define the Intent and let Android search the device for activities that accept the Intent.
-When it finds activies that handle the Intent, it adds a menu item for
-each one to your menu and attaches the appropriate Intent to open the Activity when the user
-selects it.
-
-To add menu items based on available activities that accept an Intent:
+To add menu items based on available activities that accept an intent:
- Define an
-Intent with the category {@link android.content.Intent#CATEGORY_ALTERNATIVE} and/or
+intent with the category {@link android.content.Intent#CATEGORY_ALTERNATIVE} and/or
{@link android.content.Intent#CATEGORY_SELECTED_ALTERNATIVE}, plus any other requirements.
- Call {@link
android.view.Menu#addIntentOptions(int,int,int,ComponentName,Intent[],Intent,int,MenuItem[])
-Menu.addIntentOptions()}. Android then searches for any applications that can perform the Intent
+Menu.addIntentOptions()}. Android then searches for any applications that can perform the intent
and adds them to your menu.
If there are no applications installed
-that satisfy the Intent, then no menu items are added.
+that satisfy the intent, then no menu items are added.
Note:
{@link android.content.Intent#CATEGORY_SELECTED_ALTERNATIVE} is used to handle the currently
@@ -621,7 +649,7 @@ public boolean onCreateOptionsMenu(Menu menu){
R.id.intent_group, // Menu group to which new items will be added
0, // Unique item ID (none)
0, // Order for the items (none)
- this.getComponentName(), // The current Activity name
+ this.getComponentName(), // The current activity name
null, // Specific items to place first (none)
intent, // Intent created above that describes our requirements
0, // Additional flags to control items (none)
@@ -630,8 +658,8 @@ public boolean onCreateOptionsMenu(Menu menu){
return true;
}
-
For each Activity found that provides an Intent filter matching the Intent defined, a menu
-item is added, using the value in the Intent filter's android:label as the
+
For each activity found that provides an intent filter matching the intent defined, a menu
+item is added, using the value in the intent filter's android:label as the
menu item title and the application icon as the menu item icon. The
{@link android.view.Menu#addIntentOptions(int,int,int,ComponentName,Intent[],Intent,int,MenuItem[])
addIntentOptions()} method returns the number of menu items added.
@@ -642,14 +670,14 @@ addIntentOptions()}, it overrides any and all menu items by the menu group speci
argument.
-Allowing your Activity to be added to menus
+Allowing your activity to be added to other menus
-You can also offer the services of your Activity to other applications, so your
+
You can also offer the services of your activity to other applications, so your
application can be included in the menu of others (reverse the roles described above).
-To be included in other application menus, you need to define an Intent
+
To be included in other application menus, you need to define an intent
filter as usual, but be sure to include the {@link android.content.Intent#CATEGORY_ALTERNATIVE}
-and/or {@link android.content.Intent#CATEGORY_SELECTED_ALTERNATIVE} values for the Intent filter
+and/or {@link android.content.Intent#CATEGORY_SELECTED_ALTERNATIVE} values for the intent filter
category. For example:
<intent-filter label="Resize Image">
@@ -660,7 +688,7 @@ category. For example:
</intent-filter>
-Read more about writing Intent filters in the
+
Read more about writing intent filters in the
Intents and Intent Filters document.
For a sample application using this technique, see the
diff --git a/docs/html/images/options_menu.png b/docs/html/images/options_menu.png
index ecb9394e6a62020db2bf9e59ab36512fb246fd26..6c499069ed76927c683eefba3d3a8afa46e3dc83 100755
GIT binary patch
literal 40602
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 aFKDpWyR
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
Hqmlmyy-sr|
literal 24241
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