Added in API level 11

Callback


interface Callback
android.view.ActionMode.Callback

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
abstract Boolean

Called to report a user click on an action button.

abstract Boolean

Called when action mode is first created.

abstract Unit

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

abstract Boolean

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

Public methods

onActionItemClicked

Added in API level 11
abstract fun onActionItemClicked(
    mode: ActionMode!,
    item: MenuItem!
): Boolean

Called to report a user click on an action button.

Parameters
mode ActionMode!: The current ActionMode
item MenuItem!: The item that was clicked
Return
Boolean true if this callback handled the event, false if the standard MenuItem invocation should continue.

onCreateActionMode

Added in API level 11
abstract fun onCreateActionMode(
    mode: ActionMode!,
    menu: Menu!
): Boolean

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
Return
Boolean true if the action mode should be created, false if entering this mode should be aborted.

onDestroyActionMode

Added in API level 11
abstract fun onDestroyActionMode(mode: ActionMode!): Unit

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

Parameters
mode ActionMode!: The current ActionMode being destroyed

onPrepareActionMode

Added in API level 11
abstract fun onPrepareActionMode(
    mode: ActionMode!,
    menu: Menu!
): Boolean

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
Return
Boolean true if the menu or action mode was updated, false otherwise.