PendingIntent

FLAG_CANCEL_CURRENT

int FLAG_CANCEL_CURRENT

标志表示如果所描述的PendingIntent已经存在，则在生成新的PendingIntent之前应该取消当前的一个。 对于使用getActivity(Context, int, Intent, int) ， getBroadcast(Context, int, Intent, int) ，并getService(Context, int, Intent, int) 。

当您仅更改Intent中的额外数据时，可以使用它来检索新的PendingIntent; 通过取消以前未决的意图，这确保了只有给予新数据的实体才能够启动它。 如果这个保证不是问题，考虑FLAG_UPDATE_CURRENT 。

常量值：268435456（0x10000000）

FLAG_IMMUTABLE

int FLAG_IMMUTABLE

表示创建的PendingIntent应该是不可变的标志。 这意味着传递给send方法以填充此intent的未填充属性的额外意图参数将被忽略。

常量值：67108864（0x04000000）

FLAG_NO_CREATE

int FLAG_NO_CREATE

标志表明如果描述的PendingIntent不存在，那么只需返回null而不是创建它。 对于使用getActivity(Context, int, Intent, int) ， getBroadcast(Context, int, Intent, int) ，并getService(Context, int, Intent, int) 。

常量值：536870912（0x20000000）

FLAG_ONE_SHOT

int FLAG_ONE_SHOT

表示此PendingIntent只能使用一次的标志。 对于使用getActivity(Context, int, Intent, int) ， getBroadcast(Context, int, Intent, int) ，并getService(Context, int, Intent, int) 。

如果已设置，则在 send()后，它将自动取消，任何未来尝试通过它发送都将失败。

常量值：1073741824（0x40000000）

FLAG_UPDATE_CURRENT

int FLAG_UPDATE_CURRENT

标志表示如果所描述的PendingIntent已经存在，则保留它，但用这个新的Intent中的内容替换它的额外数据。 对于使用getActivity(Context, int, Intent, int) ， getBroadcast(Context, int, Intent, int) ，并getService(Context, int, Intent, int) 。

如果你正在创建只有额外变化的意图，可以使用它，并且不关心任何接收你以前的PendingIntent的实体将能够使用你的新的额外功能启动它，即使它们没有被明确地赋予它。

常量值：134217728（0x08000000）

CREATOR

Creator<PendingIntent> CREATOR

cancel

void cancel ()

取消当前有效的PendingIntent。 只有拥有PendingIntent的原始应用程序才能取消它。

describeContents

int describeContents ()

描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如，如果对象将在writeToParcel(Parcel, int)的输出中包含writeToParcel(Parcel, int) ，则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR位。

equals

boolean equals (Object otherObj)

在两个PendingIntent对象上比较运算符，例如返回true，然后它们表示来自同一个包的相同操作。 这允许您使用getActivity(Context, int, Intent, int) ， getBroadcast(Context, int, Intent, int) ，或getService(Context, int, Intent, int)多次（甚至跨进程被杀死），导致不同的PendingIntent对象，但其equals（）方法将它们标识为相同的操作。

getActivities

PendingIntent getActivities (Context context, 
                int requestCode, 
                Intent[] intents, 
                int flags, 
                Bundle options)

像getActivity(Context, int, Intent, int)一样，但允许提供一系列Intents。 数组中的最后一个Intent被视为PendingIntent的主键，就像给予getActivity(Context, int, Intent, int)的单个Intent getActivity(Context, int, Intent, int) 。 在发送产生的PendingIntent后，所有的意图以与将它们传递给startActivities(Intent[])相同的方式开始。

数组中的第一个意图将在现有活动的上下文之外启动，因此您必须在意图中使用Intent.FLAG_ACTIVITY_NEW_TASK启动标志。 （数组中第一个之后的活动在数组中的前一个活动的上下文中启动，因此不需要FLAG_ACTIVITY_NEW_TASK，也不需要它们。）

数组中的最后一个意图表示PendingIntent的关键。 换句话说，它是匹配的重要元素（与getActivity(Context, int, Intent, int)给出的单一意图getActivity(Context, int, Intent, int) ，其内容将成为send(Context, int, Intent)和FLAG_UPDATE_CURRENT等的替换主题。这是因为它是所提供的意图中最具体的，以及当意图开始时用户实际看到的UI。

出于安全原因，您在此处提供的 Intent对象应该几乎总是 明确的意图 ，即指定要通过 Intent.setClass传递到的显式组件

getActivities

