added in version 22.1.0
belongs to Maven artifact com.android.support:appcompat-v7:28.0.0-alpha1

ActionMode.Callback

This package is part of the Android support library which is no longer maintained. The support library has been superseded by AndroidX which is part of Jetpack. We recommend using the AndroidX libraries in all new projects. You should also consider migrating existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library class mappings.

public static interface ActionMode.Callback

android.support.v7.view.ActionMode.Callback

---

Callback interface for action modes. Supplied to startSupportActionMode(Callback) (Callback)}, a Callback configures and handles events raised by a user's interaction with an action mode.

An action mode's lifecycle is as follows:

• onCreateActionMode(ActionMode, Menu) once on initial creation
• onPrepareActionMode(ActionMode, Menu) after creation and any time the ActionMode is invalidated
• onActionItemClicked(ActionMode, MenuItem) any time a contextual action button is clicked
• onDestroyActionMode(ActionMode) when the action mode is closed

Summary

Public methods
abstract boolean	onActionItemClicked(ActionMode mode, MenuItem item) Called to report a user click on an action button.
abstract boolean	onCreateActionMode(ActionMode mode, Menu menu) Called when action mode is first created.
abstract void	onDestroyActionMode(ActionMode mode) Called when an action mode is about to be exited and destroyed.
abstract boolean	onPrepareActionMode(ActionMode mode, Menu menu) Called to refresh an action mode's action menu whenever it is invalidated.

Public methods

onActionItemClicked

added in version 22.1.0

boolean onActionItemClicked (ActionMode mode, 
                MenuItem item)

Called to report a user click on an action button.

Parameters
mode	ActionMode: The current ActionMode
item	MenuItem: The item that was clicked

Returns
boolean	true if this callback handled the event, false if the standard MenuItem invocation should continue.

onCreateActionMode

added in version 22.1.0

boolean onCreateActionMode (ActionMode mode, 
                Menu menu)

Called when action mode is first created. The menu supplied will be used to generate action buttons for the action mode.

Parameters
mode	ActionMode: ActionMode being created
menu	Menu: Menu used to populate action buttons

Returns
boolean	true if the action mode should be created, false if entering this mode should be aborted.

onDestroyActionMode

added in version 22.1.0

void onDestroyActionMode (ActionMode mode)

Called when an action mode is about to be exited and destroyed.

Parameters
mode	ActionMode: The current ActionMode being destroyed

onPrepareActionMode

added in version 22.1.0

boolean onPrepareActionMode (ActionMode mode, 
                Menu menu)

Called to refresh an action mode's action menu whenever it is invalidated.

Parameters
mode	ActionMode: ActionMode being prepared
menu	Menu: Menu used to populate action buttons

Returns
boolean	true if the menu or action mode was updated, false otherwise.

• Interfaces

  • ActionMode.Callback
  • CollapsibleActionView

• Classes

  • ActionMode
  • ContextThemeWrapper