Most visited

Recently visited

ActionMode

public abstract class ActionMode
extends Object

java.lang.Object
   ↳ android.support.v7.view.ActionMode


表示用户界面的上下文模式。 动作模式可用于提供替代交互模式,并替换部分正常UI直到完成。 良好的行动模式的例子包括文本选择和上下文动作。

Developer Guides

有关如何使用 ActionMode提供上下文操作的 ActionMode ,请阅读 Menus开发人员指南。

Summary

Nested classes

interface ActionMode.Callback

操作模式的回调界面。

Public constructors

ActionMode()

Public methods

abstract void finish()

完成并关闭此操作模式。

abstract View getCustomView()

返回此操作模式的当前自定义视图。

abstract Menu getMenu()

返回此操作模式呈现的操作菜单。

abstract MenuInflater getMenuInflater()

使用ActionMode的上下文返回 MenuInflater

abstract CharSequence getSubtitle()

返回此操作模式的当前副标题。

Object getTag()

检索与此ActionMode关联的标记对象。

abstract CharSequence getTitle()

返回此操作模式的当前标题。

boolean getTitleOptionalHint()
abstract void invalidate()

使操作模式和刷新菜单内容失效。

boolean isTitleOptional()
abstract void setCustomView(View view)

为此操作模式设置自定义视图。

abstract void setSubtitle(CharSequence subtitle)

设置动作模式的副标题。

abstract void setSubtitle(int resId)

设置动作模式的副标题。

void setTag(Object tag)

设置与此ActionMode关联的标签对象。

abstract void setTitle(CharSequence title)

设置操作模式的标题。

abstract void setTitle(int resId)

设置操作模式的标题。

void setTitleOptionalHint(boolean titleOptional)

设置此动作模式的标题/字幕显示是否可选。

Inherited methods

From class java.lang.Object

Public constructors

ActionMode

ActionMode ()

Public methods

finish

void finish ()

完成并关闭此操作模式。 操作模式ActionMode.Callback将调用onDestroyActionMode(ActionMode)方法。

getCustomView

View getCustomView ()

返回此操作模式的当前自定义视图。

Returns
View The current custom view

getMenu

Menu getMenu ()

返回此操作模式呈现的操作菜单。

Returns
Menu The action mode's menu.

getMenuInflater

MenuInflater getMenuInflater ()

使用ActionMode的上下文返回 MenuInflater

Returns
MenuInflater

getSubtitle

CharSequence getSubtitle ()

返回此操作模式的当前副标题。

Returns
CharSequence Subtitle text

getTag

Object getTag ()

检索与此ActionMode关联的标记对象。

与可用于视图的标记一样,这允许应用程序将任意数据与ActionMode关联以供日后参考。

Returns
Object Tag associated with this ActionMode

也可以看看:

getTitle

CharSequence getTitle ()

返回此操作模式的当前标题。

Returns
CharSequence Title text

getTitleOptionalHint

boolean getTitleOptionalHint ()

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

也可以看看:

invalidate

void invalidate ()

使操作模式和刷新菜单内容失效。 该模式的ActionMode.Callback将调用其onPrepareActionMode(ActionMode, Menu)方法。 如果它返回true,则会扫描菜单以获取更新的内容,并且任何相关的更改都会反映给用户。

isTitleOptional

boolean isTitleOptional ()

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

setCustomView

void setCustomView (View view)

为此操作模式设置自定义视图。 自定义视图将取代标题和副标题。 对搜索框等内容非常有用。

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

也可以看看:

setSubtitle

void setSubtitle (CharSequence subtitle)

设置动作模式的副标题。 如果已设置自定义视图,则此方法将不会有明显效果。

Parameters
subtitle CharSequence: Subtitle string to set

也可以看看:

setSubtitle

void setSubtitle (int resId)

设置动作模式的副标题。 如果已设置自定义视图,则此方法将不会有明显效果。

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

也可以看看:

setTag

void setTag (Object tag)

设置与此ActionMode关联的标签对象。

与可用于视图的标记一样,这允许应用程序将任意数据与ActionMode关联以供日后参考。

Parameters
tag Object: Tag to associate with this ActionMode

也可以看看:

setTitle

void setTitle (CharSequence title)

设置操作模式的标题。 如果已设置自定义视图,则此方法将不会有明显效果。

Parameters
title CharSequence: Title string to set

也可以看看:

setTitle

void setTitle (int resId)

设置操作模式的标题。 如果已设置自定义视图,则此方法将不会有明显效果。

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

也可以看看:

setTitleOptionalHint

void setTitleOptionalHint (boolean titleOptional)

设置此动作模式的标题/字幕显示是否可选。

在很多情况下,为动作模式提供的标题只是为了添加上下文,并不是动作模式必需的。 如果标题是可选的,系统可能会选择完全隐藏标题,而不是因缺少可用空间而截断标题。

请注意,这只是一个提示; 在某些情况下,底层实现可能会选择忽略此设置。

Parameters
titleOptional boolean: true if the title only presents optional information.

Hooray!