ActionMode

public abstract class ActionMode
extends Object

java.lang.Object
   ↳ androidx.appcompat.view.ActionMode


Represents a contextual mode of the user interface. Action modes can be used to provide alternative interaction modes and replace parts of the normal UI until finished. Examples of good action modes include text selection and contextual actions.

Developer Guides

For information about how to provide contextual actions with ActionMode, read the Menus developer guide.

Summary

Nested classes

interface ActionMode.Callback

Callback interface for action modes. 

Public constructors

ActionMode()

Public methods

abstract void finish()

Finish and close this action mode.

abstract View getCustomView()

Returns the current custom view for this action mode.

abstract Menu getMenu()

Returns the menu of actions that this action mode presents.

abstract MenuInflater getMenuInflater()

Returns a MenuInflater with the ActionMode's context.

abstract CharSequence getSubtitle()

Returns the current subtitle of this action mode.

Object getTag()

Retrieve the tag object associated with this ActionMode.

abstract CharSequence getTitle()

Returns the current title of this action mode.

boolean getTitleOptionalHint()
abstract void invalidate()

Invalidate the action mode and refresh menu content.

boolean isTitleOptional()
abstract void setCustomView(View view)

Set a custom view for this action mode.

abstract void setSubtitle(CharSequence subtitle)

Set the subtitle of the action mode.

abstract void setSubtitle(int resId)

Set the subtitle of the action mode.

void setTag(Object tag)

Set a tag object associated with this ActionMode.

abstract void setTitle(CharSequence title)

Set the title of the action mode.

abstract void setTitle(int resId)

Set the title of the action mode.

void setTitleOptionalHint(boolean titleOptional)

Set whether or not the title/subtitle display for this action mode is optional.

Inherited methods

Public constructors

ActionMode

public ActionMode ()

Public methods

finish

public abstract void finish ()

Finish and close this action mode. The action mode's ActionMode.Callback will have its ActionMode.Callback.onDestroyActionMode(ActionMode) method called.

getCustomView

public abstract View getCustomView ()

Returns the current custom view for this action mode.

Returns
View The current custom view

getMenu

public abstract Menu getMenu ()

Returns the menu of actions that this action mode presents.

Returns
Menu The action mode's menu.

getMenuInflater

public abstract MenuInflater getMenuInflater ()

Returns a MenuInflater with the ActionMode's context.

Returns
MenuInflater

getSubtitle

public abstract CharSequence getSubtitle ()

Returns the current subtitle of this action mode.

Returns
CharSequence Subtitle text

getTag

public Object getTag ()

Retrieve the tag object associated with this ActionMode.

Like the tag available to views, this allows applications to associate arbitrary data with an ActionMode for later reference.

Returns
Object Tag associated with this ActionMode

See also:

getTitle

public abstract CharSequence getTitle ()

Returns the current title of this action mode.

Returns
CharSequence Title text

getTitleOptionalHint

public boolean getTitleOptionalHint ()

R