PendingIntent getActivities (Context context, 
                int requestCode, 
                Intent[] intents, 
                int flags)

像getActivity(Context, int, Intent, int)一样，但允许提供一系列Intents。 数组中的最后一个Intent被视为PendingIntent的主键，就像给予getActivity(Context, int, Intent, int)的单个Intent getActivity(Context, int, Intent, int) 。 在发送PendingIntent后，所有的Intents都以与将它们传递到startActivities(Intent[])相同的方式启动。

数组中的第一个意图将在现有活动的上下文之外启动，因此您必须在意图中使用Intent.FLAG_ACTIVITY_NEW_TASK启动标志。 （数组中第一个之后的活动在数组中的前一个活动的上下文中启动，因此不需要FLAG_ACTIVITY_NEW_TASK，也不需要它们。）

数组中的最后一个意图表示PendingIntent的关键。 换句话说，它是匹配的重要元素（与getActivity(Context, int, Intent, int)的单一意图getActivity(Context, int, Intent, int) ，它的内容将成为send(Context, int, Intent)和FLAG_UPDATE_CURRENT等的替换主题。这是因为它是所提供的意图中最具体的，以及当意图开始时用户实际看到的UI。

出于安全原因，您在此提供的 Intent对象应该几乎总是 明确的意图 ，即指定要通过 Intent.setClass传递到的显式组件

getActivity

PendingIntent getActivity (Context context, 
                int requestCode, 
                Intent intent, 
                int flags)

检索将启动新活动的PendingIntent，例如调用Context.startActivity(Intent) 。 请注意，该活动将在现有活动的上下文之外启动，因此您必须在意图中使用Intent.FLAG_ACTIVITY_NEW_TASK启动标志。

出于安全原因，您在这里提供的 Intent应该几乎总是一个 明确的意图 ，即指定一个明确的组件通过 Intent.setClass

getActivity

PendingIntent getActivity (Context context, 
                int requestCode, 
                Intent intent, 
                int flags, 
                Bundle options)

检索将启动新活动的PendingIntent，例如调用Context.startActivity(Intent) 。 请注意，该活动将在现有活动的上下文之外开始，因此您必须在Intent中使用Intent.FLAG_ACTIVITY_NEW_TASK启动标志。

出于安全原因，您在这里提供的 Intent应该几乎总是一个 明确的意图 ，即指定一个明确的组件通过 Intent.setClass

getBroadcast

PendingIntent getBroadcast (Context context, 
                int requestCode, 
                Intent intent, 
                int flags)

检索将执行广播的PendingIntent，例如调用 Context.sendBroadcast() 。

出于安全原因，您在这里提供的 Intent应该几乎总是一个 明确的意图 ，即指定一个明确的组件通过 Intent.setClass

getCreatorPackage

String getCreatorPackage ()

返回创建此PendingIntent的应用程序的包名称，即您将实际发送该Intent的身份。 返回的字符串由系统提供，因此应用程序无法欺骗其包。

小心你如何使用它。 所有这些都告诉你是谁创建了PendingIntent。 它并没有告诉你谁把PendingIntent交给了你：也就是说，PendingIntent对象是要在应用程序之间传递的，所以你从应用程序接收到的PendingIntent实际上可能是从另一个应用程序接收的PendingIntent，这意味着你得到的结果将会识别原始应用程序。 因此，您只应使用此信息通过send()调用来识别您希望与谁进行互动的人，而不是由谁给您的PendingIntent。

getCreatorUid

int getCreatorUid ()

返回创建此PendingIntent的应用程序的uid，即您将实际发送Intent的身份。 返回的整数由系统提供，以便应用程序不能欺骗其uid。

小心你如何使用它。 所有这些都告诉你是谁创建了PendingIntent。 它并没有告诉你谁把PendingIntent交给了你：也就是说，PendingIntent对象是要在应用程序之间传递的，所以你从应用程序接收到的PendingIntent实际上可能是从另一个应用程序接收的PendingIntent，这意味着你得到的结果将会识别原始应用程序。 因此，您只应使用此信息通过send()调用来识别您希望与谁进行交互的send() ，而不是由谁给您的PendingIntent。

getCreatorUserHandle

UserHandle getCreatorUserHandle ()

返回创建此PendingIntent的应用程序的用户句柄，即您实际上将发送Intent的用户。 返回的UserHandle由系统提供，以便应用程序不能欺骗其用户。 有关用户句柄的更多说明，请参阅Process.myUserHandle() 。

