鸿蒙OS Intent

Intent

java.lang.Object

|---ohos.aafwk.content.Intent

public class Intent
extends Object
implements Sequenceable, Cloneable

提供要执行的操作的抽象描述。

意图是系统的基本通信组件。 它封装了方法调用的意图和参数。Intent可以在Ability.startAbility(Intent)中使用来启动一个Ability。 系统在 Intent 类中定义了多种标准的意图动作和类别常量。

• operation -- 封装与 Intent 相关的特定参数和操作。
• parameters -- 指示传递给ability的附加参数。

How to Use Intent

可以通过两种方式调用 Intent。 您可以在 Intent 中指ability的完全限定名称来启动特定应用程序的指定ability，或者在 Intent 的操作属性中设置属性来启动符合指定属性设置的应用程序。

嵌套类摘要

修饰符和类型	类	描述
static class	Intent.OperationBuilder	用于创建操作实例的生成器类。

从接口 ohos.utils.Sequenceable 继承的嵌套类/接口
Sequenceable.Producer<T>

字段摘要

修饰符和类型	字段	描述
static String	[ACTION_BOOK_FLIGHT]	表示预订航班的操作。
static String	[ACTION_BOOK_HOTEL]	表示预订酒店的操作。
static String	[ACTION_BOOK_TRAIN_TICKET]	表示预订火车票的动作。
static String	[ACTION_BUNDLE_ADD]	指示安装包的操作。
static String	ACTION_BUNDLE_REMOVE	表示卸载捆绑包的操作。
static String	ACTION_BUNDLE_UPDATE	指示更新捆绑包的操作。
static String	ACTION_BUY	表示购物的动作。
static String	ACTION_BUY_TAKEOUT	表示点外卖的动作。
static String	ACTION_HOME	表示回家的动作。
static String	ACTION_LOCALE_CHANGED	表示区域设置已更改。
static String	ACTION_ORDER_TAXI	指示预订出租车的操作。
static String	ACTION_PLAN_ROUTE	查询路由的动作。
static String	ACTION_PLAY	表示播放媒体项的动作。
static String	ACTION_QUERY_ALMANC	表示查询中国历书的动作。
static String	ACTION_QUERY_CONSTELLATION_FORTUNE	表示查询星座的动作。
static String	ACTION_QUERY_ENCYCLOPEDIA	表示查询百科全书的动作。
static String	ACTION_QUERY_JOKE	表示读笑话的动作。
static String	ACTION_QUERY_LOGISTICS_INFO	指示跟踪货件状态的操作。
static String	ACTION_QUERY_NEWS	表示浏览新闻的动作。
static String	ACTION_QUERY_POI_INFO	表示查询附近地点的动作。
static String	ACTION_QUERY_RECIPE	表示搜索菜谱的动作。
static String	ACTION_QUERY_SPORTS_INFO	表示查询运动队和比赛日程的动作。
static String	ACTION_QUERY_STOCK_INFO	表示查询股市行情的动作。
static String	ACTION_QUERY_TRAFFIC_RESTRICTION	查询禁驾行为。
static String	ACTION_QUERY_TRAVELLING_GUIDELINE	表示查询旅游指南的动作。
static String	ACTION_QUERY_WEATHER	表示查询天气的动作。
static String	ACTION_SEND_LOGISTICS	表示发送捆绑包的操作。
static String	ACTION_TRANSLATE_TEXT	表示翻译文本的动作。
static String	ACTION_WATCH_VIDEO_CLIPS	表示观看视频剪辑的动作。
static int	CLONE_ACTION	表示将复制操作属性。
static int	CLONE_BORDERS_RECT	指示将复制 BORDERS_RECT 属性。
static int	CLONE_BUNDLE	表示将复制捆绑属性。
static int	CLONE_ELEMENT	表示将复制元素属性。
static int	CLONE_ENTITIES	指示将复制实体属性。
static int	CLONE_PICKER	表示将复制选取器属性。
static int	CLONE_URI	表示将复制 uri 属性。
static String	ENTITY_HOME	指示主屏幕类别。
static String	ENTITY_VIDEO	表示视频类别。
static int	FLAG_ABILITY_CLEAR_MISSION	表示清除其他任务的操作。
static int	FLAG_ABILITY_CONTINUATION	确定是否可以将本地设备上的功能迁移到远程设备。
static int	FLAG_ABILITY_FORM_ENABLED	指定是否启动技能。
static int	FLAG_ABILITY_FORWARD_RESULT	将结果返回给源ability。
static int	FLAG_ABILITY_MISSION_TOP	表示如果现有的启动ability实例已经在任务堆栈的顶部，它将被重用。
static int	FLAG_ABILITY_NEW_MISSION	表示在历史任务栈上创建任务的操作。
static int	FLAG_ABILITYSLICE_FORWARD_RESULT	将结果返回到源ability切片。
static int	FLAG_ABILITYSLICE_MULTI_DEVICE	支持分布式调度系统中的多设备启动。
static int	FLAG_INSTALL_ON_DEMAND	如果未安装，请安装指定ability。
static int	FLAG_INSTALL_WITH_BACKGROUND_MODE	如果未安装，请使用后台模式安装指定的功能。
static int	FLAG_NOT_OHOS_COMPONENT	指定组件是否不属于 OHOS。
static int	FLAG_START_FOREGROUND_ABILITY	表示无论宿主应用程序是否已启动，都将启动使用服务模板的功能。
static Sequenceable.Producer<Intent>	PRODUCER	从 Parcel 创建一个 Intent 实例。

构造函数摘要

构造函数	描述
Intent()	用于创建空 Intent 实例的构造函数。
Intent(Intent intent)	用于使用现有 Intent 对象的参数创建 Intent 实例的构造函数。

方法总结

