Android APIs
public abstract class

ActionMode

extends Object
java.lang.Object
   ↳ android.view.ActionMode

Class Overview

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. 
class ActionMode.Callback2 Extension of ActionMode.Callback to provide content rect information. 
Constants
int DEFAULT_HIDE_DURATION Default value to hide the action mode for getDefaultActionModeHideDuration().
int TYPE_FLOATING The action mode is treated as a Floating Toolbar.
int TYPE_PRIMARY The action mode is treated as a Primary mode.
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()
int getType()
Returns the type for this action mode.
void hide(long duration)
Hide the action mode view from obstructing the content below for a short duration.
abstract void invalidate()
Invalidate the action mode and refresh menu content.
void invalidateContentRect()
Invalidate the content rect associated to this ActionMode.
boolean isTitleOptional()
void onWindowFocusChanged(boolean hasWindowFocus)
Called when the window containing the view that started this action mode gains or loses focus.
abstract void setCustomView(View view)
Set a custom view for this action mode.
abstract void setSubtitle(int resId)
Set the subtitle of the action mode.
abstract void setSubtitle(CharSequence subtitle)
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.
void setType(int type)
Set a type for this action mode.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final int DEFAULT_HIDE_DURATION

Added in API level 23

Default value to hide the action mode for getDefaultActionModeHideDuration().

Constant Value: -1 (0xffffffff)

public static final int TYPE_FLOATING

Added in API level 23

The action mode is treated as a Floating Toolbar. Use with setType(int).

Constant Value: 1 (0x00000001)

public static final int TYPE_PRIMARY

Added in API level 23

The action mode is treated as a Primary mode. This is the default. Use with setType(int).

Constant Value: 0 (0x00000000)

Public Constructors

public ActionMode ()

Added in API level 11

Public Methods

public abstract void finish ()

Added in API level 11

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

public abstract View getCustomView ()

Added in API level 11

Returns the current custom view for this action mode.

Returns
  • The current custom view

public abstract Menu getMenu ()

Added in API level 11

Returns the menu of actions that this action mode presents.

Returns
  • The action mode's menu.

public abstract MenuInflater getMenuInflater ()

Added in API level 11

Returns a MenuInflater with the ActionMode's context.

public abstract CharSequence getSubtitle ()

Added in API level 11

Returns the current subtitle of this action mode.

Returns
  • Subtitle text

public Object getTag ()

Added in API level 14

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
  • Tag associated with this ActionMode
See Also

public abstract CharSequence getTitle ()

Added in API level 11

Returns the current title of this action mode.

Returns
  • Title text

public boolean getTitleOptionalHint ()

Added in API level 16

Returns
  • true if this action mode has been given a hint to consider the title/subtitle display to be optional.

public int getType ()

Added in API level 23

Returns the type for this action mode.

Returns

public void hide (long duration)

Added in API level 23

Hide the action mode view from obstructing the content below for a short duration. This only makes sense for action modes that support dynamic positioning on the screen. If this method is called again before the hide duration expires, the later hide call will cancel the former and then take effect. NOTE that there is an internal limit to how long the mode can be hidden for. It's typically about a few seconds.

Parameters
duration The number of milliseconds to hide for.

public abstract void invalidate ()

Added in API level 11

Invalidate the action mode and refresh menu content. The mode's ActionMode.Callback will have its onPrepareActionMode(ActionMode, Menu) method called. If it returns true the menu will be scanned for updated content and any relevant changes will be reflected to the user.

public void invalidateContentRect ()

Added in API level 23

Invalidate the content rect associated to this ActionMode. This only makes sense for action modes that support dynamic positioning on the screen, and provides a more efficient way to reposition it without invalidating the whole action mode.

See Also

public boolean isTitleOptional ()

Added in API level 16

Returns
  • true if this action mode considers the title and subtitle fields as optional. Optional titles may not be displayed to the user.

public void onWindowFocusChanged (boolean hasWindowFocus)

Added in API level 23

Called when the window containing the view that started this action mode gains or loses focus.

Parameters
hasWindowFocus True if the window containing the view that started this action mode now has focus, false otherwise.

public abstract void setCustomView (View view)

Added in API level 11

Set a custom view for this action mode. The custom view will take the place of the title and subtitle. Useful for things like search boxes.

Parameters
view Custom view to use in place of the title/subtitle.

public abstract void setSubtitle (int resId)

Added in API level 11

Set the subtitle of the action mode. This method will have no visible effect if a custom view has been set.

Parameters
resId Resource ID of a string to set as the subtitle

public abstract void setSubtitle (CharSequence subtitle)

Added in API level 11

Set the subtitle of the action mode. This method will have no visible effect if a custom view has been set.

Parameters
subtitle Subtitle string to set

public void setTag (Object tag)

Added in API level 14

Set a 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.

Parameters
tag Tag to associate with this ActionMode
See Also

public abstract void setTitle (CharSequence title)

Added in API level 11

Set the title of the action mode. This method will have no visible effect if a custom view has been set.

Parameters
title Title string to set

public abstract void setTitle (int resId)

Added in API level 11

Set the title of the action mode. This method will have no visible effect if a custom view has been set.

Parameters
resId Resource ID of a string to set as the title

public void setTitleOptionalHint (boolean titleOptional)

Added in API level 16

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

In many cases the supplied title for an action mode is merely meant to add context and is not strictly required for the action mode to be useful. If the title is optional, the system may choose to hide the title entirely rather than truncate it due to a lack of available space.

Note that this is merely a hint; the underlying implementation may choose to ignore this setting under some circumstances.

Parameters
titleOptional true if the title only presents optional information.

public void setType (int type)

Added in API level 23

Set a type for this action mode. This will affect how the system renders the action mode if it has to.

Parameters
type One of TYPE_PRIMARY or TYPE_FLOATING.