public static final class Notification.Action.WearableExtender
extends Object
implements Notification.Action.Extender
java.lang.Object | |
↳ | android.app.Notification.Action.WearableExtender |
用于通知操作的可穿戴扩展器。 为了扩展添加到一个动作,创建一个新的Notification.Action.WearableExtender
使用对象WearableExtender()
构造函数,并将其应用到Notification.Action.Builder
使用extend(Notification.Action.Extender)
。
Notification.Action action = new Notification.Action.Builder( R.drawable.archive_all, "Archive all", actionIntent) .extend(new Notification.Action.WearableExtender() .setAvailableOffline(false)) .build();
Public constructors |
|
---|---|
Notification.Action.WearableExtender() 使用默认选项创建一个 |
|
Notification.Action.WearableExtender(Notification.Action action) 通过阅读现有通知操作中的可穿戴选项来创建 |
Public methods |
|
---|---|
Notification.Action.WearableExtender |
clone() 创建并返回此对象的副本。 |
Notification.Action.Builder |
extend(Notification.Action.Builder builder) 将可穿戴扩展应用于正在构建的通知操作。 |
CharSequence |
getCancelLabel() 获取要显示的标签以取消操作。 |
CharSequence |
getConfirmLabel() 获取要显示的标签以确认该操作应该执行。 |
boolean |
getHintLaunchesActivity() 得到一个提示,这个动作将直接启动一个 |
CharSequence |
getInProgressLabel() 在可穿戴设备准备自动执行操作时获取标签以显示。 |
boolean |
isAvailableOffline() 获取当可穿戴设备未连接到配套设备时此操作是否可用。 |
Notification.Action.WearableExtender |
setAvailableOffline(boolean availableOffline) 设置当可穿戴设备未连接到配套设备时,此操作是否可用。 |
Notification.Action.WearableExtender |
setCancelLabel(CharSequence label) 设置要显示的标签以取消操作。 |
Notification.Action.WearableExtender |
setConfirmLabel(CharSequence label) 设置要显示的标签以确认应执行操作。 |
Notification.Action.WearableExtender |
setHintLaunchesActivity(boolean hintLaunchesActivity) 设置一个提示,表示此操作将直接启动 |
Notification.Action.WearableExtender |
setInProgressLabel(CharSequence label) 在可穿戴设备准备自动执行操作时设置一个标签以显示。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.app.Notification.Action.Extender
|
Notification.Action.WearableExtender ()
使用默认选项创建一个 Notification.Action.WearableExtender
。
Notification.Action.WearableExtender (Notification.Action action)
通过阅读现有通知操作中的可穿戴选项来创建 Notification.Action.WearableExtender
。
Parameters | |
---|---|
action |
Notification.Action : the notification action to inspect. |
Notification.Action.WearableExtender clone ()
创建并返回此对象的副本。 “复制”的确切含义可能取决于对象的类别。 一般意图是,对于任何对象x
,表达式:
will be true, and that the expression:x.clone() != x
will bex.clone().getClass() == x.getClass()
true
, but these are not absolute requirements. While it is typically the case that:
will bex.clone().equals(x)
true
, this is not an absolute requirement.
按照惯例,返回的对象应该通过调用super.clone
来获得。 如果一个类和它的所有超类( Object
除外)都遵守这个约定,那么情况就是x.clone().getClass() == x.getClass()
。
按照惯例,这个方法返回的对象应该独立于这个对象(被克隆)。 要实现这种独立性,可能需要在返回super.clone
之前修改返回的对象的一个或多个字段。 通常,这意味着复制包含被克隆对象的内部“深层结构”的任何可变对象,并将这些对象的引用替换为对这些副本的引用。 如果一个类仅包含原始字段或对不可变对象的引用,那么通常情况下不需要修改由super.clone
返回的对象中的字段。
类Object
的方法clone
执行特定的克隆操作。 首先,如果该对象的类没有实现接口Cloneable
,则引发CloneNotSupportedException
。 请注意,所有阵列都被视为实现接口Cloneable
并且阵列类型T[]
的clone
方法的返回类型为T[]
,其中T是任何引用或基本类型。 否则,此方法创建该对象的类的新实例,并使用该对象的相应字段的内容来初始化其所有字段,就像通过赋值一样; 这些字段的内容本身并不克隆。 因此,此方法执行此对象的“浅拷贝”,而不是“深拷贝”操作。
类 Object
本身并不实现接口 Cloneable
,所以在类为 Object
的对象上调用 clone
方法将导致在运行时抛出异常。
Returns | |
---|---|
Notification.Action.WearableExtender |
a clone of this instance. |
Notification.Action.Builder extend (Notification.Action.Builder builder)
将可穿戴扩展应用于正在构建的通知操作。 这通常由extend(Notification.Action.Extender)
方法Notification.Action.Builder
。
Parameters | |
---|---|
builder |
Notification.Action.Builder : the builder to be modified. |
Returns | |
---|---|
Notification.Action.Builder |
the build object for chaining. |
CharSequence getCancelLabel ()
获取要显示的标签以取消操作。 这通常是一个命令式的动词,如“取消”。
Returns | |
---|---|
CharSequence |
the label to display to cancel the action |
CharSequence getConfirmLabel ()
获取要显示的标签以确认该操作应该执行。 这通常是命令式动词,如“发送”。
Returns | |
---|---|
CharSequence |
the label to confirm the action should be executed |
boolean getHintLaunchesActivity ()
Activity
此操作将直接启动 Activity
,告诉平台它可以生成适当的转换
Returns | |
---|---|
boolean |
true if the content intent will launch an activity and transitions should be generated, false otherwise. The default value is false if this was never set. |
CharSequence getInProgressLabel ()
在可穿戴设备准备自动执行操作时获取标签以显示。 这通常是一个'ing'动词,以省略号结束,如“正在发送...”
Returns | |
---|---|
CharSequence |
the label to display while the action is being prepared to execute |
boolean isAvailableOffline ()
获取当可穿戴设备未连接到配套设备时此操作是否可用。 当可穿戴设备离线时,用户仍然可以触发此操作,但视觉提示将指示该操作可能不可用。 默认为true。
Returns | |
---|---|
boolean |
Notification.Action.WearableExtender setAvailableOffline (boolean availableOffline)
设置当可穿戴设备未连接到配套设备时,此操作是否可用。 当可穿戴设备离线时,用户仍然可以触发此操作,但视觉提示将指示该操作可能不可用。 默认为true。
Parameters | |
---|---|
availableOffline |
boolean
|
Returns | |
---|---|
Notification.Action.WearableExtender |
Notification.Action.WearableExtender setCancelLabel (CharSequence label)
设置要显示的标签以取消操作。 这通常是命令式动词,如“取消”。
Parameters | |
---|---|
label |
CharSequence : the label to display to cancel the action |
Returns | |
---|---|
Notification.Action.WearableExtender |
this object for method chaining |
Notification.Action.WearableExtender setConfirmLabel (CharSequence label)
设置要显示的标签以确认应执行操作。 这通常是命令式动词,如“发送”。
Parameters | |
---|---|
label |
CharSequence : the label to confirm the action should be executed |
Returns | |
---|---|
Notification.Action.WearableExtender |
this object for method chaining |
Notification.Action.WearableExtender setHintLaunchesActivity (boolean hintLaunchesActivity)
设置一个提示,即此操作将直接启动 Activity
,告诉平台它可以生成适当的转换。
Parameters | |
---|---|
hintLaunchesActivity |
boolean : true if the content intent will launch an activity and transitions should be generated, false otherwise. |
Returns | |
---|---|
Notification.Action.WearableExtender |
this object for method chaining |
Notification.Action.WearableExtender setInProgressLabel (CharSequence label)
在可穿戴设备准备自动执行操作时设置一个标签以显示。 这通常是一个'ing'动词,以省略号结束,如“正在发送...”
Parameters | |
---|---|
label |
CharSequence : the label to display while the action is being prepared to execute |
Returns | |
---|---|
Notification.Action.WearableExtender |
this object for method chaining |