Home How it Works Android APIMiner IDE Version More Info

to top

fullscreen Use Tree Navigation

Summary: Inherited Constants | Methods | Inherited Methods | [Expand All]

Added in API level 1

public interface

SubMenu

implements Menu

android.view.SubMenu

Class Overview

Subclass of Menu for sub menus.

Sub menus do not support item icons, or nested sub menus.

Developer Guides

For information about creating menus, read the Menus developer guide.

Summary

[Expand]

Inherited Constants

From interface android.view.Menu

int	CATEGORY_ALTERNATIVE	Category code for the order integer for items/groups that are alternative actions on the data that is currently displayed -- or/add this with your base value.
int	CATEGORY_CONTAINER	Category code for the order integer for items/groups that are part of a container -- or/add this with your base value.
int	CATEGORY_SECONDARY	Category code for the order integer for items/groups that are user-supplied secondary (infrequently used) options -- or/add this with your base value.
int	CATEGORY_SYSTEM	Category code for the order integer for items/groups that are provided by the system -- or/add this with your base value.
int	FIRST	First value for group and item identifier integers.
int	FLAG_ALWAYS_PERFORM_CLOSE	Flag for `performShortcut(int, KeyEvent, int)`: if set, always close the menu after executing the shortcut.
int	FLAG_APPEND_TO_GROUP	Flag for `addIntentOptions(int, int, int, ComponentName, Intent[], Intent, int, MenuItem[])`: if set, do not automatically remove any existing menu items in the same group.
int	FLAG_PERFORM_NO_CLOSE	Flag for `performShortcut(int, KeyEvent, int)`: if set, do not close the menu after executing the shortcut.
int	NONE	Value to use for group and item identifier integers when you don't care about them.

Public Methods
? Examples	abstract void	clearHeader() Clears the header of the submenu.
? Examples	abstract MenuItem	getItem() Gets the `MenuItem` that represents this submenu in the parent menu.
? Examples	abstract SubMenu	setHeaderIcon( Drawable icon) Sets the submenu header's icon to the icon given in `icon` `Drawable`.
? Examples	abstract SubMenu	setHeaderIcon(int iconRes) Sets the submenu header's icon to the icon given in `iconRes` resource id.
? Examples	abstract SubMenu	setHeaderTitle( CharSequence title) Sets the submenu header's title to the title given in `title`.
? Examples	abstract SubMenu	setHeaderTitle(int titleRes) Sets the submenu header's title to the title given in `titleRes` resource identifier.
? Examples	abstract SubMenu	setHeaderView( View view) Sets the header of the submenu to the `View` given in `view`.
? Examples	abstract SubMenu	setIcon( Drawable icon) Change the icon associated with this submenu's item in its parent menu.
? Examples	abstract SubMenu	setIcon(int iconRes) Change the icon associated with this submenu's item in its parent menu.

[Expand]

Inherited Methods

From interface android.view.Menu

