public abstract class ActionMode
extends Object
java.lang.Object | |
↳ | android.support.v7.view.ActionMode |
表示用户界面的上下文模式。 动作模式可用于提供替代交互模式,并替换部分正常UI直到完成。 良好的行动模式的例子包括文本选择和上下文动作。
有关如何使用 ActionMode
提供上下文操作的 ActionMode
,请阅读 Menus开发人员指南。
Nested classes |
|
---|---|
interface |
ActionMode.Callback 操作模式的回调界面。 |
Public constructors |
|
---|---|
ActionMode() |
Public methods |
|
---|---|
abstract void |
finish() 完成并关闭此操作模式。 |
abstract View |
getCustomView() 返回此操作模式的当前自定义视图。 |
abstract Menu |
getMenu() 返回此操作模式呈现的操作菜单。 |
abstract MenuInflater |
getMenuInflater() 使用ActionMode的上下文返回 |
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
|
ActionMode ()
MenuInflater getMenuInflater ()
使用ActionMode的上下文返回 MenuInflater
。
Returns | |
---|---|
MenuInflater |
Object getTag ()
检索与此ActionMode关联的标记对象。
与可用于视图的标记一样,这允许应用程序将任意数据与ActionMode关联以供日后参考。
Returns | |
---|---|
Object |
Tag associated with this ActionMode |
也可以看看:
boolean getTitleOptionalHint ()
Returns | |
---|---|
boolean |
true if this action mode has been given a hint to consider the title/subtitle display to be optional. |
void invalidate ()
使操作模式和刷新菜单内容失效。 该模式的ActionMode.Callback
将调用其onPrepareActionMode(ActionMode, Menu)
方法。 如果它返回true,则会扫描菜单以获取更新的内容,并且任何相关的更改都会反映给用户。
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. |
void setCustomView (View view)
为此操作模式设置自定义视图。 自定义视图将取代标题和副标题。 对搜索框等内容非常有用。
Parameters | |
---|---|
view |
View : Custom view to use in place of the title/subtitle. |
void setSubtitle (CharSequence subtitle)
设置动作模式的副标题。 如果已设置自定义视图,则此方法将不会有明显效果。
Parameters | |
---|---|
subtitle |
CharSequence : Subtitle string to set |
void setSubtitle (int resId)
设置动作模式的副标题。 如果已设置自定义视图,则此方法将不会有明显效果。
Parameters | |
---|---|
resId |
int : Resource ID of a string to set as the subtitle |
void setTag (Object tag)
设置与此ActionMode关联的标签对象。
与可用于视图的标记一样,这允许应用程序将任意数据与ActionMode关联以供日后参考。
Parameters | |
---|---|
tag |
Object : Tag to associate with this ActionMode |
也可以看看:
void setTitle (CharSequence title)
设置操作模式的标题。 如果已设置自定义视图,则此方法将不会有明显效果。
Parameters | |
---|---|
title |
CharSequence : Title string to set |
也可以看看:
void setTitle (int resId)
设置操作模式的标题。 如果已设置自定义视图,则此方法将不会有明显效果。
Parameters | |
---|---|
resId |
int : Resource ID of a string to set as the title |
void setTitleOptionalHint (boolean titleOptional)
设置此动作模式的标题/字幕显示是否可选。
在很多情况下,为动作模式提供的标题只是为了添加上下文,并不是动作模式必需的。 如果标题是可选的,系统可能会选择完全隐藏标题,而不是因缺少可用空间而截断标题。
请注意,这只是一个提示; 在某些情况下,底层实现可能会选择忽略此设置。
Parameters | |
---|---|
titleOptional |
boolean : true if the title only presents optional information. |