修饰符和类型	方法	描述
Intent	addEntity(String entity)	已弃用。 此更改从 API 版本 5 开始生效。由 OperationBuilder#withEntities(Set) 替换。
Intent	addFlags(int flags)	将标志添加到 Intent。
Object	clone()	克隆此 Intent 对象。
int	cloneByIntent(Intent other, int flags)	复制指定 Intent 的属性。
Intent	cloneOperation()	创建一个仅包含此 Intent 的操作组件的 Intent 对象。
int	countEntities()	获取 Intent 中的实体数。
static Intent	createSelectIntent(Intent target, CharSequence title)	创建一个 Intent 实例，该实例旨在根据指定的 Intent 对象打开应用程序选择对话框。
boolean	equals(Object other)	指示其他对象是否“等于”这个对象。
static String	formatMimeType(String mimeType)	格式化指定 MIME 类型的数据。
Intent	formatType(String type)	格式化指定的 MIME 类型。
Intent	formatUri(Uri uri)	格式化指定的 URI。
Intent	formatUriAndType(Uri uri, String type)	格式化指定的 URI 和 MIME 类型。
String	getAction()	获取 Intent 中动作的描述。
boolean[]	getBooleanArrayParam(String key)	获取与给定键匹配的布尔数组。
boolean	getBooleanParam(String key, boolean defaultValue)	获取与给定键匹配的布尔值。
Rect	getBordersRect()	获取此 Intent 的bordersRect 属性。
String	getBundle()	获取 Intent 中指定的包的名称。
byte[]	getByteArrayParam(String key)	获取与给定键匹配的字节类型数组。
byte	getByteParam(String key, byte defaultValue)	获取与给定键匹配的字节类型值。
char[]	getCharArrayParam(String key)	获取与给定键匹配的字符数组。
char	getCharParam(String key, char defaultValue)	获取与给定键匹配的 char 值。
ArrayList<CharSequence>	getCharSequenceArrayListParam(String key)	获取与给定键匹配的 CharSequence 元素的 ArrayList 参数值。
CharSequence[]	getCharSequenceArrayParam(String key)	获取与给定键匹配的 CharSequence 数组。
CharSequence	getCharSequenceParam(String key)	获取与指定键匹配的 CharSequence 值。
double[]	getDoubleArrayParam(String key)	获取与给定键匹配的双精度数组。
double	getDoubleParam(String key, double defaultValue)	获取与给定键匹配的双精度值。
ElementName	getElement()	获取 Intent 中 ElementName 对象的描述。
Set<String>	getEntities()	获取 Intent 中所有实体的描述。
int	getFlags()	获取 Intent 中标志的描述。
float[]	getFloatArrayParam(String key)	获取与给定键匹配的浮点数组。
float	getFloatParam(String key, float defaultValue)	获取与给定键匹配的浮点值。
int[]	getIntArrayParam(String key)	获取与给定键匹配的 int 数组。
ArrayList<Integer>	getIntegerArrayListParam(String key)	获取与给定键匹配的 Integer 元素的 ArrayList 参数值。
int	getIntParam(String key, int defaultValue)	获取与给定键匹配的 int 值。
long[]	getLongArrayParam(String key)	获取与给定键匹配的长数组。
long	getLongParam(String key, long defaultValue)	获取与给定键匹配的长值。
Operation	getOperation()	获取 Intent 中操作的描述。
IntentParams	getParam(String key)	获取与给定键匹配的 IntentParams 值。
IntentParams	getParams()	获取Intent中IntentParams对象的描述。
<T extends Sequenceable>ArrayList<T>	getParcelableArrayListParam(String key)	已弃用。 此更改从 API 版本 5 开始生效。替换为 getSequenceableArrayListParam(java.lang.String)
Sequenceable[]	getParcelableArrayParam(String key)	已弃用。 此更改从 API 版本 5 开始生效。替换为 getSequenceableArrayParam(java.lang.String)
<T extends Sequenceable>T	getParcelableParam(String key)	已弃用。 此更改从 API 版本 5 开始生效。替换为 getSequenceableParam(java.lang.String)
Intent	getPicker()	获取此 Intent 中选取器 Intent 的描述。
String	getScheme()	获取此 Intent 中 URI 方案的描述。
<T extends Sequenceable>ArrayList<T>	getSequenceableArrayListParam(String key)	获取与给定键匹配的 Sequenceable 元素的 ArrayList 参数值。
Sequenceable[]	getSequenceableArrayParam(String key)	获取与给定键匹配的 Sequenceable 数组。
<T extends Sequenceable>T	getSequenceableParam(String key)	获取与指定键匹配的 Sequenceable 值。
<T extends Serializable>T	getSerializableParam(String key)	获取与给定键匹配的 Serializable 参数值。
short[]	getShortArrayParam(String key)	获取与给定键匹配的短数组。
short	getShortParam(String key, short defaultValue)	获取与给定键匹配的短值。
ArrayList<String>	getStringArrayListParam(String key)	获取与给定键匹配的字符串元素的 ArrayList 参数值。
String[]	getStringArrayParam(String key)	获取与给定键匹配的字符串数组。
String	getStringParam(String key)	获取与给定键匹配的字符串值。
String	getType()	获取此 Intent 中类型的描述。
Uri	getUri()	获取 Intent 中 URI 的描述。
String	getUriString()	获取此 Intent 中 URI 的字符串表示形式。
boolean	hasEntity(String entity)	检查 Intent 是否包含给定的实体。
int	hashCode()	返回对象的哈希码值。
boolean	hasParameter(String key)	检查 Intent 是否包含与给定键匹配的参数。
static Intent	makeMainAbility(ElementName elementName)	创建一个 Intent，其对应的属性指定用于启动应用程序的主要功能。
static Intent	makeMainAbilityPicker(String pickerAction, String pickerEntity)	创建一个 Intent，其选择器 Intent 属性指定用于启动应用程序的主要功能。
static Intent	makeRestartAbilityMission(ElementName elementName)	创建一个 Intent 对象并设置相关标志以重新启动特定能力。
boolean	marshalling(Parcel out)	将 Intent 编组到包裹中。
boolean	operationEquals(Intent other)	检查此 Intent 的操作组件是否与指定的 Intent 对象的操作组件相等。
int	operationHashCode()	获取此 Intent 对象的操作属性中包含的所有子属性的哈希码之和。
static Intent	parseUri(String uri)	使用给定的统一资源标识符 (URI) 创建一个 Intent 实例。
void	removeEntity(String entity)	从 Intent 中删除实体的描述。
void	removeFlags(int flags)	从 Intent 中删除标志的描述。
void	removeParam(String key)	删除与给定键匹配的参数。
Intent	replaceParams(Intent intent)	将此 Intent 对象中的参数替换为给定 Intent 对象中的参数。
Intent	replaceParams(IntentParams intentParams)	将此 Intent 对象中的参数替换为给定 IntentParams 对象中的参数。
Intent	setAction(String action)	已弃用。 此更改从 API 版本 5 开始生效。由 OperationBuilder#withAction(String) 替换。
void	setBordersRect(Rect rect)	设置此 Intent 的bordersRect 属性。
Intent	setBundle(String bundleName)	在此 Intent 中设置包名称。
Intent	setCharSequenceArrayListParam(String key, ArrayList<CharSequence> value)	设置元素类型为 CharSequence 的 ArrayList 类型的参数值。
Intent	setElement(ElementName element)	在 Intent 中设置 ElementName 对象。
Intent	setElementName(String bundleName, Class<?> cls)	设置此 Intent 的 bundleName 和 abilityName 属性。
Intent	setElementName(String bundleName, String abilityName)	设置此 Intent 对象的 bundleName 和 abilityName 属性。
Intent	setElementName(String deviceId, String bundleName, Class<?> cls)	设置此 Intent 的 deviceId、bundleName 和 abilityName 属性。
Intent	setElementName(String deviceId, String bundleName, String abilityName)	设置此 Intent 对象的 deviceId、bundleName 和 abilityName 属性。
Intent	setFlags(int flags)	已弃用。 此更改从 API 版本 5 开始生效。替换为 OperationBuilder#withFlags(int)
Intent	setIntegerArrayListParam(String key, ArrayList<Integer> value)	设置元素类型为 Integer 的 ArrayList 类型的参数值。
void	setOperation(Operation operation)	设置 Intent 中操作的描述。
Intent	setParam(String key, boolean value)	设置布尔类型的参数值。
Intent	setParam(String key, boolean[] value)	设置布尔数组类型的参数值。
Intent	setParam(String key, byte value)	设置字节类型的参数值。
Intent	setParam(String key, byte[] value)	设置字节数组类型的参数值。
Intent	setParam(String key, char value)	设置 char 类型的参数值。
Intent	setParam(String key, char[] value)	设置 char 数组类型的参数值。
Intent	setParam(String key, double value)	设置双精度类型的参数值。
Intent	setParam(String key, double[] value)	设置双精度数组类型的参数值。
Intent	setParam(String key, float value)	设置浮点类型的参数值。
Intent	setParam(String key, float[] value)	设置浮点数组类型的参数值。
Intent	setParam(String key, int value)	设置 int 类型的参数值。
Intent	setParam(String key, int[] value)	设置 int 数组类型的参数值。
Intent	setParam(String key, long value)	设置long类型的参数值。
Intent	setParam(String key, long[] value)	设置长数组类型的参数值。
Intent	setParam(String key, short value)	设置一个短类型的参数值。
Intent	setParam(String key, short[] value)	设置短数组类型的参数值。
Intent	setParam(String key, Serializable value)	设置 Serializable 类型的参数值。
Intent	setParam(String key, CharSequence value)	设置 CharSequence 类型的参数值。
Intent	setParam(String key, CharSequence[] value)	设置 CharSequence 数组类型的参数值。
Intent	setParam(String key, String value)	设置字符串类型的参数值。
Intent	setParam(String key, String[] value)	设置字符串数组类型的参数值。
Intent	setParam(String key, IntentParams parameter)	设置 IntentParams 类型的参数值。
Intent	setParam(String key, Sequenceable value)	设置 Sequenceable 类型的参数值。
Intent	setParam(String key, Sequenceable[] value)	设置 Sequenceable 数组类型的参数值。
Intent	setParams(IntentParams parameters)	在 Intent 中设置 IntentParams 对象。
<T extends Sequenceable>Intent	setParcelableArrayListParam(String key, ArrayList<T> value)	已弃用。 此更改从 API 版本 5 开始生效。替换为 setSequenceableArrayListParam(java.lang.String,java.util.ArrayList)
void	setPicker(Intent picker)	为此 Intent 设置选择器 Intent。
<T extends Sequenceable>Intent	setSequenceableArrayListParam(String key, ArrayList<T> value)	设置元素类型为 Sequenceable 的 ArrayList 类型的参数值。
Intent	setStringArrayListParam(String key, ArrayList<String> value)	设置元素类型为String的ArrayList类型的参数值。
Intent	setType(String type)	设置此 Intent 中类型的描述。
Intent	setUri(Uri uri)	已弃用。 此更改从 API 版本 5 开始生效。由 OperationBuilder#withUri(Uri) 替换。
Intent	setUriAndType(Uri uri, String type)	设置此 Intent 中的 uri 和类型的描述。
String	toUri()	将 Intent 中的参数信息转换为 URI 字符串。
boolean	unmarshalling(Parcel in)	从包裹中解组意图。

