Share via


PendingIntent.GetActivities Method

Definition

Overloads

GetActivities(Context, Int32, Intent[], PendingIntentFlags, Bundle)

Like #getActivity(Context, int, Intent, int), but allows an array of Intents to be supplied.

GetActivities(Context, Int32, Intent[], PendingIntentFlags)

Like #getActivity(Context, int, Intent, int), but allows an array of Intents to be supplied.

GetActivities(Context, Int32, Intent[], PendingIntentFlags, Bundle)

Like #getActivity(Context, int, Intent, int), but allows an array of Intents to be supplied.

[Android.Runtime.Register("getActivities", "(Landroid/content/Context;I[Landroid/content/Intent;ILandroid/os/Bundle;)Landroid/app/PendingIntent;", "")]
public static Android.App.PendingIntent? GetActivities (Android.Content.Context? context, int requestCode, Android.Content.Intent[] intents, Android.App.PendingIntentFlags flags, Android.OS.Bundle? options);
[<Android.Runtime.Register("getActivities", "(Landroid/content/Context;I[Landroid/content/Intent;ILandroid/os/Bundle;)Landroid/app/PendingIntent;", "")>]
static member GetActivities : Android.Content.Context * int * Android.Content.Intent[] * Android.App.PendingIntentFlags * Android.OS.Bundle -> Android.App.PendingIntent

Parameters

context
Context

The Context in which this PendingIntent should start the activity.

requestCode
Int32

Private request code for the sender

intents
Intent[]

Array of Intents of the activities to be launched.

flags
PendingIntentFlags

May be #FLAG_ONE_SHOT, #FLAG_NO_CREATE, #FLAG_CANCEL_CURRENT, #FLAG_UPDATE_CURRENT, #FLAG_IMMUTABLE or any of the flags as supported by Intent#fillIn Intent.fillIn() to control which unspecified parts of the intent that can be supplied when the actual send happens.

options
Bundle

Returns

Returns an existing or new PendingIntent matching the given parameters. May return null only if #FLAG_NO_CREATE has been supplied.

Attributes

Remarks

Like #getActivity(Context, int, Intent, int), but allows an array of Intents to be supplied. The last Intent in the array is taken as the primary key for the PendingIntent, like the single Intent given to #getActivity(Context, int, Intent, int). Upon sending the resulting PendingIntent, all of the Intents are started in the same way as they would be by passing them to Context#startActivities(Intent[]).

<p class="note"> The <em>first</em> intent in the array will be started outside of the context of an existing activity, so you must use the Intent#FLAG_ACTIVITY_NEW_TASK Intent.FLAG_ACTIVITY_NEW_TASK launch flag in the Intent. (Activities after the first in the array are started in the context of the previous activity in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) </p>

<p class="note"> The <em>last</em> intent in the array represents the key for the PendingIntent. In other words, it is the significant element for matching (as done with the single intent given to #getActivity(Context, int, Intent, int), its content will be the subject of replacement by #send(Context, int, Intent) and #FLAG_UPDATE_CURRENT, etc. This is because it is the most specific of the supplied intents, and the UI the user actually sees when the intents are started. </p>

<p class="note">For security reasons, the android.content.Intent objects you supply here should almost always be <em>explicit intents</em>, that is specify an explicit component to be delivered to through Intent#setClass(android.content.Context, Class) Intent.setClass</p>

Java documentation for android.app.PendingIntent.getActivities(android.content.Context, int, android.content.Intent[], int, android.os.Bundle).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

GetActivities(Context, Int32, Intent[], PendingIntentFlags)

Like #getActivity(Context, int, Intent, int), but allows an array of Intents to be supplied.

[Android.Runtime.Register("getActivities", "(Landroid/content/Context;I[Landroid/content/Intent;I)Landroid/app/PendingIntent;", "")]
public static Android.App.PendingIntent? GetActivities (Android.Content.Context? context, int requestCode, Android.Content.Intent[] intents, Android.App.PendingIntentFlags flags);
[<Android.Runtime.Register("getActivities", "(Landroid/content/Context;I[Landroid/content/Intent;I)Landroid/app/PendingIntent;", "")>]
static member GetActivities : Android.Content.Context * int * Android.Content.Intent[] * Android.App.PendingIntentFlags -> Android.App.PendingIntent

Parameters

context
Context

The Context in which this PendingIntent should start the activity.

requestCode
Int32

Private request code for the sender

intents
Intent[]

Array of Intents of the activities to be launched.

flags
PendingIntentFlags

May be #FLAG_ONE_SHOT, #FLAG_NO_CREATE, #FLAG_CANCEL_CURRENT, #FLAG_UPDATE_CURRENT, or any of the flags as supported by Intent#fillIn Intent.fillIn() to control which unspecified parts of the intent that can be supplied when the actual send happens.

Returns

Returns an existing or new PendingIntent matching the given parameters. May return null only if #FLAG_NO_CREATE has been supplied.

Attributes

Remarks

Like #getActivity(Context, int, Intent, int), but allows an array of Intents to be supplied. The last Intent in the array is taken as the primary key for the PendingIntent, like the single Intent given to #getActivity(Context, int, Intent, int). Upon sending the resulting PendingIntent, all of the Intents are started in the same way as they would be by passing them to Context#startActivities(Intent[]).

<p class="note"> The <em>first</em> intent in the array will be started outside of the context of an existing activity, so you must use the Intent#FLAG_ACTIVITY_NEW_TASK Intent.FLAG_ACTIVITY_NEW_TASK launch flag in the Intent. (Activities after the first in the array are started in the context of the previous activity in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) </p>

<p class="note"> The <em>last</em> intent in the array represents the key for the PendingIntent. In other words, it is the significant element for matching (as done with the single intent given to #getActivity(Context, int, Intent, int), its content will be the subject of replacement by #send(Context, int, Intent) and #FLAG_UPDATE_CURRENT, etc. This is because it is the most specific of the supplied intents, and the UI the user actually sees when the intents are started. </p>

<p class="note">For security reasons, the android.content.Intent objects you supply here should almost always be <em>explicit intents</em>, that is specify an explicit component to be delivered to through Intent#setClass(android.content.Context, Class) Intent.setClass</p>

Java documentation for android.app.PendingIntent.getActivities(android.content.Context, int, android.content.Intent[], int).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to