public final class ChooserTarget
extends Object implements Parcelable
| java.lang.Object | |
| ↳ | android.service.chooser.ChooserTarget |
一个ChooserTarget代表深层链接到应用程序中被返回的 ChooserTargetService 。
选择器目标代表暴露给用户选择的应用程序中的特定深度链接目标。 这可能是经常通过电子邮件发送的联系人，最近活动的群组消息会话，云存储应用中的文件夹，社交媒体服务上发布的相关项目集合或任何其他与上下文相关的目标应用+相关元数据分组。
选择器目标的创建者应该参考相关设计指南，了解他们正在呈现的目标类型。 例如，涉及人员的目标应该带有圆形图标。
Inherited constants |
|---|
 From interface android.os.Parcelable
|
Fields |
|
|---|---|
public static final Creator<ChooserTarget> |
CREATOR |
Public constructors |
|
|---|---|
ChooserTarget(CharSequence title, Icon icon, float score, ComponentName componentName, Bundle intentExtras) 通过选择器UI构建深层链接目标进行演示。 |
|
Public methods |
|
|---|---|
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
ComponentName |
getComponentName() 返回应该为此ChooserTarget启动的Activity的ComponentName。 |
Icon |
getIcon() 返回代表此目标的图标以显示给用户。 |
Bundle |
getIntentExtras() 返回要添加到启动到此目标的意向的附加程序包。 |
float |
getScore() 返回由此ChooserTarget的创建者提供的排名分数。 |
CharSequence |
getTitle() 返回此对象的标题以显示给用户。 |
String |
toString() 返回对象的字符串表示形式。 |
void |
writeToParcel(Parcel dest, int flags) 将此对象平铺到一个包裹中。 |
Inherited methods |
|
|---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
|
ChooserTarget (CharSequence title, Icon icon, float score, ComponentName componentName, Bundle intentExtras)
通过选择器UI构建深层链接目标进行演示。
目标由一个标题和一个图标组成，用于向用户呈现。 呈现此目标的用户界面可能会截断标题，如果标题太长而无法显示在可用空间中，则可能会裁剪，调整大小或覆盖提供的图标。
目标的创建者可能会提供评分。 假设这个分数与query提供的其他目标query 。 得分应该在0.0f（不太可能匹配）到1.0f（非常相关的匹配）的范围内。 一组目标的得分不需要总和为1。
ComponentName必须是创建者自己的包中的Activity组件的名称，或者是任何其他包中的导出组件。 您可以提供一个可选的Bundle extras，它会在发送到目标Activity之前合并到最终意图中; 使用它来添加有关目标活动将读取的深层链接的任何其他数据。 例如对话ID，电子邮件地址等
注意不要将自定义的 Parcelable类型放入附加软件包中，因为系统将无法对它们进行重新分析以合并它们。
| Parameters | |
|---|---|
title |
CharSequence: title of this target that will be shown to a user |
icon |
Icon: icon to represent this target |
score |
float: ranking score for this target between 0.0f and 1.0f, inclusive |
componentName |
ComponentName: Name of the component to be launched if this target is chosen |
intentExtras |
Bundle: Bundle of extras to merge with the extras of the launched intent |
int describeContents ()
描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如，如果对象将在writeToParcel(Parcel, int)的输出中包含writeToParcel(Parcel, int) ，则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR位。
| Returns | |
|---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
ComponentName getComponentName ()
返回应该为此ChooserTarget启动的Activity的ComponentName。
| Returns | |
|---|---|
ComponentName |
the name of the target Activity to launch |
Icon getIcon ()
返回代表此目标的图标以显示给用户。 显示图标的UI可能会裁剪，调整大小或覆盖此图标。
| Returns | |
|---|---|
Icon |
the icon representing this target, intended to be shown to a user |
Bundle getIntentExtras ()
返回要添加到启动到此目标的意向的附加程序包。
| Returns | |
|---|---|
Bundle |
the extras to merge with the extras of the intent being launched |
float getScore ()
返回由此ChooserTarget的创建者提供的排名分数。 值在0.0f和1.0f之间。 显示目标的用户界面在分类和合并来自多个来源的目标时可能会考虑此分数。
| Returns | |
|---|---|
float |
the ranking score for this target between 0.0f and 1.0f, inclusive |
CharSequence getTitle ()
返回此对象的标题以显示给用户。 显示标题的用户界面可能会截断此标题，因为它太长而无法完整显示。
| Returns | |
|---|---|
CharSequence |
the title of this target, intended to be shown to a user |
String toString ()
返回对象的字符串表示形式。 通常， toString方法返回一个字符串，用于“文本地表示”该对象。 结果应该是一个简洁但内容丰富的表述，对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object的toString方法将返回一个字符串，其中包含对象为实例的类的名称，符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示形式。 换句话说，这个方法返回一个字符串，其值等于：
getClass().getName() + '@' + Integer.toHexString(hashCode())
| Returns | |
|---|---|
String |
a string representation of the object. |
void writeToParcel (Parcel dest, int flags)
将此对象平铺到一个包裹中。
| Parameters | |
|---|---|
dest |
Parcel: The Parcel in which the object should be written. |
flags |
int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE. |
Android开发手册