从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

从接口 ohos.utils.Sequenceable 继承的方法
hasFileDescriptor

字段详细信息

ACTION_BOOK_FLIGHT

public static final String ACTION_BOOK_FLIGHT

表示预定航班的操作

ACTION_BOOK_HOTEL

public static final String ACTION_BOOK_HOTEL

表示预定酒店的操作

ACTION_BOOK_TRAIN_TICKET

public static final String ACTION_BOOK_TRAIN_TICKET

表示预定火车票的动作

ACTION_BUNDLE_ADD

public static final String ACTION_BUNDLE_ADD

指示安装包的操作

ACTION_BUNDLE_REMOVE

public static final String ACTION_BUNDLE_REMOVE

表示卸载捆绑包的操作

ACTION_BUNDLE_UPDATE

public static final String ACTION_BUNDLE_UPDATE

指示更新捆绑包的操作

ACTION_BUY

public static final String ACTION_BUY

表示购物的动作

ACTION_BUY_TAKEOUT

public static final String ACTION_BUY_TAKEOUT

表示点外卖的动作

ACTION_HOME

public static final String ACTION_HOME

表示回家的动作

ACTION_LOCALE_CHANGED

public static final String ACTION_LOCALE_CHANGED

表示区域设置已更改

ACTION_ORDER_TAXI

public static final String ACTION_ORDER_TAXI

指示预定出租车的操作

ACTION_PLAN_ROUTE

public static final String ACTION_PLAN_ROUTE

查询路由的动作

ACTION_PLAY

public static final String ACTION_PLAY

表示播放媒体项的动作

ACTION_QUERY_ALMANC

public static final String ACTION_QUERY_ALMANC

表示查询中国历书的动作

ACTION_QUERY_CONSTELLATION_FORTUNE

public static final String ACTION_QUERY_CONSTELLATION_FORTUNE

表示查询星座的动作

ACTION_QUERY_ENCYCLOPEDIA

public static final String ACTION_QUERY_ENCYCLOPEDIA

表示查询百科全书的动作

ACTION_QUERY_JOKE

public static final String ACTION_QUERY_JOKE

表示读笑话的动作

ACTION_QUERY_LOGISTICS_INFO

public static final String ACTION_QUERY_LOGISTICS_INFO

指示跟踪货件状态的操作

ACTION_QUERY_NEWS

public static final String ACTION_QUERY_NEWS

表示浏览新闻的动作

ACTION_QUERY_POI_INFO

public static final String ACTION_QUERY_POI_INFO

表示查询附近地点的动作

ACTION_QUERY_RECIPE

public static final String ACTION_QUERY_RECIPE

表示搜索菜谱的动作

ACTION_QUERY_SPORTS_INFO

public static final String ACTION_QUERY_SPORTS_INFO

表示查询运动队和比赛日程的动作

ACTION_QUERY_STOCK_INFO

public static final String ACTION_QUERY_STOCK_INFO

表示查询股市行情的动作

ACTION_QUERY_TRAFFIC_RESTRICTION

public static final String ACTION_QUERY_TRAFFIC_RESTRICTION

查询禁驾行为

ACTION_QUERY_TRAVELLING_GUIDELINE

public static final String ACTION_QUERY_TRAVELLING_GUIDELINE

表示查询旅游指南的动作

ACTION_QUERY_WEATHER

public static final String ACTION_QUERY_WEATHER

表示查询天气的动作

ACTION_SEND_LOGISTICS

