Stay organized with collections
Save and categorize content based on your preferences.
ActionMode.Callback
public
static
interface
ActionMode.Callback
| android.view.ActionMode.Callback
|
Known indirect subclasses
|
Callback interface for action modes. Supplied to
View.startActionMode(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:
Summary
Public methods
onActionItemClicked
public abstract 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
public abstract 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
public abstract 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
public abstract 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. |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-10 UTC."],[],[],null,["# ActionMode.Callback\n\nAdded in [API level 11](/guide/topics/manifest/uses-sdk-element#ApiLevels) \nSummary: [Methods](#pubmethods) \n\nActionMode.Callback\n===================\n\n*** ** * ** ***\n\n[Kotlin](/reference/kotlin/android/view/ActionMode.Callback \"View this page in Kotlin\") \\|Java\n\n\n`\npublic\nstatic\n\n\ninterface\nActionMode.Callback\n`\n\n\n`\n\n\n`\n\n|----------------------------------|\n| android.view.ActionMode.Callback |\n\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Known indirect subclasses [AbsListView.MultiChoiceModeListener](/reference/android/widget/AbsListView.MultiChoiceModeListener), [ActionMode.Callback2](/reference/android/view/ActionMode.Callback2) |------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------| | [AbsListView.MultiChoiceModeListener](/reference/android/widget/AbsListView.MultiChoiceModeListener) | A MultiChoiceModeListener receives events for [AbsListView.CHOICE_MODE_MULTIPLE_MODAL](/reference/android/widget/AbsListView#CHOICE_MODE_MULTIPLE_MODAL). | | [ActionMode.Callback2](/reference/android/view/ActionMode.Callback2) | Extension of [ActionMode.Callback](/reference/android/view/ActionMode.Callback) to provide content rect information. | |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nCallback interface for action modes. Supplied to\n[View.startActionMode(Callback)](/reference/android/view/View#startActionMode(android.view.ActionMode.Callback)), a Callback\nconfigures and handles events raised by a user's interaction with an action mode.\n\nAn action mode's lifecycle is as follows:\n\n- [Callback.onCreateActionMode(ActionMode, Menu)](/reference/android/view/ActionMode.Callback#onCreateActionMode(android.view.ActionMode,%20android.view.Menu)) once on initial creation\n- [Callback.onPrepareActionMode(ActionMode, Menu)](/reference/android/view/ActionMode.Callback#onPrepareActionMode(android.view.ActionMode,%20android.view.Menu)) after creation and any time the [ActionMode](/reference/android/view/ActionMode) is invalidated\n- [Callback.onActionItemClicked(ActionMode, MenuItem)](/reference/android/view/ActionMode.Callback#onActionItemClicked(android.view.ActionMode,%20android.view.MenuItem)) any time a contextual action button is clicked\n- [Callback.onDestroyActionMode(ActionMode)](/reference/android/view/ActionMode.Callback#onDestroyActionMode(android.view.ActionMode)) when the action mode is closed\n\n\u003cbr /\u003e\n\nSummary\n-------\n\n| ### Public methods ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` abstract boolean` | ` `[onActionItemClicked](/reference/android/view/ActionMode.Callback#onActionItemClicked(android.view.ActionMode,%20android.view.MenuItem))`(`[ActionMode](/reference/android/view/ActionMode)` mode, `[MenuItem](/reference/android/view/MenuItem)` item) ` Called to report a user click on an action button. |\n| ` abstract boolean` | ` `[onCreateActionMode](/reference/android/view/ActionMode.Callback#onCreateActionMode(android.view.ActionMode,%20android.view.Menu))`(`[ActionMode](/reference/android/view/ActionMode)` mode, `[Menu](/reference/android/view/Menu)` menu) ` Called when action mode is first created. |\n| ` abstract void` | ` `[onDestroyActionMode](/reference/android/view/ActionMode.Callback#onDestroyActionMode(android.view.ActionMode))`(`[ActionMode](/reference/android/view/ActionMode)` mode) ` Called when an action mode is about to be exited and destroyed. |\n| ` abstract boolean` | ` `[onPrepareActionMode](/reference/android/view/ActionMode.Callback#onPrepareActionMode(android.view.ActionMode,%20android.view.Menu))`(`[ActionMode](/reference/android/view/ActionMode)` mode, `[Menu](/reference/android/view/Menu)` menu) ` Called to refresh an action mode's action menu whenever it is invalidated. |\n\nPublic methods\n--------------\n\n### onActionItemClicked\n\nAdded in [API level 11](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic abstract boolean onActionItemClicked (ActionMode mode, \n MenuItem item)\n```\n\nCalled to report a user click on an action button.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|--------|----------------------------------------------|\n| `mode` | `ActionMode`: The current ActionMode \u003cbr /\u003e |\n| `item` | `MenuItem`: The item that was clicked \u003cbr /\u003e |\n\n| Returns ||\n|-----------|------------------------------------------------------------------------------------------------------------|\n| `boolean` | true if this callback handled the event, false if the standard MenuItem invocation should continue. \u003cbr /\u003e |\n\n### onCreateActionMode\n\nAdded in [API level 11](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic abstract boolean onCreateActionMode (ActionMode mode, \n Menu menu)\n```\n\nCalled when action mode is first created. The menu supplied will be used to\ngenerate action buttons for the action mode.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|--------|-----------------------------------------------------|\n| `mode` | `ActionMode`: ActionMode being created \u003cbr /\u003e |\n| `menu` | `Menu`: Menu used to populate action buttons \u003cbr /\u003e |\n\n| Returns ||\n|-----------|--------------------------------------------------------------------------------------------------|\n| `boolean` | true if the action mode should be created, false if entering this mode should be aborted. \u003cbr /\u003e |\n\n### onDestroyActionMode\n\nAdded in [API level 11](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic abstract void onDestroyActionMode (ActionMode mode)\n```\n\nCalled when an action mode is about to be exited and destroyed.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|--------|-------------------------------------------------------------|\n| `mode` | `ActionMode`: The current ActionMode being destroyed \u003cbr /\u003e |\n\n### onPrepareActionMode\n\nAdded in [API level 11](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic abstract boolean onPrepareActionMode (ActionMode mode, \n Menu menu)\n```\n\nCalled to refresh an action mode's action menu whenever it is invalidated.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|--------|-----------------------------------------------------|\n| `mode` | `ActionMode`: ActionMode being prepared \u003cbr /\u003e |\n| `menu` | `Menu`: Menu used to populate action buttons \u003cbr /\u003e |\n\n| Returns ||\n|-----------|----------------------------------------------------------------------|\n| `boolean` | true if the menu or action mode was updated, false otherwise. \u003cbr /\u003e |"]]
