# MenuItemCompat added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) belongs to Maven artifact com.android.support:support-compat:28.0.0-alpha1 Summary:[Nested Classes](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#nestedclasses)\|[Constants](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#constants)\|[Methods](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#inhmethods)\|[\[Expand All\]](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#) # MenuItemCompat | This package is part of the Android[support library](https://developer.android.com/topic/libraries/support-library)which is no longer maintained. The support library has been superseded by[AndroidX](https://developer.android.com/jetpack/androidx)which is part of[Jetpack](https://developer.android.com/jetpack). We recommend using the AndroidX libraries in all new projects. You should also consider[migrating](https://developer.android.com/jetpack/androidx/migrate)existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library[class mappings](https://developer.android.com/jetpack/androidx/migrate/class-mappings). ` public final class MenuItemCompat ` ` extends Object `` ` |---|----------------------------------------| | java.lang.Object || | ↳ | android.support.v4.view.MenuItemCompat |
*** ** * ** *** Helper for accessing features in[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html). **Note:** You cannot get an instance of this class. Instead, it provides*static* methods that correspond to the methods in[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html), but take a[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)object as an additional argument.
## Summary | ### Nested classes || |--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` interface` | [MenuItemCompat.OnActionExpandListener](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat.OnActionExpandListener) *This interface was deprecated in API level 26.1.0. Use[MenuItem.OnActionExpandListener](https://developer.android.com/reference/android/view/MenuItem.OnActionExpandListener.html)directly.* | | ### Constants || |-------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `int` | [SHOW_AS_ACTION_ALWAYS](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#SHOW_AS_ACTION_ALWAYS) *This constant was deprecated in API level 26.1.0. Use[SHOW_AS_ACTION_ALWAYS](https://developer.android.com/reference/android/view/MenuItem.html#SHOW_AS_ACTION_ALWAYS)directly.* | | `int` | [SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW) *This constant was deprecated in API level 26.1.0. Use[SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW](https://developer.android.com/reference/android/view/MenuItem.html#SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW)directly.* | | `int` | [SHOW_AS_ACTION_IF_ROOM](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#SHOW_AS_ACTION_IF_ROOM) *This constant was deprecated in API level 26.1.0. Use[SHOW_AS_ACTION_IF_ROOM](https://developer.android.com/reference/android/view/MenuItem.html#SHOW_AS_ACTION_IF_ROOM)directly.* | | `int` | [SHOW_AS_ACTION_NEVER](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#SHOW_AS_ACTION_NEVER) *This constant was deprecated in API level 26.1.0. Use[SHOW_AS_ACTION_NEVER](https://developer.android.com/reference/android/view/MenuItem.html#SHOW_AS_ACTION_NEVER)directly.* | | `int` | [SHOW_AS_ACTION_WITH_TEXT](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#SHOW_AS_ACTION_WITH_TEXT) *This constant was deprecated in API level 26.1.0. Use[SHOW_AS_ACTION_WITH_TEXT](https://developer.android.com/reference/android/view/MenuItem.html#SHOW_AS_ACTION_WITH_TEXT)directly.* | | ### Public methods || |-------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` static boolean` | ` `[collapseActionView](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#collapseActionView(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item) ` *This method was deprecated in API level 26.1.0. Use[collapseActionView()](https://developer.android.com/reference/android/view/MenuItem.html#collapseActionView())directly.* | | ` static boolean` | ` `[expandActionView](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#expandActionView(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item) ` *This method was deprecated in API level 26.1.0. Use[expandActionView()](https://developer.android.com/reference/android/view/MenuItem.html#expandActionView())directly.* | | ` static `[ActionProvider](https://developer.android.com/reference/android/support/v4/view/ActionProvider) | ` `[getActionProvider](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#getActionProvider(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item) ` Gets the[ActionProvider](https://developer.android.com/reference/android/support/v4/view/ActionProvider). | | ` static `[View](https://developer.android.com/reference/android/view/View.html) | ` `[getActionView](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#getActionView(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item) ` *This method was deprecated in API level 26.1.0. Use[getActionView()](https://developer.android.com/reference/android/view/MenuItem.html#getActionView())directly.* | | ` static int` | ` `[getAlphabeticModifiers](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#getAlphabeticModifiers(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item) ` Return the modifier for this menu item's alphabetic shortcut. | | ` static CharSequence` | ` `[getContentDescription](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#getContentDescription(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item) ` Retrieve the content description associated with this menu item. | | ` static `[ColorStateList](https://developer.android.com/reference/android/content/res/ColorStateList.html) | ` `[getIconTintList](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#getIconTintList(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item) ` | | ` static `[PorterDuff.Mode](https://developer.android.com/reference/android/graphics/PorterDuff.Mode.html) | ` `[getIconTintMode](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#getIconTintMode(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item) ` Returns the blending mode used to apply the tint to the item's icon, if specified. | | ` static int` | ` `[getNumericModifiers](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#getNumericModifiers(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item) ` Return the modifiers for this menu item's numeric (12-key) shortcut. | | ` static CharSequence` | ` `[getTooltipText](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#getTooltipText(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item) ` Retrieve the tooltip text associated with this menu item. | | ` static boolean` | ` `[isActionViewExpanded](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#isActionViewExpanded(android.view.MenuItem))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item) ` *This method was deprecated in API level 26.1.0. Use[isActionViewExpanded()](https://developer.android.com/reference/android/view/MenuItem.html#isActionViewExpanded())directly.* | | ` static `[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html) | ` `[setActionProvider](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setActionProvider(android.view.MenuItem, android.support.v4.view.ActionProvider))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item, `[ActionProvider](https://developer.android.com/reference/android/support/v4/view/ActionProvider)` provider) ` Sets the[ActionProvider](https://developer.android.com/reference/android/support/v4/view/ActionProvider)responsible for creating an action view if the item is placed on the action bar. | | ` static `[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html) | ` `[setActionView](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setActionView(android.view.MenuItem, int))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item, int resId) ` *This method was deprecated in API level 26.1.0. Use[setActionView(int)](https://developer.android.com/reference/android/view/MenuItem.html#setActionView(int))directly.* | | ` static `[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html) | ` `[setActionView](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setActionView(android.view.MenuItem, android.view.View))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item, `[View](https://developer.android.com/reference/android/view/View.html)` view) ` *This method was deprecated in API level 26.1.0. Use[setActionView(View)](https://developer.android.com/reference/android/view/MenuItem.html#setActionView(android.view.View))directly.* | | ` static void` | ` `[setAlphabeticShortcut](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setAlphabeticShortcut(android.view.MenuItem, char, int))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item, char alphaChar, int alphaModifiers) ` Change the alphabetic shortcut associated with this item. | | ` static void` | ` `[setContentDescription](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setContentDescription(android.view.MenuItem, java.lang.CharSequence))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item, CharSequence contentDescription) ` Change the content description associated with this menu item. | | ` static void` | ` `[setIconTintList](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setIconTintList(android.view.MenuItem, android.content.res.ColorStateList))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item, `[ColorStateList](https://developer.android.com/reference/android/content/res/ColorStateList.html)` tint) ` Applies a tint to the item's icon. | | ` static void` | ` `[setIconTintMode](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setIconTintMode(android.view.MenuItem, android.graphics.PorterDuff.Mode))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item, `[PorterDuff.Mode](https://developer.android.com/reference/android/graphics/PorterDuff.Mode.html)` tintMode) ` Specifies the blending mode used to apply the tint specified by[setIconTintList(MenuItem, ColorStateList)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setIconTintList(android.view.MenuItem, android.content.res.ColorStateList))to the item's icon. | | ` static void` | ` `[setNumericShortcut](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setNumericShortcut(android.view.MenuItem, char, int))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item, char numericChar, int numericModifiers) ` Change the numeric shortcut and modifiers associated with this item. | | ` static `[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html) | ` `[setOnActionExpandListener](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setOnActionExpandListener(android.view.MenuItem, android.support.v4.view.MenuItemCompat.OnActionExpandListener))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item, `[MenuItemCompat.OnActionExpandListener](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat.OnActionExpandListener)` listener) ` *This method was deprecated in API level 26.1.0. Use[setOnActionExpandListener(MenuItem.OnActionExpandListener)](https://developer.android.com/reference/android/view/MenuItem.html#setOnActionExpandListener(android.view.MenuItem.OnActionExpandListener))directly.* | | ` static void` | ` `[setShortcut](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setShortcut(android.view.MenuItem, char, char, int, int))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item, char numericChar, char alphaChar, int numericModifiers, int alphaModifiers) ` Change both the numeric and alphabetic shortcut associated with this item. | | ` static void` | ` `[setShowAsAction](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setShowAsAction(android.view.MenuItem, int))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item, int actionEnum) ` *This method was deprecated in API level 26.1.0. Use[setShowAsAction(int)](https://developer.android.com/reference/android/view/MenuItem.html#setShowAsAction(int))directly.* | | ` static void` | ` `[setTooltipText](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setTooltipText(android.view.MenuItem, java.lang.CharSequence))`(`[MenuItem](https://developer.android.com/reference/android/view/MenuItem.html)` item, CharSequence tooltipText) ` Change the tooltip text associated with this menu item. | | ### Inherited methods | |-----------------------|---| | [![](https://developer.android.com/static/assets/images/styles/disclosure_down.png)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#)From class` java.lang.Object ` |-------------------|-------------------------------| | ` Object` | ` clone() ` | | ` boolean` | ` equals(Object arg0) ` | | ` void` | ` finalize() ` | | ` final Class` | ` getClass() ` | | ` int` | ` hashCode() ` | | ` final void` | ` notify() ` | | ` final void` | ` notifyAll() ` | | ` String` | ` toString() ` | | ` final void` | ` wait(long arg0, int arg1) ` | | ` final void` | ` wait(long arg0) ` | | ` final void` | ` wait() ` | || ## Constants ### SHOW_AS_ACTION_ALWAYS added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int SHOW_AS_ACTION_ALWAYS ```
**This constant was deprecated in API level 26.1.0.** Use[SHOW_AS_ACTION_ALWAYS](https://developer.android.com/reference/android/view/MenuItem.html#SHOW_AS_ACTION_ALWAYS)directly. 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.
Constant Value: 2 (0x00000002) ### SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW ```
**This constant was deprecated in API level 26.1.0.** Use[SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW](https://developer.android.com/reference/android/view/MenuItem.html#SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW)directly. 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.
Constant Value: 8 (0x00000008) ### SHOW_AS_ACTION_IF_ROOM added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int SHOW_AS_ACTION_IF_ROOM ```
**This constant was deprecated in API level 26.1.0.** Use[SHOW_AS_ACTION_IF_ROOM](https://developer.android.com/reference/android/view/MenuItem.html#SHOW_AS_ACTION_IF_ROOM)directly. Show this item as a button in an Action Bar if the system decides there is room for it.
Constant Value: 1 (0x00000001) ### SHOW_AS_ACTION_NEVER added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int SHOW_AS_ACTION_NEVER ```
**This constant was deprecated in API level 26.1.0.** Use[SHOW_AS_ACTION_NEVER](https://developer.android.com/reference/android/view/MenuItem.html#SHOW_AS_ACTION_NEVER)directly. Never show this item as a button in an Action Bar.
Constant Value: 0 (0x00000000) ### SHOW_AS_ACTION_WITH_TEXT added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int SHOW_AS_ACTION_WITH_TEXT ```
**This constant was deprecated in API level 26.1.0.** Use[SHOW_AS_ACTION_WITH_TEXT](https://developer.android.com/reference/android/view/MenuItem.html#SHOW_AS_ACTION_WITH_TEXT)directly. When this item is in the action bar, always show it with a text label even if it also has an icon specified.
Constant Value: 4 (0x00000004) ## Public methods ### collapseActionView added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` boolean collapseActionView (MenuItem item) ```
**This method was deprecated in API level 26.1.0.** Use[collapseActionView()](https://developer.android.com/reference/android/view/MenuItem.html#collapseActionView())directly. 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](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW). If a listener has been set using[setOnActionExpandListener(MenuItem, android.support.v4.view.MenuItemCompat.OnActionExpandListener)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setOnActionExpandListener(android.view.MenuItem, android.support.v4.view.MenuItemCompat.OnActionExpandListener))it will have its[onMenuItemActionCollapse(MenuItem)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat.OnActionExpandListener#onMenuItemActionCollapse(android.view.MenuItem))method invoked. The listener may return false from this method to prevent collapsing the action view.
| Parameters || |--------|-------------------| | `item` | `MenuItem`
| | Returns || |-----------|----------------------------------------------------------------| | `boolean` | true if the action view was collapsed, false otherwise.
| ### expandActionView added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` boolean expandActionView (MenuItem item) ```
**This method was deprecated in API level 26.1.0.** Use[expandActionView()](https://developer.android.com/reference/android/view/MenuItem.html#expandActionView())directly. 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](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW). If a listener has been set using[setOnActionExpandListener(MenuItem, OnActionExpandListener)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setOnActionExpandListener(android.view.MenuItem, android.support.v4.view.MenuItemCompat.OnActionExpandListener))it will have its[onMenuItemActionExpand(MenuItem)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat.OnActionExpandListener#onMenuItemActionExpand(android.view.MenuItem))method invoked. The listener may return false from this method to prevent expanding the action view.
| Parameters || |--------|-------------------| | `item` | `MenuItem`
| | Returns || |-----------|---------------------------------------------------------------| | `boolean` | true if the action view was expanded, false otherwise.
| ### getActionProvider added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` ActionProvider getActionProvider (MenuItem item) ``` Gets the[ActionProvider](https://developer.android.com/reference/android/support/v4/view/ActionProvider).
| Parameters || |--------|-------------------| | `item` | `MenuItem`
| | Returns || |--------------------------------------------------------------------------------------------------|-----------------------------| | [ActionProvider](https://developer.android.com/reference/android/support/v4/view/ActionProvider) | The action provider.
| **See also:** - [ActionProvider](https://developer.android.com/reference/android/support/v4/view/ActionProvider) - [setActionProvider(MenuItem, ActionProvider)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setActionProvider(android.view.MenuItem, android.support.v4.view.ActionProvider)) ### getActionView added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` View getActionView (MenuItem item) ```
**This method was deprecated in API level 26.1.0.** Use[getActionView()](https://developer.android.com/reference/android/view/MenuItem.html#getActionView())directly. Returns the currently set action view for this menu item.
| Parameters || |--------|--------------------------------------| | `item` | `MenuItem`: the item to query
| | Returns || |------------------------------------------------------------------------|--------------------------------| | [View](https://developer.android.com/reference/android/view/View.html) | This item's action view
| ### getAlphabeticModifiers added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int getAlphabeticModifiers (MenuItem item) ``` Return the modifier for this menu item's alphabetic shortcut. The modifier is a combination of[META_META_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_META_ON),[META_CTRL_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_CTRL_ON),[META_ALT_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_ALT_ON),[META_SHIFT_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_SHIFT_ON),[META_SYM_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_SYM_ON),[META_FUNCTION_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_FUNCTION_ON). For example,[META_FUNCTION_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_FUNCTION_ON)\|[META_CTRL_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_CTRL_ON)
| Parameters || |--------|-------------------| | `item` | `MenuItem`
| | Returns || |-------|--------------------------------------------------------| | `int` | Modifier associated with the keyboard shortcut.
| ### getContentDescription added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` CharSequence getContentDescription (MenuItem item) ``` Retrieve the content description associated with this menu item.
| Parameters || |--------|-------------------| | `item` | `MenuItem`
| | Returns || |----------------|---------------------------------| | `CharSequence` | The content description.
| ### getIconTintList added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` ColorStateList getIconTintList (MenuItem item) ```

| Parameters || |--------|-------------------| | `item` | `MenuItem`
| | Returns || |---------------------------------------------------------------------------------------------------|--------------------------------------------| | [ColorStateList](https://developer.android.com/reference/android/content/res/ColorStateList.html) | the tint applied to the item's icon
| **See also:** - [setIconTintList(MenuItem, ColorStateList)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setIconTintList(android.view.MenuItem, android.content.res.ColorStateList)) ### getIconTintMode added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` PorterDuff.Mode getIconTintMode (MenuItem item) ``` Returns the blending mode used to apply the tint to the item's icon, if specified.
| Parameters || |--------|-------------------| | `item` | `MenuItem`
| | Returns || |--------------------------------------------------------------------------------------------------|--------------------------------------------------------------------| | [PorterDuff.Mode](https://developer.android.com/reference/android/graphics/PorterDuff.Mode.html) | the blending mode used to apply the tint to the item's icon
| **See also:** - [setIconTintMode(MenuItem, PorterDuff.Mode)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setIconTintMode(android.view.MenuItem, android.graphics.PorterDuff.Mode)) ### getNumericModifiers added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int getNumericModifiers (MenuItem item) ``` Return the modifiers for this menu item's numeric (12-key) shortcut. The modifier is a combination of[META_META_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_META_ON),[META_CTRL_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_CTRL_ON),[META_ALT_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_ALT_ON),[META_SHIFT_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_SHIFT_ON),[META_SYM_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_SYM_ON),[META_FUNCTION_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_FUNCTION_ON). For example,[META_FUNCTION_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_FUNCTION_ON)\|[META_CTRL_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_CTRL_ON)
| Parameters || |--------|-------------------| | `item` | `MenuItem`
| | Returns || |-------|-------------------------------------------------------| | `int` | Modifier associated with the numeric shortcut.
| ### getTooltipText added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` CharSequence getTooltipText (MenuItem item) ``` Retrieve the tooltip text associated with this menu item.
| Parameters || |--------|-------------------| | `item` | `MenuItem`
| | Returns || |----------------|--------------------------| | `CharSequence` | The tooltip text.
| ### isActionViewExpanded added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` boolean isActionViewExpanded (MenuItem item) ```
**This method was deprecated in API level 26.1.0.** Use[isActionViewExpanded()](https://developer.android.com/reference/android/view/MenuItem.html#isActionViewExpanded())directly. Returns true if this menu item's action view has been expanded.
| Parameters || |--------|-------------------| | `item` | `MenuItem`
| | Returns || |-----------|---------------------------------------------------------------------| | `boolean` | true if the item's action view is expanded, false otherwise.
| **See also:** - [expandActionView(MenuItem)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#expandActionView(android.view.MenuItem)) - [collapseActionView(MenuItem)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#collapseActionView(android.view.MenuItem)) - [SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW) - [MenuItemCompat.OnActionExpandListener](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat.OnActionExpandListener) ### setActionProvider added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` MenuItem setActionProvider (MenuItem item, ActionProvider provider) ``` Sets the[ActionProvider](https://developer.android.com/reference/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[setActionView(MenuItem, View)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setActionView(android.view.MenuItem, android.view.View)).

| Parameters || |------------|-----------------------------------------------| | `item` | `MenuItem`: item to change
| | `provider` | `ActionProvider`: The action provider.
| | Returns || |--------------------------------------------------------------------------------|-------------------------------------------------------| | [MenuItem](https://developer.android.com/reference/android/view/MenuItem.html) | This Item so additional setters can be called.
| **See also:** - [ActionProvider](https://developer.android.com/reference/android/support/v4/view/ActionProvider) ### setActionView added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` MenuItem setActionView (MenuItem item, int resId) ```
**This method was deprecated in API level 26.1.0.** Use[setActionView(int)](https://developer.android.com/reference/android/view/MenuItem.html#setActionView(int))directly. 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(MenuItem, ActionProvider)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setActionProvider(android.view.MenuItem, android.support.v4.view.ActionProvider)).

| Parameters || |---------|----------------------------------------------------------------------------| | `item` | `MenuItem`: the item to change
| | `resId` | `int`: Layout resource to use for presenting this item to the user.
| | Returns || |--------------------------------------------------------------------------------|-------------------------------------------------------| | [MenuItem](https://developer.android.com/reference/android/view/MenuItem.html) | This Item so additional setters can be called.
| **See also:** - [setShowAsAction(MenuItem, int)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setShowAsAction(android.view.MenuItem, int)) ### setActionView added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` MenuItem setActionView (MenuItem item, View view) ```
**This method was deprecated in API level 26.1.0.** Use[setActionView(View)](https://developer.android.com/reference/android/view/MenuItem.html#setActionView(android.view.View))directly. 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 || |--------|------------------------------------------------------------------| | `item` | `MenuItem`: the item to change
| | `view` | `View`: View to use for presenting this item to the user.
| | Returns || |--------------------------------------------------------------------------------|-------------------------------------------------------| | [MenuItem](https://developer.android.com/reference/android/view/MenuItem.html) | This Item so additional setters can be called.
| **See also:** - [setShowAsAction(MenuItem, int)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setShowAsAction(android.view.MenuItem, int)) ### setAlphabeticShortcut added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` void setAlphabeticShortcut (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](https://developer.android.com/reference/android/view/Menu.html)for the menu types that support shortcuts.
| Parameters || |------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `item` | `MenuItem`
| | `alphaChar` | `char`: The alphabetic shortcut key. This is the shortcut when using a keyboard with alphabetic keys.
| | `alphaModifiers` | `int`: The modifier associated with the shortcut. It should be a combination of[META_META_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_META_ON),[META_CTRL_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_CTRL_ON),[META_ALT_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_ALT_ON),[META_SHIFT_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_SHIFT_ON),[META_SYM_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_SYM_ON),[META_FUNCTION_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_FUNCTION_ON).
| ### setContentDescription added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` void setContentDescription (MenuItem item, CharSequence contentDescription) ``` Change the content description associated with this menu item.
| Parameters || |----------------------|-----------------------------------------------------| | `item` | `MenuItem`: item to change.
| | `contentDescription` | `CharSequence`: The new content description.
| ### setIconTintList added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` void setIconTintList (MenuItem item, ColorStateList tint) ``` Applies a tint to the item's icon. Does not modify the current tint mode of that item, which is[SRC_IN](https://developer.android.com/reference/android/graphics/PorterDuff.Mode.html#SRC_IN)by default. Subsequent calls to[setIcon(Drawable)](https://developer.android.com/reference/android/view/MenuItem.html#setIcon(android.graphics.drawable.Drawable))or[setIcon(int)](https://developer.android.com/reference/android/view/MenuItem.html#setIcon(int))will automatically mutate the icon and apply the specified tint and tint mode.
| Parameters || |--------|-----------------------------------------------------------------------| | `item` | `MenuItem`
| | `tint` | `ColorStateList`: the tint to apply, may be`null`to clear tint
| **See also:** - [getIconTintList(MenuItem)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#getIconTintList(android.view.MenuItem)) ### setIconTintMode added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` void setIconTintMode (MenuItem item, PorterDuff.Mode tintMode) ``` Specifies the blending mode used to apply the tint specified by[setIconTintList(MenuItem, ColorStateList)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setIconTintList(android.view.MenuItem, android.content.res.ColorStateList))to the item's icon. The default mode is[SRC_IN](https://developer.android.com/reference/android/graphics/PorterDuff.Mode.html#SRC_IN).
| Parameters || |------------|-----------------------------------------------------------------------------------------------| | `item` | `MenuItem`
| | `tintMode` | `PorterDuff.Mode`: the blending mode used to apply the tint, may be`null`to clear tint
| **See also:** - [setIconTintList(MenuItem, ColorStateList)](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#setIconTintList(android.view.MenuItem, android.content.res.ColorStateList)) ### setNumericShortcut added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` void setNumericShortcut (MenuItem item, char numericChar, int numericModifiers) ``` Change the numeric shortcut and modifiers associated with this item. See[Menu](https://developer.android.com/reference/android/view/Menu.html)for the menu types that support shortcuts.
| Parameters || |--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `item` | `MenuItem`
| | `numericChar` | `char`: The numeric shortcut key. This is the shortcut when using a 12-key (numeric) keyboard.
| | `numericModifiers` | `int`: The modifier associated with the shortcut. It should be a combination of[META_META_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_META_ON),[META_CTRL_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_CTRL_ON),[META_ALT_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_ALT_ON),[META_SHIFT_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_SHIFT_ON),[META_SYM_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_SYM_ON),[META_FUNCTION_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_FUNCTION_ON).
| ### setOnActionExpandListener added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` MenuItem setOnActionExpandListener (MenuItem item, MenuItemCompat.OnActionExpandListener listener) ```
**This method was deprecated in API level 26.1.0.** Use[setOnActionExpandListener(MenuItem.OnActionExpandListener)](https://developer.android.com/reference/android/view/MenuItem.html#setOnActionExpandListener(android.view.MenuItem.OnActionExpandListener))directly. Set an[MenuItemCompat.OnActionExpandListener](https://developer.android.com/reference/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[SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat#SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW).
| Parameters || |------------|------------------------------------------------------------------------------------------------------| | `item` | `MenuItem`
| | `listener` | `MenuItemCompat.OnActionExpandListener`: Listener that will respond to expand/collapse events
| | Returns || |--------------------------------------------------------------------------------|--------------------------------------------------| | [MenuItem](https://developer.android.com/reference/android/view/MenuItem.html) | This menu item instance for call chaining
| ### setShortcut added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` void setShortcut (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](https://developer.android.com/reference/android/view/Menu.html)for the menu types that support shortcuts.
| Parameters || |--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `item` | `MenuItem`
| | `numericChar` | `char`: The numeric shortcut key. This is the shortcut when using a numeric (e.g., 12-key) keyboard.
| | `alphaChar` | `char`: The alphabetic shortcut key. This is the shortcut when using a keyboard with alphabetic keys.
| | `numericModifiers` | `int`: The numeric modifier associated with the shortcut. It should be a combination of[META_META_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_META_ON),[META_CTRL_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_CTRL_ON),[META_ALT_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_ALT_ON),[META_SHIFT_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_SHIFT_ON),[META_SYM_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_SYM_ON),[META_FUNCTION_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_FUNCTION_ON).
| | `alphaModifiers` | `int`: The alphabetic modifier associated with the shortcut. It should be a combination of[META_META_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_META_ON),[META_CTRL_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_CTRL_ON),[META_ALT_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_ALT_ON),[META_SHIFT_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_SHIFT_ON),[META_SYM_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_SYM_ON),[META_FUNCTION_ON](https://developer.android.com/reference/android/view/KeyEvent.html#META_FUNCTION_ON).
| ### setShowAsAction added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` void setShowAsAction (MenuItem item, int actionEnum) ```
**This method was deprecated in API level 26.1.0.** Use[setShowAsAction(int)](https://developer.android.com/reference/android/view/MenuItem.html#setShowAsAction(int))directly. 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(int)](https://developer.android.com/reference/android/view/MenuItem.html#setShowAsAction(int)).
| Parameters || |--------------|----------------------------------------------| | `item` | `MenuItem`: - the item to change
| | `actionEnum` | `int`: - How the item should display.
| ### setTooltipText added in[version 26.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` void setTooltipText (MenuItem item, CharSequence tooltipText) ``` Change the tooltip text associated with this menu item.
| Parameters || |---------------|---------------------------------------------| | `item` | `MenuItem`: item to change.
| | `tooltipText` | `CharSequence`: The new tooltip text
| - ## Annotations - [ViewPager.DecorView](https://developer.android.com/reference/android/support/v4/view/ViewPager.DecorView) - ## Interfaces - [ActionProvider.VisibilityListener](https://developer.android.com/reference/android/support/v4/view/ActionProvider.VisibilityListener) - [AsyncLayoutInflater.OnInflateFinishedListener](https://developer.android.com/reference/android/support/v4/view/AsyncLayoutInflater.OnInflateFinishedListener) - [LayoutInflaterFactory](https://developer.android.com/reference/android/support/v4/view/LayoutInflaterFactory) - [MenuItemCompat.OnActionExpandListener](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat.OnActionExpandListener) - [NestedScrollingChild](https://developer.android.com/reference/android/support/v4/view/NestedScrollingChild) - [NestedScrollingChild2](https://developer.android.com/reference/android/support/v4/view/NestedScrollingChild2) - [NestedScrollingParent](https://developer.android.com/reference/android/support/v4/view/NestedScrollingParent) - [NestedScrollingParent2](https://developer.android.com/reference/android/support/v4/view/NestedScrollingParent2) - [OnApplyWindowInsetsListener](https://developer.android.com/reference/android/support/v4/view/OnApplyWindowInsetsListener) - [ScrollingView](https://developer.android.com/reference/android/support/v4/view/ScrollingView) - [TintableBackgroundView](https://developer.android.com/reference/android/support/v4/view/TintableBackgroundView) - [ViewPager.OnAdapterChangeListener](https://developer.android.com/reference/android/support/v4/view/ViewPager.OnAdapterChangeListener) - [ViewPager.OnPageChangeListener](https://developer.android.com/reference/android/support/v4/view/ViewPager.OnPageChangeListener) - [ViewPager.PageTransformer](https://developer.android.com/reference/android/support/v4/view/ViewPager.PageTransformer) - [ViewPropertyAnimatorListener](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorListener) - [ViewPropertyAnimatorUpdateListener](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorUpdateListener) - ## Classes - [AbsSavedState](https://developer.android.com/reference/android/support/v4/view/AbsSavedState) - [AccessibilityDelegateCompat](https://developer.android.com/reference/android/support/v4/view/AccessibilityDelegateCompat) - [ActionProvider](https://developer.android.com/reference/android/support/v4/view/ActionProvider) - [AsyncLayoutInflater](https://developer.android.com/reference/android/support/v4/view/AsyncLayoutInflater) - [GestureDetectorCompat](https://developer.android.com/reference/android/support/v4/view/GestureDetectorCompat) - [GravityCompat](https://developer.android.com/reference/android/support/v4/view/GravityCompat) - [InputDeviceCompat](https://developer.android.com/reference/android/support/v4/view/InputDeviceCompat) - [LayoutInflaterCompat](https://developer.android.com/reference/android/support/v4/view/LayoutInflaterCompat) - [MarginLayoutParamsCompat](https://developer.android.com/reference/android/support/v4/view/MarginLayoutParamsCompat) - [MenuCompat](https://developer.android.com/reference/android/support/v4/view/MenuCompat) - [MenuItemCompat](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat) - [MotionEventCompat](https://developer.android.com/reference/android/support/v4/view/MotionEventCompat) - [NestedScrollingChildHelper](https://developer.android.com/reference/android/support/v4/view/NestedScrollingChildHelper) - [NestedScrollingParentHelper](https://developer.android.com/reference/android/support/v4/view/NestedScrollingParentHelper) - [PagerAdapter](https://developer.android.com/reference/android/support/v4/view/PagerAdapter) - [PagerTabStrip](https://developer.android.com/reference/android/support/v4/view/PagerTabStrip) - [PagerTitleStrip](https://developer.android.com/reference/android/support/v4/view/PagerTitleStrip) - [PointerIconCompat](https://developer.android.com/reference/android/support/v4/view/PointerIconCompat) - [ScaleGestureDetectorCompat](https://developer.android.com/reference/android/support/v4/view/ScaleGestureDetectorCompat) - [VelocityTrackerCompat](https://developer.android.com/reference/android/support/v4/view/VelocityTrackerCompat) - [ViewCompat](https://developer.android.com/reference/android/support/v4/view/ViewCompat) - [ViewConfigurationCompat](https://developer.android.com/reference/android/support/v4/view/ViewConfigurationCompat) - [ViewGroupCompat](https://developer.android.com/reference/android/support/v4/view/ViewGroupCompat) - [ViewPager](https://developer.android.com/reference/android/support/v4/view/ViewPager) - [ViewPager.LayoutParams](https://developer.android.com/reference/android/support/v4/view/ViewPager.LayoutParams) - [ViewPager.SavedState](https://developer.android.com/reference/android/support/v4/view/ViewPager.SavedState) - [ViewPager.SimpleOnPageChangeListener](https://developer.android.com/reference/android/support/v4/view/ViewPager.SimpleOnPageChangeListener) - [ViewParentCompat](https://developer.android.com/reference/android/support/v4/view/ViewParentCompat) - [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) - [ViewPropertyAnimatorListenerAdapter](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorListenerAdapter) - [WindowCompat](https://developer.android.com/reference/android/support/v4/view/WindowCompat) - [WindowInsetsCompat](https://developer.android.com/reference/android/support/v4/view/WindowInsetsCompat)