public static final String ACTION_SEND_LOGISTICS

表示发送捆绑包的操作

ACTION_TRANSLATE_TEXT

public static final String ACTION_TRANSLATE_TEXT

表示翻译文本的动作

ACTION_WATCH_VIDEO_CLIPS

public static final String ACTION_WATCH_VIDEO_CLIPS

表示观看视频剪辑的动作

CLONE_ACTION

public static final int CLONE_ACTION

表示将复制操作属性

CLONE_BORDERS_RECT

public static final int CLONE_BORDERS_RECT

指示将复制BORDERS_RECT属性

CLONE_BUNDLE

public static final int CLONE_BUNDLE

表示将复制捆绑属性

CLONE_ELEMENT

public static final int CLONE_ELEMENT

表示将复制元素属性

E_ENTITIES

public static final int CLONE_ENTITIES

指示将复制实体属性

CLONE_PICKER

public static final int CLONE_PICKER

表示将复制选取器属性

CLONE_URI

public static final int CLONE_URI

表示将复制uri属性

ENTITY_HOME

public static final String ENTITY_HOME

指示主屏幕类别

ENTITY_VIDEO

public static final String ENTITY_VIDEO

表示视频类别

FLAG_ABILITYSLICE_FORWARD_RESULT

public static final int FLAG_ABILITYSLICE_FORWARD_RESULT

将结果返回到源ability切片

FLAG_ABILITYSLICE_MULTI_DEVICE

public static final int FLAG_ABILITYSLICE_MULTI_DEVICE

支持分布式调度系统中的多设备启动

FLAG_ABILITY_CLEAR_MISSION

public static final int FLAG_ABILITY_CLEAR_MISSION

表示清除其他任务的操作。 可以为传递给 Context.startAbility(ohos.aafwk.content.Intent, int) 的 Intent 设置此标志，并且必须与 FLAG_ABILITY_NEW_MISSION 一起使用。

FLAG_ABILITY_CONTINUATION

public static final int FLAG_ABILITY_CONTINUATION

确定是否可以将本地设备上的功能迁移到远程设备

FLAG_ABILITY_FORM_ENABLED

public static final int FLAG_ABILITY_FORM_ENABLED

指定是否启动ability

FLAG_ABILITY_FORWARD_RESULT

public static final int FLAG_ABILITY_FORWARD_RESULT

将结果返回给源ability

FLAG_ABILITY_MISSION_TOP

public static final int FLAG_ABILITY_MISSION_TOP

表示如果现有的启动能力实例已经在任务堆栈的顶部，它将被重用。 否则，将创建一个新的能力实例。

FLAG_ABILITY_NEW_MISSION

public static final int FLAG_ABILITY_NEW_MISSION

表示在历史任务栈上创建任务的操作

FLAG_INSTALL_ON_DEMAND

public static final int FLAG_INSTALL_ON_DEMAND

如果未安装，请安装指定的ability

FLAG_INSTALL_WITH_BACKGROUND_MODE

public static final int FLAG_INSTALL_WITH_BACKGROUND_MODE

如果未安装，请使用后台模式安装指定的功能

FLAG_NOT_OHOS_COMPONENT

public static final int FLAG_NOT_OHOS_COMPONENT

指定组件是否不属于OHOS

FLAG_START_FOREGROUND_ABILITY

public static final int FLAG_START_FOREGROUND_ABILITY

表示无论宿主应用程序是否已启动，都将启动使用服务模板的功能

PRODUCER

public static final Sequenceable.Producer<Intent> PRODUCER

从 Parcel 创建一个 Intent 实例。

构造函数详细信息

Intent

public Intent()

用于创建空Intent实例的构造函数

Intent

public Intent(Intent intent)

用于使用现有Intent对象的参数创建Intent实例的构造函数

参数:

参数名称	参数描述
intent	指示现有的Intent对象

方法详情

clone

public Object clone()

克隆此Intent对象

覆盖:

在类Object中克隆

返回:

返回克隆的Intent对象

setOperation

public void setOperation(Operation operation)

设置Intent中操作的描述

参数:

参数名称	参数描述
operation	表示操作说明

getOperation

public Operation getOperation()

获取Intent中操作的描述

返回:

获取Intent中操作的描述

cloneOperation

public Intent cloneOperation()

创建一个仅包含此Intent的操作组件的Intent对象

返回:

返回创建的Intent对象

operationEquals

public boolean operationEquals(Intent other)

检查此Intent的操作组件是否与指定的Intent对象的操作组件相等

参数:

参数名称	参数描述
other	指示要比较的Intent对象

返回:

如果两个对象的运算分量相等，则返回 true； 否则返回 false。

operationHashCode

public int operationHashCode()

获取此 Intent 对象的操作属性中包含的所有子属性的哈希码之和。

返回:

返回哈希码的总和。

makeMainAbility

public static Intent makeMainAbility(ElementName elementName)

创建一个 Intent，其对应的属性指定用于启动应用程序的主要功能。

此方法创建一个标准 Intent 对象，其中 ACTION_HOME 设置为其操作，并且默认包含 ENTITY_HOME 实体。

参数:

参数名称	参数描述
elementName	表示定义Intent中操作属性的deviceId、bundleName和abilityName子属性的ElementName对象。

返回:

返回用于启动应用程序主要功能的Intent对象

makeRestartAbilityMission

public static Intent makeRestartAbilityMission(ElementName elementName)

创建一个 Intent 对象并设置相关标志以重新启动特定能力。

您可以使用此方法获取用于启动应用程序的标准 Intent 对象。 此方法具有与 makeMainAbility(ohos.bundle.ElementName) 类似的效果，但另外将 Intent 中的标志设置为 FLAG_ABILITY_NEW_MISSION 和 FLAG_ABILITY_CLEAR_MISSION。

参数:

参数名称	参数描述
elementName	指示包含所需属性的 ElementName 对象。

返回:

返回用于重新启动特定功能的Intent对象

makeMainAbilityPicker

public static Intent makeMainAbilityPicker(String pickerAction, String pickerEntity)

创建一个 Intent，其选择器 Intent 属性指定用于启动应用程序的主要功能。

此方法创建一个标准 Intent 对象，其中 ACTION_HOME 设置为其操作，并且默认包含 ENTITY_HOME 实体。

参数:

参数名称	参数描述
pickerAction	指示选取器 Intent 的操作属性。
pickerEntity	表示选取器 Intent 的实体属性。

返回:

返回用于启动应用程序主要功能的 Intent 对象。

marshalling

public boolean marshalling(Parcel out)

将 Intent 编组到包裹中。

Intent 中的字段是单独编组的。 如果任何字段编组失败，则返回 false。

指定者:

接口 Sequenceable 中的编组

参数:

参数名称	参数描述
out	指示用于编组的 Parcel 对象。

返回:

如果编组成功，则返回 true； 否则返回 false。

unmarshalling

public boolean unmarshalling(Parcel in)

