Most visited

Recently visited

Added in API level 23

ChooserTarget

public final class ChooserTarget
extends Object implements Parcelable

java.lang.Object
   ↳ android.service.chooser.ChooserTarget


一个ChooserTarget代表深层链接到应用程序中被返回的 ChooserTargetService

选择器目标代表暴露给用户选择的应用程序中的特定深度链接目标。 这可能是经常通过电子邮件发送的联系人,最近活动的群组消息会话,云存储应用中的文件夹,社交媒体服务上发布的相关项目集合或任何其他与上下文相关的目标应用+相关元数据分组。

选择器目标的创建者应该参考相关设计指南,了解他们正在呈现的目标类型。 例如,涉及人员的目标应该带有圆形图标。

Summary

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

Fields

CREATOR

Added in API level 23
Creator<ChooserTarget> CREATOR

Public constructors

ChooserTarget

Added in API level 23
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

Public methods

describeContents

Added in API level 23
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.

getComponentName

Added in API level 23
ComponentName getComponentName ()

返回应该为此ChooserTarget启动的Activity的ComponentName。

Returns
ComponentName the name of the target Activity to launch

getIcon

Added in API level 23
Icon getIcon ()

返回代表此目标的图标以显示给用户。 显示图标的UI可能会裁剪,调整大小或覆盖此图标。

Returns
Icon the icon representing this target, intended to be shown to a user

getIntentExtras

Added in API level 23
Bundle getIntentExtras ()

返回要添加到启动到此目标的意向的附加程序包。

Returns
Bundle the extras to merge with the extras of the intent being launched

getScore

Added in API level 23
float getScore ()

返回由此ChooserTarget的创建者提供的排名分数。 值在0.0f和1.0f之间。 显示目标的用户界面在分类和合并来自多个来源的目标时可能会考虑此分数。

Returns
float the ranking score for this target between 0.0f and 1.0f, inclusive

getTitle

Added in API level 23
CharSequence getTitle ()

返回此对象的标题以显示给用户。 显示标题的用户界面可能会截断此标题,因为它太长而无法完整显示。

Returns
CharSequence the title of this target, intended to be shown to a user

toString

Added in API level 23
String toString ()

返回对象的字符串表示形式。 通常, toString方法返回一个字符串,用于“文本地表示”该对象。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。

ObjecttoString方法将返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Returns
String a string representation of the object.

writeToParcel

Added in API level 23
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.

Hooray!