android.support.v4.view
Class MenuItemCompat

java.lang.Object
  android.support.v4.view.MenuItemCompat

public class MenuItemCompat
extends Object

Helper for accessing features in MenuItem introduced after API level 4 in a backwards compatible fashion.

Field Summary

static int	SHOW_AS_ACTION_ALWAYS Always show this item as a button in an Action Bar.
static int	SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW This item's action view collapses to a normal menu item.
static 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.
static int	SHOW_AS_ACTION_NEVER Never show this item as a button in an Action Bar.
static 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.

Constructor Summary

MenuItemCompat()

Method Summary

static android.view.MenuItem	setActionView(android.view.MenuItem item, android.view.View view) Set an action view for this menu item.
static boolean	setShowAsAction(android.view.MenuItem item, int actionEnum) Call MenuItem.setShowAsAction().

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SHOW_AS_ACTION_NEVER

public static final int SHOW_AS_ACTION_NEVER

Never show this item as a button in an Action Bar.

See Also:

Constant Field Values

SHOW_AS_ACTION_IF_ROOM

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.

See Also:

Constant Field Values

SHOW_AS_ACTION_ALWAYS

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.

See Also:

Constant Field Values

SHOW_AS_ACTION_WITH_TEXT

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.

See Also:

Constant Field Values

SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW

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.

See Also:

Constant Field Values

Constructor Detail

MenuItemCompat

public MenuItemCompat()

Method Detail

setShowAsAction

public static boolean setShowAsAction(android.view.MenuItem item,
                                      int actionEnum)

Call MenuItem.setShowAsAction(). If running on a pre-Build.VERSION_CODES.HONEYCOMB device, does nothing and returns false. Otherwise returns true.

setActionView

public static android.view.MenuItem setActionView(android.view.MenuItem item,
                                                  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.

Parameters:

view - View to use for presenting this item to the user.

Returns:

This Item so additional setters can be called.

See Also:

setShowAsAction(MenuItem, int)