Android - An Open Handset Alliance Project

android.view
public interface

android.view.SubMenu

Subclass of Menu for submenus

Known Indirect Subclasses

SubMenuBuilder

Summary

Constants inherited from interface android.view.Menu

			Value
int	ALTERNATIVE	Category code for menu group and identifier integers that are alternative actions on the data that is currently displayed -- or/add this with your base value.	262144	0x00040000
int	APPEND_TO_GROUP	Flag for addIntentOptions(int, int, ComponentName, Intent[], Intent, int, Menu.Item[]): if set, do not automatically remove any existing menu items in the same group.	1	0x00000001
int	CATEGORY_MASK	This is the part of a menu group or identifier integer that supplies the category of the item.	-65536	0xffff0000
int	CATEGORY_SHIFT	Bit shift of the category portion of the group/identifier integer.	16	0x00000010
int	CONTAINER	Category code for menu group and identifier integers that are part of a container -- or/add this with your base value.	65536	0x00010000
int	FIRST	First value for group and identifier integers, for normal menu items that do not have a category.	1	0x00000001
int	NONE	Value to use for group and identifier integers when you don't care about them.	0	0x00000000
int	PERFORM_NO_CLOSE	Flag for performShortcut(int, KeyEvent, int): if set, do not close the menu after executing the shortcut.	1	0x00000001
int	SECONDARY	Category code for menu group and identifier integers that are user-supplied secondary (infrequently used) options -- or/add this with your base value.	196608	0x00030000
int	SELECTED_ALTERNATIVE	Category code for menu group and identifier integers that are alternative actions on the item that is currently selected -- or/add this with your base value.	327680	0x00050000
int	SYSTEM	Category code for menu group and identifier integers that are provided by the system -- or/add this with your base value.	131072	0x00020000
int	USER_MASK	This is the part of a menu group or identifier integer that the user can provide.	65535	0x0000ffff
int	USER_SHIFT	Bit shift of the user portion of the group/identifier integer.	0	0x00000000

Public Methods

				Item	getItem()
					Gets the Menu.Item that represents this submenu in the parent menu.
				void	setHeader(int titleRes)
					Sets the header of the submenu to the title given in `titleRes` resource identifier.
				void	setHeader(CharSequence title)
					Sets the header of the submenu to the title given in `title`.

Methods inherited from interface android.view.Menu

				Item	add(int group, int id, CharSequence title, Runnable callback)
					Add a new item to the menu.
				Item	add(int group, int id, CharSequence title, int iconRes)
					Add a new item to the menu.
				Item	add(int group, int id, int titleRes, int iconRes)
					Add a new item to the menu.
				Item	add(int group, int id, CharSequence title)
					Add a new item to the menu.
				Item	add(int group, int id, int titleRes)
					Variation on add(int, int, CharSequence) that takes a string resource identifier instead of the string itself.
				Item	add(int group, int id, int titleRes, Runnable callback)
					Variation on add(int, int, CharSequence, Runnable) that takes a string resource identifier instead of the string itself.
				int	addIntentOptions(int group, int id, ComponentName caller, Intent[] specifics, Intent intent, int flags, Item[] outSpecificItems)
					Add a group of menu items corresponding to actions that can be performed for a particular Intent.
				SubMenu	addSubMenu(int group, int id, CharSequence title)
					Add a new sub-menu to the menu.
				SubMenu	addSubMenu(int group, int id, CharSequence title, int iconRes)
					Add a new sub-menu to the menu.
				SubMenu	addSubMenu(int group, int id, int titleRes, int iconRes)
					Variation on addSubMenu(int, int, CharSequence) that takes a string resource identifier for the title instead of the string itself and a resource identifier for the icon.
				SubMenu	addSubMenu(int group, int id, int titleRes, Drawable icon)
					Variation on addSubMenu(int, int, CharSequence) that takes a string resource identifier for the title instead of the string itself, and a Drawable for the icon.
				SubMenu	addSubMenu(int group, int id, int titleRes)
					Variation on addSubMenu(int, int, CharSequence) that takes a string resource identifier for the title instead of the string itself.
				SubMenu	addSubMenu(int group, int id, CharSequence title, Drawable icon)
					Add a new sub-menu to the menu.
				void	clear()
					Remove all existing items from the menu, leaving it empty as if it had just been created.
				int	findGroupIndex(int group)
					Get the index of the first menu item that is in the given group.
				Item	findItem(int id)
					Return the menu item with a particular identifier.
				int	findItemIndex(int id)
					Get the index of a menu item that has the given identifier.
				Item	get(int index)
					Retrieve the menu item object at a particular index.
				boolean	hasShownItems()
					Return whether the menu currently has item items that are being shown.
				boolean	isShortcutKey(int keyCode, KeyEvent event)
					Is a keypress one of the defined shortcut keys for this window.
				boolean	performIdentifierAction(int id, int flags)
					Execute the menu item action associated with the given menu identifier.
				boolean	performShortcut(int keyCode, KeyEvent event, int flags)
					Execute the menu item action associated with the given shortcut character.
				void	removeGroup(int group)
					Remove all items in the given group.
				void	removeItem(int id)
					Remove the item with the given identifier.
				void	removeItemAt(int index)
					Remove the item at the given index.
				void	setDefaultItem(int id)
					Set the item that is initially selected when the menu is displayed.
				void	setGroupCheckable(int group, boolean checkable, boolean exclusive)
					Control whether a particular group of items can show a check mark.
				void	setGroupShown(int group, boolean shown)
					Show or hide all menu items that are in the given group.
				void	setItemCheckable(int id, boolean checkable)
					Control whether a particular item with the given identifier can display a check mark.
				void	setItemChecked(int id, boolean checked)
					Show or hide the check mark for a particular menu item selected by its identifier.
				void	setItemShown(int id, boolean shown)
					Show or hide a particular menu item selected by its identifier.
				void	setQwertyMode(boolean isQwerty)
					Control whether the menu should be running in qwerty mode (alphabetic shortcuts) or 12-key mode (numeric shortcuts).
				int	size()
					Get the number of items in the menu.

Details

Public Methods

public Item getItem()

Gets the Menu.Item that represents this submenu in the parent menu. Use this for setting additional item attributes.

Returns

The Menu.Item that launches the submenu when invoked.

public void setHeader(int titleRes)

Sets the header of the submenu to the title given in titleRes resource identifier.

Parameters

titleRes	The string resource identifier used for the title.

public void setHeader(CharSequence title)

Sets the header of the submenu to the title given in title.

Parameters

title	The character sequence used for the title.

Android - An Open Handset Alliance Project

Documentation

Goodies

android.view.SubMenu

Known Indirect Subclasses

Summary

Constants inherited from interface android.view.Menu

Public Methods

Methods inherited from interface android.view.Menu

Details

Public Methods

public Item getItem()

Returns

public void setHeader(int titleRes)

Parameters

public void setHeader(CharSequence title)

Parameters


e.g. "intent" or "activity"