从包裹中解组意图。

Intent 中的字段是单独解组的。 如果任何字段未能解组，则返回 false。

指定者:

在接口 Sequenceable 中解组

参数:

参数名称	参数描述
in	指示用于解组的 Parcel 对象。

返回:

如果解组成功，则返回 true； 否则返回 false。

parseUri

public static Intent parseUri(String uri)

使用给定的统一资源标识符 (URI) 创建一个 Intent 实例。

此方法解析输入 URI 并将其保存在 Intent 对象中。

参数:

参数名称	参数描述
uri	指示要解析的 URI。

返回:

返回一个包含 URI 的 Intent 对象。

toUri

public String toUri()

将 Intent 中的参数信息转换为 URI 字符串。

返回:

返回 URI 字符串。

getAction

public String getAction()

获取 Intent 中动作的描述。

返回:

返回 Intent 中的操作描述。

setAction

@Deprecated public Intent setAction(String action)

已弃用。 此更改从 API 版本 5 开始生效。由 OperationBuilder#withAction(String) 替换。

在 Intent 中设置操作的描述。

参数:

参数名称	参数描述
action	表示动作描述。

返回:

返回此包含操作的 Intent 对象。

setUri

@Deprecated public Intent setUri(Uri uri)

已弃用。 此更改从 API 版本 5 开始生效。由 OperationBuilder#withUri(Uri) 替换。

在 Intent 中设置 URI 的描述。

参数:

参数名称	参数描述
uri	表示URI描述。

返回:

返回此包含 URI 的 Intent 对象。

getUri

public Uri getUri()

获取 Intent 中 URI 的描述。

返回:

返回 Intent 中的 URI 描述。

getUriString

public String getUriString()

获取此 Intent 中 URI 的字符串表示形式。

返回:

返回 URI 的字符串。

addEntity

@Deprecated public Intent addEntity(String entity)

已弃用。 此更改从 API 版本 5 开始生效。由 OperationBuilder#withEntities(Set) 替换。

将实体的描述添加到 Intent。

参数:

参数名称	参数描述
entity	指示要添加的实体描述。

返回:

返回此包含实体的 Intent 对象。

removeEntity

public void removeEntity(String entity)

从 Intent 中删除实体的描述。

如果删除后实体数为0，则该集合将设置为空。

参数:

参数名称	参数描述
entity	指示要删除的实体描述。

hasEntity

public boolean hasEntity(String entity)

检查 Intent 是否包含给定的实体。

参数:

参数名称	参数描述
entity	指示要检查的实体

返回:

如果包含给定实体，则返回 true； 否则返回 false。

getEntities

public Set<String> getEntities()

获取 Intent 中所有实体的描述。

返回:

返回一组实体

countEntities

public int countEntities()

获取 Intent 中的实体数。

返回:

返回实体数量

setFlags

@Deprecated public Intent setFlags(int flags)

已弃用。 此更改从 API 版本 5 开始生效。替换为 OperationBuilder#withFlags(int)

在 Intent 中设置一个标志。

接收或处理 Intent 的模块可以使用此方法设置 Intent 中的标志值。

参数:

参数名称	参数描述
flags	指示要设置的标志。

返回:

返回此包含标志的 Intent 对象。

addFlags

public Intent addFlags(int flags)

将标志添加到 Intent。

参数:

参数名称	参数描述
flags	表示要添加的标志。

返回:

返回带有添加标志的 Intent 对象

getFlags

public int getFlags()

获取 Intent 中标志的描述。

返回:

返回标志描述。

removeFlags

public void removeFlags(int flags)

从 Intent 中删除标志的描述。

参数:

参数名称	参数描述
flags	Indicates the flag to remove.

getElement

public ElementName getElement()

获取 Intent 中 ElementName 对象的描述。

返回:

返回 Intent 中的 ElementName 描述。

setElement

public Intent setElement(ElementName element)

在 Intent 中设置 ElementName 对象。

参数:

参数名称	参数描述
element	指示 ElementName 描述。

返回:

返回此包含 ElementName 的 Intent 对象。

setElementName

public Intent setElementName(String bundleName, String abilityName)

设置此 Intent 对象的 bundleName 和 abilityName 属性。

参数:

参数名称	参数描述
bundleName	指示要为 Intent 中的操作属性设置的 bundleName。
abilityName	指示要为 Intent 中的操作属性设置ability名称。

返回:

返回此 Intent 对象，其中包含指定的 bundleName 和 abilityName 属性。

setElementName

public Intent setElementName(String bundleName, Class<?> cls)

设置此 Intent 的 bundleName 和 abilityName 属性。

参数:

参数名称	参数描述
bundleName	指示要设置为 bundleName 属性值的包名称。
cls	指示要设置为abilityName 属性值的类名。

返回:

返回此 Intent 对象，其中包含指定的 bundleName 和 abilityName 属性。

setElementName

public Intent setElementName(String deviceId, String bundleName, String abilityName)

设置此 Intent 对象的 deviceId、bundleName 和 abilityName 属性。

参数:

参数名称	参数描述
deviceId	指示要为 Intent 中的操作属性设置的 deviceId。
bundleName	指示要为 Intent 中的操作属性设置的 bundleName。
abilityName	指示要为 Intent 中的操作属性设置的能力名称。

返回:

返回此 Intent 对象，其中包含指定的 deviceId、bundleName 和 abilityName 属性。

setElementName

public Intent setElementName(String deviceId, String bundleName, Class<?> cls)

设置此 Intent 的 deviceId、bundleName 和 abilityName 属性。

参数:

参数名称	参数描述
deviceId	指示要设置为 deviceId 属性值的设备 ID。
bundleName	指示要设置为 bundleName 属性值的包名称。
cls	指示要设置为abilityName 属性值的类名。

返回:

返回此 Intent 对象，其中包含指定的 deviceId、bundleName 和 abilityName 属性。

setBundle

public Intent setBundle(String bundleName)

在此 Intent 中设置包名称。

如果在 Intent 中指定了捆绑包名称，则 Intent 将仅匹配指定捆绑包中的功能。 您不能在同一个 Intent 上使用此方法和 setPicker(ohos.aafwk.content.Intent)。

参数:

参数名称	参数描述
bundleName	指示 bundleName 名称。

返回:

返回此包含 bundleName 名称的 Intent 对象。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果 bundleName 无效，则抛出此异常。

getBundle

public String getBundle()

获取 Intent 中指定的包的名称。

返回:

返回 Intent 中指定的包名称。

getBordersRect

public Rect getBordersRect()

获取此 Intent 的bordersRect 属性。

返回:

返回此 Intent 的bordersRect 属性。

setBordersRect

public void setBordersRect(Rect rect)

设置此 Intent 的bordersRect 属性。 bordersRect 属性定义了发送这个 Intent 的能力的边界（在屏幕坐标中）。

参数:

