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:
Callback#onCreateActionMode(ActionMode, Menu)
once on initial creationCallback#onPrepareActionMode(ActionMode, Menu)
after creation and any time theActionMode
is invalidatedCallback#onActionItemClicked(ActionMode, MenuItem)
any time a contextual action button is clickedCallback#onDestroyActionMode(ActionMode)
when the action mode is closed
Summary
Public methods | |
---|---|
abstract Boolean |
onActionItemClicked(mode: ActionMode!, item: MenuItem!) Called to report a user click on an action button. |
abstract Boolean |
onCreateActionMode(mode: ActionMode!, : Menu!) Called when action mode is first created. |
abstract Unit |
onDestroyActionMode(mode: ActionMode!) Called when an action mode is about to be exited and destroyed. |
abstract Boolean |
onPrepareActionMode(mode: ActionMode!, : Menu!) Called to refresh an action mode's action menu whenever it is invalidated. |
Public methods
onActionItemClicked
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
abstract fun onCreateActionMode(
mode: ActionMode!,
: 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
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
abstract fun onPrepareActionMode(
mode: ActionMode!,
: 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. |