小心你如何使用它。 所有这些都告诉你是谁创建了PendingIntent。 它并没有告诉你谁把PendingIntent交给了你：也就是说，PendingIntent对象是要在应用程序之间传递的，所以你从应用程序接收到的PendingIntent实际上可能是从另一个应用程序接收的PendingIntent，这意味着你得到的结果将会识别原始应用程序。 因此，您只应使用此信息通过send()调用来确定您希望与谁进行互动，而不是由谁给您的PendingIntent。

getIntentSender

IntentSender getIntentSender ()

检索包装PendingIntent的现有发件人的IntentSender对象

getService

PendingIntent getService (Context context, 
                int requestCode, 
                Intent intent, 
                int flags)

检索将启动服务的PendingIntent，例如调用Context.startService() 。 提供给服务的启动参数将来自意图的附加内容。

出于安全原因，您在这里提供的 Intent几乎总是一个 明确的意图 ，即指定一个明确的组件通过 Intent.setClass

getTargetPackage

String getTargetPackage ()

此方法在API级别17中已弃用。
更名为getCreatorPackage() 。

hashCode

int hashCode ()

返回对象的哈希码值。 为了散列表的好处而支持此方法，例如由HashMap提供的HashMap 。

一般合同 hashCode是：

• Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
• If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
• It is not required that if two objects are unequal according to the equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

尽可能合理实用，由类Object定义的hashCode方法确实为不同的对象返回不同的整数。 （这通常通过将对象的内部地址转换为整数来实现，但Java ^TM编程语言不需要此实现技术。）

readPendingIntentOrNullFromParcel

PendingIntent readPendingIntentOrNullFromParcel (Parcel in)

便捷功能，用于从Parcel中读取Messenger或空指针。 您必须先写好信使writePendingIntentOrNullToParcel(PendingIntent, Parcel) 。

send

void send (Context context, 
                int code, 
                Intent intent, 
                PendingIntent.OnFinished onFinished, 
                Handler handler, 
                String requiredPermission, 
                Bundle options)

执行与此PendingIntent关联的操作，允许调用者指定关于要使用的Intent的信息，并在发送完成时收到通知。

对于意图参数，一个经常的PendingIntent有哪些字段可以在这里提供的限制的基础上，为的PendingIntent如何检索 getActivity(Context, int, Intent, int) ， getBroadcast(Context, int, Intent, int) ，或 getService(Context, int, Intent, int) 。

send

void send ()

执行与此PendingIntent关联的操作。

send

void send (Context context, 
                int code, 
                Intent intent, 
                PendingIntent.OnFinished onFinished, 
                Handler handler)

执行与此PendingIntent关联的操作，允许调用者指定关于要使用的Intent的信息，并在发送完成时收到通知。

对于意图参数，一个经常的PendingIntent有哪些字段可以在这里提供的限制的基础上，为的PendingIntent如何检索 getActivity(Context, int, Intent, int) ， getBroadcast(Context, int, Intent, int) ，或 getService(Context, int, Intent, int) 。

send

void send (Context context, 
                int code, 
                Intent intent, 
                PendingIntent.OnFinished onFinished, 
                Handler handler, 
                String requiredPermission)

执行与此PendingIntent关联的操作，允许调用者指定关于要使用的Intent的信息，并在发送完成时收到通知。

对于意图参数，一个经常的PendingIntent有哪些字段可以在这里提供的限制的基础上，为的PendingIntent如何检索 getActivity(Context, int, Intent, int) ， getBroadcast(Context, int, Intent, int) ，或 getService(Context, int, Intent, int) 。

send

void send (int code, 
                PendingIntent.OnFinished onFinished, 
                Handler handler)

执行与此PendingIntent关联的操作，允许在发送完成时通知呼叫者。

send

void send (Context context, 
                int code, 
                Intent intent)

执行与此PendingIntent关联的操作，允许调用者指定关于要使用的Intent的信息。

send

void send (int code)

执行与此PendingIntent关联的操作。

toString

String toString ()

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

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

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

writePendingIntentOrNullToParcel

void writePendingIntentOrNullToParcel (PendingIntent sender, 
                Parcel out)

用于写入PendingIntent或空指针到Parcel的便捷函数。 您必须将其与readPendingIntentOrNullFromParcel(Parcel)一起使用， readPendingIntentOrNullFromParcel(Parcel)供以后阅读。

writeToParcel

void writeToParcel (Parcel out, 
                int flags)

将此对象平铺到一个包裹中。