File	Doc	Category	Size	Date	Package
SupportMenuItem.java	API Doc	Android 5.1 API	9213	Thu Mar 12 22:22:56 GMT 2015	android.support.v4.internal.view

SupportMenuItem

Fields Summary
public static final int	SHOW_AS_ACTION_NEVER Never show this item as a button in an Action Bar.
public static final int	SHOW_AS_ACTION_IF_ROOM Show this item as a button in an Action Bar if the system decides there is room for it.
public static final int	SHOW_AS_ACTION_ALWAYS Always show this item as a button in an Action Bar. Use sparingly! If too many items are set to always show in the Action Bar it can crowd the Action Bar and degrade the user experience on devices with smaller screens. A good rule of thumb is to have no more than 2 items set to always show at a time.
public static final int	SHOW_AS_ACTION_WITH_TEXT When this item is in the action bar, always show it with a text label even if it also has an icon specified.
public static final int	SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW This item's action view collapses to a normal menu item. When expanded, the action view temporarily takes over a larger segment of its container.

Constructors Summary

Methods Summary
public boolean	collapseActionView() Collapse the action view associated with this menu item. The menu item must have an action view set, as well as the showAsAction flag {@link #SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW}. If a listener has been set using {@link #setSupportOnActionExpandListener(android.support.v4.view.MenuItemCompat.OnActionExpandListener)} it will have its {@link android.support.v4.view.MenuItemCompat.OnActionExpandListener#onMenuItemActionCollapse(MenuItem)} method invoked. The listener may return false from this method to prevent collapsing the action view. return true if the action view was collapsed, false otherwise.
public boolean	expandActionView() Expand the action view associated with this menu item. The menu item must have an action view set, as well as the showAsAction flag {@link #SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW}. If a listener has been set using {@link #setSupportOnActionExpandListener(android.support.v4.view.MenuItemCompat.OnActionExpandListener)} it will have its {@link android.support.v4.view.MenuItemCompat.OnActionExpandListener#onMenuItemActionExpand(MenuItem)} method invoked. The listener may return false from this method to prevent expanding the action view. return true if the action view was expanded, false otherwise.
public android.view.View	getActionView() Returns the currently set action view for this menu item. return This item's action view see #setActionView(View) see #setShowAsAction(int)
public android.support.v4.view.ActionProvider	getSupportActionProvider() Gets the {@link ActionProvider}. return The action provider. see ActionProvider see #setSupportActionProvider(ActionProvider)
public boolean	isActionViewExpanded() Returns true if this menu item's action view has been expanded. return true if the item's action view is expanded, false otherwise. see #expandActionView() see #collapseActionView() see #SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW see android.support.v4.view.MenuItemCompat.OnActionExpandListener
public android.view.MenuItem	setActionView(android.view.View view) Set an action view for this menu item. An action view will be displayed in place of an automatically generated menu item element in the UI when this item is shown as an action within a parent. Note: Setting an action view overrides the action provider provider set via {@link #setSupportActionProvider(android.support.v4.view.ActionProvider)}. param view View to use for presenting this item to the user. return This Item so additional setters can be called. see #setShowAsAction(int)
public android.view.MenuItem	setActionView(int resId) Set an action view for this menu item. An action view will be displayed in place of an automatically generated menu item element in the UI when this item is shown as an action within a parent. Note: Setting an action view overrides the action provider provider set via {@link #setSupportActionProvider(android.support.v4.view.ActionProvider)}. param resId Layout resource to use for presenting this item to the user. return This Item so additional setters can be called. see #setShowAsAction(int)
public void	setShowAsAction(int actionEnum) Sets how this item should display in the presence of an Action Bar. The parameter actionEnum is a flag set. One of {@link #SHOW_AS_ACTION_ALWAYS}, {@link #SHOW_AS_ACTION_IF_ROOM}, or {@link #SHOW_AS_ACTION_NEVER} should be used, and you may optionally OR the value with {@link #SHOW_AS_ACTION_WITH_TEXT}. SHOW_AS_ACTION_WITH_TEXT requests that when the item is shown as an action, it should be shown with a text label. param actionEnum How the item should display. One of {@link #SHOW_AS_ACTION_ALWAYS}, {@link #SHOW_AS_ACTION_IF_ROOM}, or {@link #SHOW_AS_ACTION_NEVER}. SHOW_AS_ACTION_NEVER is the default. see android.app.ActionBar see #setActionView(View)
public android.view.MenuItem	setShowAsActionFlags(int actionEnum) Sets how this item should display in the presence of an Action Bar. The parameter actionEnum is a flag set. One of {@link #SHOW_AS_ACTION_ALWAYS}, {@link #SHOW_AS_ACTION_IF_ROOM}, or {@link #SHOW_AS_ACTION_NEVER} should be used, and you may optionally OR the value with {@link #SHOW_AS_ACTION_WITH_TEXT}. SHOW_AS_ACTION_WITH_TEXT requests that when the item is shown as an action, it should be shown with a text label. Note: This method differs from {@link #setShowAsAction(int)} only in that it returns the current MenuItem instance for call chaining. param actionEnum How the item should display. One of {@link #SHOW_AS_ACTION_ALWAYS}, {@link #SHOW_AS_ACTION_IF_ROOM}, or {@link #SHOW_AS_ACTION_NEVER}. SHOW_AS_ACTION_NEVER is the default. return This MenuItem instance for call chaining. see android.app.ActionBar see #setActionView(View)
public android.support.v4.internal.view.SupportMenuItem	setSupportActionProvider(android.support.v4.view.ActionProvider actionProvider) Sets the {@link android.support.v4.view.ActionProvider} responsible for creating an action view if the item is placed on the action bar. The provider also provides a default action invoked if the item is placed in the overflow menu. Note: Setting an action provider overrides the action view set via {@link #setActionView(int)} or {@link #setActionView(View)}. param actionProvider The action provider. return This Item so additional setters can be called. see android.support.v4.view.ActionProvider
public android.support.v4.internal.view.SupportMenuItem	setSupportOnActionExpandListener(MenuItemCompat.OnActionExpandListener listener) Set an {@link android.support.v4.view.MenuItemCompat.OnActionExpandListener} on this menu item to be notified when the associated action view is expanded or collapsed. The menu item must be configured to expand or collapse its action view using the flag {@link #SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW}. param listener Listener that will respond to expand/collapse events return This menu item instance for call chaining