PendingIntent.GetActivities Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| GetActivities(Context, Int32, Intent[], PendingIntentFlags, Bundle) |
Like |
| GetActivities(Context, Int32, Intent[], PendingIntentFlags) |
Like |
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.PendingIntentParameters
- 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>
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.PendingIntentParameters
- 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>
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.