参数名称	参数描述
rect	指示要设置为bordersRect 属性值的Rect 对象。

getScheme

public String getScheme()

获取此 Intent 中 URI 方案的描述。

返回:

返回此 Intent 中的 URI 方案描述。

setType

public Intent setType(String type)

设置此 Intent 中类型的描述。

Intent 中的 type 属性是指 Intent 的 URI 所指示的资源的 MIME 类型。

参数:

参数名称	参数描述
type	表示类型描述。

返回:

返回包含该类型的 Intent 对象。

getType

public String getType()

获取此 Intent 中类型的描述。

Intent 中的 type 属性是指 Intent 的 URI 所指示的资源的 MIME 类型。

返回:

返回此 Intent 中的类型描述。

setUriAndType

public Intent setUriAndType(Uri uri, String type)

设置此 Intent 中的 uri 和类型的描述。

参数:

参数名称	参数描述
uri	表示URI描述。
type	表示类型描述。

返回:

返回此 Intent 对象，其中包含 uri 和类型。

formatUri

public Intent formatUri(Uri uri)

格式化指定的 URI。

此方法使用 Uri.getLowerCaseScheme() 方法格式化 URI，然后将格式化的 URI 保存到此 Intent 对象。

参数:

参数名称	参数描述
uri	指示要格式化的 URI。

返回:

返回此 Intent 对象，其中包含格式化的 uri 属性。

formatMimeType

public static String formatMimeType(String mimeType)

格式化指定 MIME 类型的数据。

此方法通过从数据中删除空格并将数据转换为小写字母来格式化指定 MIME 类型的数据。 您可以使用此方法对用于创建 Intent 信息的外部数据进行规范化。

参数:

参数名称	参数描述
mimeType	指示要格式化的数据的 MIME 类型。

返回:

如果指定了 mimeType，则返回格式化数据； 否则返回 null。

formatUriAndType

public Intent formatUriAndType(Uri uri, String type)

格式化指定的 URI 和 MIME 类型。

此方法的工作方式与 formatUri(ohos.utils.net.Uri) 和 formatType(java.lang.String) 相同。

参数:

参数名称	参数描述
uri	指示要格式化的 URI。
type	指示要格式化的 MIME 类型。

返回:

返回此 Intent 对象，其中包含格式化的 uri 和 type 属性。

formatType

public Intent formatType(String type)

格式化指定的 MIME 类型。

此方法使用 formatMimeType(java.lang.String) 方法格式化 MIME 类型，然后将格式化的类型保存到此 Intent 对象。

参数:

参数名称	参数描述
type	指示要格式化的 MIME 类型。

返回:

返回此包含格式化类型属性的 Intent 对象。

setPicker

public void setPicker(Intent picker)

为此 Intent 设置选择器 Intent。 这使您可以构建更通用的 Intent 来更具体地针对所需的应用程序。

如果为 Intent 设置了选取器 Intent，则选取器 Intent 中包含的属性将优先用于匹配处理该 Intent 所需的应用程序。 选择器 Intent 仅用于应用程序匹配，不会影响 equals(java.lang.Object) 和 hashCode() 的行为。

这个 Intent 本身不能被设置为它自己的picker Intent，并且你不能在同一个 Intent 上使用 setBundle(java.lang.String) 的同时使用这个方法来设置一个picker。

参数:

参数名称	参数描述
picker	指示要设置为选取器的 Intent 对象。 该参数可以为空。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果选择器无效，则抛出此异常。

getPicker

public Intent getPicker()

获取此 Intent 中选取器 Intent 的描述。

返回:

返回选择器 Intent 对象（如果有）； 否则返回 null。

setParams

public Intent setParams(IntentParams parameters)

在 Intent 中设置 IntentParams 对象。

参数:

参数名称	参数描述
parameters	Indicates the IntentParams description.

返回:

返回包含 IntentParams 的 Intent 对象。

getParams

public IntentParams getParams()

获取Intent中IntentParams对象的描述。

返回:

返回 Intent 中的 IntentParams 描述。

setParam

public Intent setParam(String key, IntentParams parameter)

设置 IntentParams 类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
parameter	表示参数的 IntentParams 值。

返回:

返回此包含参数值的 Intent 对象。

getParam

public IntentParams getParam(String key)

获取与给定键匹配的 IntentParams 值。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的 IntentParams 值； 如果键不存在，则返回 null。

hasParameter

public boolean hasParameter(String key)

检查 Intent 是否包含与给定键匹配的参数。

参数:

参数名称	参数描述
key	表示键。

返回:

如果 Intent 包含参数，则返回 true； 否则返回 false。

getBooleanParam

public boolean getBooleanParam(String key, boolean defaultValue)

获取与给定键匹配的布尔值。

参数:

参数名称	参数描述
key	IntentParams的key。
defaultValue	表示默认的布尔值。

返回:

返回与给定键匹配的参数的布尔值； 如果键不存在，则返回默认值。

getBooleanArrayParam

public boolean[] getBooleanArrayParam(String key)

获取与给定键匹配的布尔数组。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的布尔数组； 如果键不存在，则返回 null。

getByteParam

public byte getByteParam(String key, byte defaultValue)

获取与给定键匹配的字节类型值。

参数:

参数名称	参数描述
key	IntentParams的key。
defaultValue	表示默认的字节类型值。

返回:

返回匹配给定键的参数的字节类型值； 如果键不存在，则返回默认值。

getByteArrayParam

public byte[] getByteArrayParam(String key)

获取与给定键匹配的字节类型数组。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的字节类型数组； 如果键不存在，则返回 null。

getShortParam

public short getShortParam(String key, short defaultValue)

获取与给定键匹配的短值。

参数:

参数名称	参数描述
key	IntentParams的key。
defaultValue	表示默认的短值。

返回:

返回与给定键匹配的参数的短值； 如果键不存在，则返回默认值。

getShortArrayParam

public short[] getShortArrayParam(String key)

获取与给定键匹配的短数组。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的短数组； 如果键不存在，则返回 null。

getCharParam

public char getCharParam(String key, char defaultValue)

获取与给定键匹配的 char 值。

参数:

参数名称	参数描述
key	IntentParams的key。
defaultValue	表示默认的 char 值。

返回:

返回与给定键匹配的参数的 char 值； 如果键不存在，则返回默认值。

getCharArrayParam

public char[] getCharArrayParam(String key)

获取与给定键匹配的字符数组。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的字符数组； 如果键不存在，则返回 null。

getIntParam

public int getIntParam(String key, int defaultValue)

获取与给定键匹配的 int 值。

参数:

参数名称	参数描述
key	IntentParams的key。
defaultValue	表示默认的 int 值。

返回:

返回与给定键匹配的参数的 int 值； 如果键不存在，则返回默认值。

getIntArrayParam

public int[] getIntArrayParam(String key)

获取与给定键匹配的 int 数组。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的 int 数组； 如果键不存在，则返回 null。

