LocalActivityManager.StartActivity(String, Intent) Method

Reference

Definition

Namespace:: Android.App

Assembly:: Mono.Android.dll

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.

Caution

deprecated

Start a new activity running in the group.

[Android.Runtime.Register("startActivity", "(Ljava/lang/String;Landroid/content/Intent;)Landroid/view/Window;", "GetStartActivity_Ljava_lang_String_Landroid_content_Intent_Handler")]
[System.Obsolete("deprecated")]
public virtual Android.Views.Window? StartActivity (string? id, Android.Content.Intent? intent);

[<Android.Runtime.Register("startActivity", "(Ljava/lang/String;Landroid/content/Intent;)Landroid/view/Window;", "GetStartActivity_Ljava_lang_String_Landroid_content_Intent_Handler")>]
[<System.Obsolete("deprecated")>]
abstract member StartActivity : string * Android.Content.Intent -> Android.Views.Window
override this.StartActivity : string * Android.Content.Intent -> Android.Views.Window

Parameters

id: String

Unique identifier of the activity to be started

intent: Intent

The Intent describing the activity to be started

Returns

Window

Returns the window of the activity. The caller needs to take care of adding this window to a view hierarchy, and likewise dealing with removing the old window if the activity has changed.

Attributes: RegisterAttribute ObsoleteAttribute

Exceptions

ActivityNotFoundException

Remarks

Start a new activity running in the group. Every activity you start must have a unique string ID associated with it -- this is used to keep track of the activity, so that if you later call startActivity() again on it the same activity object will be retained.

When there had previously been an activity started under this id, it may either be destroyed and a new one started, or the current one re-used, based on these conditions, in order:

<ul> <li> If the Intent maps to a different activity component than is currently running, the current activity is finished and a new one started. <li> If the current activity uses a non-multiple launch mode (such as singleTop), or the Intent has the Intent#FLAG_ACTIVITY_SINGLE_TOP flag set, then the current activity will remain running and its Activity#onNewIntent(Intent) Activity.onNewIntent() method called. <li> If the new Intent is the same (excluding extras) as the previous one, and the new Intent does not have the Intent#FLAG_ACTIVITY_CLEAR_TOP set, then the current activity will remain running as-is. <li> Otherwise, the current activity will be finished and a new one started. </ul>

If the given Intent can not be resolved to an available Activity, this method throws android.content.ActivityNotFoundException.

Warning: There is an issue where, if the Intent does not include an explicit component, we can restore the state for a different activity class than was previously running when the state was saved (if the set of available activities changes between those points).

Java documentation for android.app.LocalActivityManager.startActivity(java.lang.String, android.content.Intent).

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