public abstract class ActionMode
extends Object
| java.lang.Object | |
| ↳ | android.view.ActionMode |
表示用户界面的上下文模式。 动作模式可用于提供替代交互模式，并替换部分正常UI直到完成。 良好的行动模式的例子包括文本选择和上下文动作。
有关如何使用 ActionMode提供上下文操作的 ActionMode ，请阅读 Menus开发人员指南。
Nested classes |
|
|---|---|
interface |
ActionMode.Callback 操作模式的回调界面。 |
class |
ActionMode.Callback2 扩展 |
Constants |
|
|---|---|
int |
DEFAULT_HIDE_DURATION 用于隐藏 |
int |
TYPE_FLOATING 动作模式被视为浮动工具栏。 |
int |
TYPE_PRIMARY 操作模式被视为主模式。 |
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() |
int |
getType() 返回此操作模式的类型。 |
void |
hide(long duration) 隐藏动作模式视图，阻止短时间内的内容。 |
abstract void |
invalidate() 使操作模式和刷新菜单内容失效。 |
void |
invalidateContentRect() 使与此ActionMode关联的内容rect无效。 |
boolean |
isTitleOptional() |
void |
onWindowFocusChanged(boolean hasWindowFocus) 当包含启动此操作模式的视图的窗口获得或失去焦点时调用。 |
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) 设置此动作模式的标题/字幕显示是否可选。 |
void |
setType(int type) 为此操作模式设置一个类型。 |
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
int DEFAULT_HIDE_DURATION
用于隐藏 getDefaultActionModeHideDuration()的动作模式的默认值。
常量值：-1（0xffffffff）
int TYPE_FLOATING
动作模式被视为浮动工具栏。 与setType(int)使用。
常数值：1（0x00000001）
int TYPE_PRIMARY
操作模式被视为主模式。 这是默认设置。 与setType(int)使用。
常量值：0（0x00000000）
void finish ()
完成并关闭此操作模式。 动作模式ActionMode.Callback将调用onDestroyActionMode(ActionMode)方法。
View getCustomView ()
返回此操作模式的当前自定义视图。
| Returns | |
|---|---|
View |
The current custom view |
MenuInflater getMenuInflater ()
用ActionMode的上下文返回一个 MenuInflater 。
| Returns | |
|---|---|
MenuInflater |
|
CharSequence getSubtitle ()
返回此操作模式的当前副标题。
| Returns | |
|---|---|
CharSequence |
Subtitle text |
Object getTag ()
检索与此ActionMode关联的标记对象。
与可用于视图的标记一样，这允许应用程序将任意数据与ActionMode关联以供日后参考。
| Returns | |
|---|---|
Object |
Tag associated with this ActionMode |
也可以看看：
CharSequence getTitle ()
返回此操作模式的当前标题。
| Returns | |
|---|---|
CharSequence |
Title text |
boolean getTitleOptionalHint ()
| Returns | |
|---|---|
boolean |
true if this action mode has been given a hint to consider the title/subtitle display to be optional. |
int getType ()
返回此操作模式的类型。
| Returns | |
|---|---|
int |
One of TYPE_PRIMARY or TYPE_FLOATING. |
void hide (long duration)
隐藏动作模式视图，阻止短时间内的内容。 这仅适用于支持屏幕上动态定位的动作模式。 如果在隐藏持续时间到期之前再次调用此方法，稍后的隐藏调用将取消前者，然后生效。 请注意，该模式可以隐藏多长时间的内部限制。 通常是几秒钟。
| Parameters | |
|---|---|
duration |
long: The number of milliseconds to hide for. |
也可以看看：
void invalidate ()
使操作模式和刷新菜单内容失效。 该模式的ActionMode.Callback将调用其onPrepareActionMode(ActionMode, Menu)方法。 如果它返回true，则会扫描菜单以获取更新的内容，并且任何相关的更改都会反映给用户。
void invalidateContentRect ()
使与此ActionMode关联的内容rect无效。 这仅适用于支持屏幕上动态定位的动作模式，并提供更有效的方式重新定位，而不会使整个动作模式失效。
也可以看看：
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 onWindowFocusChanged (boolean hasWindowFocus)
当包含启动此操作模式的视图的窗口获得或失去焦点时调用。
| Parameters | |
|---|---|
hasWindowFocus |
boolean: True if the window containing the view that started this action mode now has focus, false otherwise. |
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. |
void setType (int type)
为此操作模式设置一个类型。 这将影响系统在必要时如何呈现动作模式。
| Parameters | |
|---|---|
type |
int: One of TYPE_PRIMARY or TYPE_FLOATING. |
Android开发手册