getIntegerArrayListParam

public ArrayList<Integer> getIntegerArrayListParam(String key)

获取与给定键匹配的 Integer 元素的 ArrayList 参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。

返回:

返回与给定键匹配的参数的 ArrayList 值； 如果键不存在，则返回 null。

getLongParam

public long getLongParam(String key, long defaultValue)

获取与给定键匹配的长值。

参数:

参数名称	参数描述
key	IntentParams的key。
defaultValue	表示默认长值。

返回:

返回与给定键匹配的参数的长值； 如果键不存在，则返回默认值。

getLongArrayParam

public long[] getLongArrayParam(String key)

获取与给定键匹配的长数组。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的长数组； 如果键不存在，则返回 null。

getFloatParam

public float getFloatParam(String key, float defaultValue)

获取与给定键匹配的浮点值。

参数:

参数名称	参数描述
key	IntentParams的key。
defaultValue	表示默认浮点值。

返回:

返回匹配给定键的参数的浮点值； 如果键不存在，则返回默认值。

getFloatArrayParam

public float[] getFloatArrayParam(String key)

获取与给定键匹配的浮点数组。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的浮点数组； 如果键不存在，则返回 null。

getDoubleParam

public double getDoubleParam(String key, double defaultValue)

获取与给定键匹配的双精度值。

参数:

参数名称	参数描述
key	IntentParams的key。
defaultValue	表示默认的双精度值。

返回:

返回与给定键匹配的参数的双精度值； 如果键不存在，则返回默认值。

getDoubleArrayParam

public double[] getDoubleArrayParam(String key)

获取与给定键匹配的双精度数组。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的双精度数组； 如果键不存在，则返回 null。

getStringParam

public String getStringParam(String key)

获取与给定键匹配的字符串值。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的字符串值； 如果键不存在，则返回 null。

getStringArrayParam

public String[] getStringArrayParam(String key)

获取与给定键匹配的字符串数组。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的字符串数组； 如果键不存在，则返回 null。

getStringArrayListParam

public ArrayList<String> getStringArrayListParam(String key)

获取与给定键匹配的字符串元素的 ArrayList 参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。

返回:

返回与给定键匹配的参数的 ArrayList 值； 如果键不存在，则返回 null。

getCharSequenceParam

public CharSequence getCharSequenceParam(String key)

获取与指定键匹配的 CharSequence 值。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的 CharSequence 值； 如果键不存在，则返回 null。

getCharSequenceArrayParam

public CharSequence[] getCharSequenceArrayParam(String key)

获取与给定键匹配的 CharSequence 数组。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的 CharSequence 数组； 如果键不存在，则返回 null。

getCharSequenceArrayListParam

public ArrayList<CharSequence> getCharSequenceArrayListParam(String key)

获取与给定键匹配的 CharSequence 元素的 ArrayList 参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。

返回:

返回与给定键匹配的参数的 ArrayList 值； 如果键不存在，则返回 null。

getSerializableParam

public <T extends Serializable> T getSerializableParam(String key)

获取与给定键匹配的 Serializable 参数值。

类型参数:

类型参数名称	类型参数描述
T	表示 Serializable 的子类型。

参数:

参数名称	参数描述
key	表示与参数匹配的键。

返回:

返回与给定键匹配的参数的 Serializable 值； 如果键不存在，则返回 null。

getParcelableParam

@Deprecated public <T extends Sequenceable> T getParcelableParam(String key)

已弃用。 此更改从 API 版本 5 开始生效。替换为 getSequenceableParam(java.lang.String)

获取与指定键匹配的 Sequenceable 值。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的 Sequenceable 值； 如果键不存在，则返回默认值。

getSequenceableParam

public <T extends Sequenceable> T getSequenceableParam(String key)

获取与指定键匹配的 Sequenceable 值。

参数:

参数名称	参数描述
key	IntentParams的key。

返回:

返回与给定键匹配的参数的 Sequenceable 值； 如果键不存在，则返回默认值。

getParcelableArrayParam

@Deprecated public Sequenceable[] getParcelableArrayParam(String key)

已弃用。 此更改从 API 版本 5 开始生效。替换为 getSequenceableArrayParam(java.lang.String)

获取与给定键匹配的 Sequenceable 数组。

参数:

参数名称	参数描述
key	表示与参数匹配的键。

返回:

返回与给定键匹配的参数的 Sequenceable 数组； 如果键不存在，则返回 null。

getSequenceableArrayParam

public Sequenceable[] getSequenceableArrayParam(String key)

获取与给定键匹配的 Sequenceable 数组。

参数:

参数名称	参数描述
key	表示与参数匹配的键。

返回:

返回与给定键匹配的参数的 Sequenceable 数组； 如果键不存在，则返回 null。

getParcelableArrayListParam

@Deprecated public <T extends Sequenceable> ArrayList<T> getParcelableArrayListParam(String key)

已弃用。 此更改从 API 版本 5 开始生效。替换为 getSequenceableArrayListParam(java.lang.String)

获取与给定键匹配的 Sequenceable 元素的 ArrayList 参数值。

类型参数:

类型参数名称	类型参数描述
T	表示 Sequenceable 的子类型。

参数:

参数名称	参数描述
key	表示与参数匹配的键。

返回:

返回与给定键匹配的参数的 ArrayList 值； 如果键不存在，则返回 null。

getSequenceableArrayListParam

public <T extends Sequenceable> ArrayList<T> getSequenceableArrayListParam(String key)

获取与给定键匹配的 Sequenceable 元素的 ArrayList 参数值。

类型参数:

类型参数名称	类型参数描述
T	表示 Sequenceable 的子类型。

参数:

参数名称	参数描述
key	表示与参数匹配的键。

返回:

返回与给定键匹配的参数的 ArrayList 值； 如果键不存在，则返回 null。

setParam

public Intent setParam(String key, boolean value)

设置布尔类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的布尔值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, boolean[] value)

设置布尔数组类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的布尔数组。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, byte value)

设置字节类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的字节类型值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, byte[] value)

设置字节数组类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的字节数组。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, char value)

设置 char 类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的char值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, char[] value)

设置 char 数组类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的char数组。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, short value)

设置一个短类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的短值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, short[] value)

设置短数组类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的短数组。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, int value)

设置 int 类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的int值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, int[] value)

设置 int 数组类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的int数组。

返回:

返回此包含参数值的 Intent 对象。

setIntegerArrayListParam

public Intent setIntegerArrayListParam(String key, ArrayList<Integer> value)

设置元素类型为 Integer 的 ArrayList 类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, long value)

设置long类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的长值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, long[] value)

设置长数组类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的长数组。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, float value)

设置浮点类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的浮点值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, float[] value)

设置浮点数组类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的浮点数组。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, double value)

设置双精度类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的双精度值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, double[] value)

设置双精度数组类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的双精度数组。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, String value)

设置字符串类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的字符串值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, String[] value)