abstract MenuItem	add( CharSequence title) Add a new item to the menu.
abstract MenuItem	add(int groupId, int itemId, int order, int titleRes) Variation on `add(int, int, int, CharSequence)` that takes a string resource identifier instead of the string itself.
abstract MenuItem	add(int titleRes) Add a new item to the menu.
abstract MenuItem	add(int groupId, int itemId, int order, CharSequence title) Add a new item to the menu.
abstract int	addIntentOptions(int groupId, int itemId, int order, ComponentName caller, Intent[] specifics, Intent intent, int flags, MenuItem[] outSpecificItems) Add a group of menu items corresponding to actions that can be performed for a particular Intent.
abstract SubMenu	addSubMenu(int groupId, int itemId, int order, CharSequence title) Add a new sub-menu to the menu.
abstract SubMenu	addSubMenu(int groupId, int itemId, int order, int titleRes) Variation on `addSubMenu(int, int, int, CharSequence)` that takes a string resource identifier for the title instead of the string itself.
abstract SubMenu	addSubMenu( CharSequence title) Add a new sub-menu to the menu.
abstract SubMenu	addSubMenu(int titleRes) Add a new sub-menu to the menu.
abstract void	clear() Remove all existing items from the menu, leaving it empty as if it had just been created.
abstract void	close() Closes the menu, if open.
abstract MenuItem	findItem(int id) Return the menu item with a particular identifier.
abstract MenuItem	getItem(int index) Gets the menu item at the given index.
abstract boolean	hasVisibleItems() Return whether the menu currently has item items that are visible.
abstract boolean	isShortcutKey(int keyCode, KeyEvent event) Is a keypress one of the defined shortcut keys for this window.
abstract boolean	performIdentifierAction(int id, int flags) Execute the menu item action associated with the given menu identifier.
abstract boolean	performShortcut(int keyCode, KeyEvent event, int flags) Execute the menu item action associated with the given shortcut character.
abstract void	removeGroup(int groupId) Remove all items in the given group.
abstract void	removeItem(int id) Remove the item with the given identifier.
abstract void	setGroupCheckable(int group, boolean checkable, boolean exclusive) Control whether a particular group of items can show a check mark.
abstract void	setGroupEnabled(int group, boolean enabled) Enable or disable all menu items that are in the given group.
abstract void	setGroupVisible(int group, boolean visible) Show or hide all menu items that are in the given group.
abstract void	setQwertyMode(boolean isQwerty) Control whether the menu should be running in qwerty mode (alphabetic shortcuts) or 12-key mode (numeric shortcuts).
abstract int	size() Get the number of items in the menu.

Public Methods

public abstract void clearHeader ()

Added in API level 1

Clears the header of the submenu.

public abstract MenuItem getItem ()

Added in API level 1

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

Returns

The MenuItem that launches the submenu when invoked.

public abstract SubMenu setHeaderIcon (Drawable icon)

Added in API level 1

Sets the submenu header's icon to the icon given in icon Drawable.

Parameters

icon	The `Drawable` used for the icon.

Returns

This SubMenu so additional setters can be called.

public abstract SubMenu setHeaderIcon (int iconRes)

Added in API level 1

Sets the submenu header's icon to the icon given in iconRes resource id.

Parameters

iconRes	The resource identifier used for the icon.

Returns

This SubMenu so additional setters can be called.

public abstract SubMenu setHeaderTitle (CharSequence title)

Added in API level 1

Sets the submenu header's title to the title given in title.

Parameters

title	The character sequence used for the title.

Returns

This SubMenu so additional setters can be called.

public abstract SubMenu setHeaderTitle (int titleRes)

Added in API level 1

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

Parameters

titleRes	The string resource identifier used for the title.

Returns

This SubMenu so additional setters can be called.

public abstract SubMenu setHeaderView (View view)

Added in API level 1

Sets the header of the submenu to the View given in view. This replaces the header title and icon (and those replace this).

Parameters

view	The `View` used for the header.

Returns

This SubMenu so additional setters can be called.

public abstract SubMenu setIcon (Drawable icon)

Added in API level 1

Change the icon associated with this submenu's item in its parent menu.

Parameters

icon	The new icon (as a Drawable) to be displayed.

Returns

This SubMenu so additional setters can be called.

public abstract SubMenu setIcon (int iconRes)

Added in API level 1

Change the icon associated with this submenu's item in its parent menu.

Parameters

iconRes	The new icon (as a resource ID) to be displayed.

Returns

This SubMenu so additional setters can be called.

Results

Interfaces

Classes

Enums

Exceptions

SubMenu

Class Overview

Developer Guides

Summary

Public Methods

public abstract void clearHeader ()

public abstract MenuItem getItem ()

Returns

public abstract SubMenu setHeaderIcon (Drawable icon)

Parameters

Returns

public abstract SubMenu setHeaderIcon (int iconRes)

Parameters

Returns

public abstract SubMenu setHeaderTitle (CharSequence title)

Parameters

Returns

public abstract SubMenu setHeaderTitle (int titleRes)

Parameters

Returns

public abstract SubMenu setHeaderView (View view)

Parameters

Returns

public abstract SubMenu setIcon (Drawable icon)

Parameters

Returns

See Also

public abstract SubMenu setIcon (int iconRes)

Parameters

Returns

See Also