MenuItemCompat

public static final int SHOW_AS_ACTION_ALWAYS = 2

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_COLLAPSE_ACTION_VIEW = 8

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.

public static final int SHOW_AS_ACTION_IF_ROOM = 1

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_NEVER = 0

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

public static final int SHOW_AS_ACTION_WITH_TEXT = 4

When this item is in the action bar, always show it with a text label even if it also has an icon specified.

@ReplaceWith(expression = "item.collapseActionView()")
public static boolean collapseActionView(MenuItem item)

Collapse the action view associated with this menu item. The menu item must have an action view set, as well as the showAsAction flag SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW. If a listener has been set using setOnActionExpandListener it will have its onMenuItemActionCollapse method invoked. The listener may return false from this method to prevent collapsing the action view.

@ReplaceWith(expression = "item.expandActionView()")
public static boolean expandActionView(MenuItem item)

Expand the action view associated with this menu item. The menu item must have an action view set, as well as the showAsAction flag SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW. If a listener has been set using setOnActionExpandListener it will have its onMenuItemActionExpand method invoked. The listener may return false from this method to prevent expanding the action view.

public static @Nullable ActionProvider getActionProvider(@NonNull MenuItem item)

Gets the ActionProvider.

@ReplaceWith(expression = "item.getActionView()")
public static View getActionView(MenuItem item)

Returns the currently set action view for this menu item.

public static int getAlphabeticModifiers(@NonNull MenuItem item)

Return the modifier for this menu item's alphabetic shortcut. The modifier is a combination of META_META_ON, META_CTRL_ON, META_ALT_ON, META_SHIFT_ON, META_SYM_ON, META_FUNCTION_ON. For example, META_FUNCTION_ON|META_CTRL_ON

public static @Nullable CharSequence getContentDescription(@NonNull MenuItem item)

Retrieve the content description associated with this menu item.

public static @Nullable PorterDuff.Mode getIconTintMode(@NonNull MenuItem item)

Returns the blending mode used to apply the tint to the item's icon, if specified.

public static int getNumericModifiers(@NonNull MenuItem item)

Return the modifiers for this menu item's numeric (12-key) shortcut. The modifier is a combination of META_META_ON, META_CTRL_ON, META_ALT_ON, META_SHIFT_ON, META_SYM_ON, META_FUNCTION_ON. For example, META_FUNCTION_ON|META_CTRL_ON

public static @Nullable CharSequence getTooltipText(@NonNull MenuItem item)

Retrieve the tooltip text associated with this menu item.

@ReplaceWith(expression = "item.isActionViewExpanded()")
public static boolean isActionViewExpanded(MenuItem item)

Returns true if this menu item's action view has been expanded.

public static @Nullable MenuItem setActionProvider(
    @NonNull MenuItem item,
    @Nullable ActionProvider provider
)

Sets the 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 setActionView.

@ReplaceWith(expression = "item.setActionView(resId)")
public static MenuItem setActionView(MenuItem item, 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 set via setActionProvider.

@ReplaceWith(expression = "item.setActionView(view)")
public static MenuItem setActionView(MenuItem item, 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.

public static void setAlphabeticShortcut(
    @NonNull MenuItem item,
    char alphaChar,
    int alphaModifiers
)

Change the alphabetic shortcut associated with this item. The shortcut will be triggered when the key that generates the given character is pressed along with the modifier keys. Case is not significant and shortcut characters will be displayed in lower case. Note that menu items with the characters '\b' or '\n' as shortcuts will get triggered by the Delete key or Carriage Return key, respectively.

See Menu for the menu types that support shortcuts.

public static void setContentDescription(
    @NonNull MenuItem item,
    @Nullable CharSequence contentDescription
)

Change the content description associated with this menu item.

public static void setIconTintList(@NonNull MenuItem item, @Nullable ColorStateList tint)

Applies a tint to the item's icon. Does not modify the current tint mode of that item, which is SRC_IN by default.

Subsequent calls to setIcon or setIcon will automatically mutate the icon and apply the specified tint and tint mode.

public static void setIconTintMode(@NonNull MenuItem item, @Nullable PorterDuff.Mode tintMode)

Specifies the blending mode used to apply the tint specified by setIconTintList to the item's icon. The default mode is SRC_IN.

public static void setNumericShortcut(
    @NonNull MenuItem item,
    char numericChar,
    int numericModifiers
)

Change the numeric shortcut and modifiers associated with this item.

See Menu for the menu types that support shortcuts.

public static MenuItem setOnActionExpandListener(
    MenuItem item,
    MenuItemCompat.OnActionExpandListener listener
)

Set an 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 SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW.

public static void setShortcut(
    @NonNull MenuItem item,
    char numericChar,
    char alphaChar,
    int numericModifiers,
    int alphaModifiers
)

Change both the numeric and alphabetic shortcut associated with this item. Note that the shortcut will be triggered when the key that generates the given character is pressed along with the corresponding modifier key. Also note that case is not significant and that alphabetic shortcut characters will be handled in lower case.

See Menu for the menu types that support shortcuts.

@ReplaceWith(expression = "item.setShowAsAction(actionEnum)")
public static void setShowAsAction(MenuItem item, int actionEnum)

Sets how this item should display in the presence of a compatible Action Bar. If the given item is compatible, this will call the item's supported implementation of setShowAsAction.

public static void setTooltipText(@NonNull MenuItem item, @Nullable CharSequence tooltipText)

Change the tooltip text associated with this menu item.