设置字符串数组类型的参数值。

参数:

参数名称	参数类型
key	表示与参数匹配的键。
value	表示参数的字符串数组。

返回:

返回此包含参数值的 Intent 对象。

setStringArrayListParam

public Intent setStringArrayListParam(String key, ArrayList<String> value)

设置元素类型为String的ArrayList类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, CharSequence value)

设置 CharSequence 类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的 CharSequence 值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, CharSequence[] value)

设置 CharSequence 数组类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的 CharSequence 数组。

返回:

返回此包含参数值的 Intent 对象。

setCharSequenceArrayListParam

public Intent setCharSequenceArrayListParam(String key, ArrayList<CharSequence> value)

设置元素类型为 CharSequence 的 ArrayList 类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, Serializable value)

设置 Serializable 类型的参数值。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的 Serializable 值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, Sequenceable value)

设置 Sequenceable 类型的参数值。

在调用此方法之前，您应该先调用 IntentParams#setClassLoader(ClassLoader) 为此类参数设置 ClassLoader。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数的Sequenceable值。

返回:

返回此包含参数值的 Intent 对象。

setParam

public Intent setParam(String key, Sequenceable[] value)

设置 Sequenceable 数组类型的参数值。

在调用此方法之前，您应该先调用 IntentParams#setClassLoader(ClassLoader) 为此类参数设置 ClassLoader。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数值。

返回:

返回此包含参数值的 Intent 对象。

setParcelableArrayListParam

@Deprecated public <T extends Sequenceable> Intent setParcelableArrayListParam(String key, ArrayList<T> value)

已弃用。 此更改从 API 版本 5 开始生效。替换为 setSequenceableArrayListParam(java.lang.String,java.util.ArrayList)

设置元素类型为 Sequenceable 的 ArrayList 类型的参数值。

在调用此方法之前，您应该先调用 IntentParams#setClassLoader(ClassLoader) 为此类参数设置 ClassLoader。

类型参数:

类型参数名称	类型参数描述
T	表示 Sequenceable 的子类型。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数值。

返回:

返回此包含参数值的 Intent 对象。

setSequenceableArrayListParam

public <T extends Sequenceable> Intent setSequenceableArrayListParam(String key, ArrayList<T> value)

设置元素类型为 Sequenceable 的 ArrayList 类型的参数值。

在调用此方法之前，您应该先调用 IntentParams#setClassLoader(ClassLoader) 为此类参数设置 ClassLoader。

类型参数:

类型参数名称	类型参数描述
T	表示 Sequenceable 的子类型。

参数:

参数名称	参数描述
key	表示与参数匹配的键。
value	表示参数值。

返回:

返回此包含参数值的 Intent 对象。

removeParam

public void removeParam(String key)

删除与给定键匹配的参数。

参数:

参数名称	参数描述
key	表示与要删除的参数匹配的键。

replaceParams

public Intent replaceParams(IntentParams intentParams)

将此 Intent 对象中的参数替换为给定 IntentParams 对象中的参数。

参数:

参数名称	参数描述
intentParams	指示包含新参数的 IntentParams 对象。

返回:

返回包含新参数的 Intent 对象。

replaceParams

public Intent replaceParams(Intent intent)

将此 Intent 对象中的参数替换为给定 Intent 对象中的参数。

参数:

参数名称	参数描述
intent	指示包含新参数的 Intent 对象。

返回:

返回包含新参数的 Intent 对象。

cloneByIntent

public int cloneByIntent(Intent other, int flags)

复制指定 Intent 的属性。

参数:

参数名称	参数描述
other	指示要复制其属性的 Intent 对象。
flags	表示要复制的属性，可以是CLONE_ACTION、CLONE_URI、CLONE_ENTITIES、CLONE_BUNDLE、CLONE_PICKER、CLONE_ELEMENT、CLONE_BORDERS_RECT的任意组合。

返回:

返回复制属性的标志。

createSelectIntent

public static Intent createSelectIntent(Intent target, CharSequence title)

创建一个 Intent 实例，该实例旨在根据指定的 Intent 对象打开应用程序选择对话框。

参数:

参数名称	参数描述
target	指示指定候选应用程序以供选择的 Intent 对象。
title	表示应用程序选择对话框的标题。

返回:

返回创建的 Intent 对象。

equals

public boolean equals(Object other)

从类复制的描述：对象

指示其他对象是否“等于”这个对象。

equals 方法在非空对象引用上实现等价关系：

• 它是 reflexive：对于任何非空引用值 x，x.equals(x) 应该返回 true。
• 它是对称的：对于任何非空引用值 x 和 y，当且仅当 y.equals(x) 返回 true 时，x.equals(y) 才应该返回 true。
• 它是传递的：对于任何非空引用值 x、y 和 z，如果 x.equals(y) 返回 true 并且 y.equals(z) 返回 true，则 x.equals(z) 应该返回 true。
• 它是一致的：对于任何非空引用值 x 和 y，x.equals(y) 的多次调用始终返回 true 或始终返回 false，前提是没有修改对象上 equals 比较中使用的信息。
• 对于任何非空引用值 x，x.equals(null) 应该返回 false。

Object 类的 equals 方法实现了对象上最有区别的可能等价关系； 也就是说，对于任何非空引用值 x 和 y，当且仅当 x 和 y 引用同一个对象（x == y 的值为 true）时，此方法才返回 true。

请注意，每当重写该方法时，通常都需要重写 hashCode 方法，以维护 hashCode 方法的一般约定，即相等的对象必须具有相等的哈希码。

覆盖:

类 Object 中的等于

参数:

参数名称	参数描述
other	要与之比较的参考对象。

返回:

如果此对象与 obj 参数相同，则为 true； 否则为假。

hashCode

public int hashCode()

从类复制的描述：对象

返回对象的哈希码值。 支持这种方法是为了有利于哈希表，例如 HashMap 提供的那些。

hashCode 的一般合约是：

• 每当在 Java 应用程序执行期间对同一个对象多次调用它时，hashCode 方法必须始终返回相同的整数，前提是没有修改对象上的 equals 比较中使用的信息。 该整数不需要从应用程序的一次执行到同一应用程序的另一次执行保持一致。
• 如果两个对象根据 equals(Object) 方法相等，则对两个对象中的每一个调用 hashCode 方法必须产生相同的整数结果。
• 如果根据 Object.equals(java.lang.Object) 方法，如果两个对象不相等，则不需要对两个对象中的每一个调用 hashCode 方法必须产生不同的整数结果。 但是，程序员应该意识到，为不相等的对象生成不同的整数结果可能会提高哈希表的性能。

在合理可行的情况下，由 Object 类定义的 hashCode 方法确实为不同的对象返回不同的整数。 （这通常通过将对象的内部地址转换为整数来实现，但 Java™ 编程语言不需要这种实现技术。）

覆盖:

类 Object 中的 hashCode

返回:

此对象的哈希码值。