Activity.StartActivityIfNeeded 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
| StartActivityIfNeeded(Intent, Int32) |
Same as calling |
| StartActivityIfNeeded(Intent, Int32, Bundle) |
A special variation to launch an activity only if a new activity instance is needed to handle the given Intent. |
StartActivityIfNeeded(Intent, Int32)
Same as calling #startActivityIfNeeded(Intent, int, Bundle)
with no options.
[Android.Runtime.Register("startActivityIfNeeded", "(Landroid/content/Intent;I)Z", "GetStartActivityIfNeeded_Landroid_content_Intent_IHandler")]
public virtual bool StartActivityIfNeeded (Android.Content.Intent intent, int requestCode);[<Android.Runtime.Register("startActivityIfNeeded", "(Landroid/content/Intent;I)Z", "GetStartActivityIfNeeded_Landroid_content_Intent_IHandler")>]
abstract member StartActivityIfNeeded : Android.Content.Intent * int -> bool
override this.StartActivityIfNeeded : Android.Content.Intent * int -> boolParameters
- intent
- Intent
The intent to start.
- requestCode
- Int32
If >= 0, this code will be returned in
onActivityResult() when the activity exits, as described in
#startActivityForResult.
Returns
If a new activity was launched then true is returned; otherwise false is returned and you must handle the Intent yourself.
- Attributes
Remarks
Same as calling #startActivityIfNeeded(Intent, int, Bundle) with no options.
Java documentation for android.app.Activity.startActivityIfNeeded(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.
See also
- <xref:Android.App.Activity.StartActivityForResult(Android.Content.Intent%2c+System.Int32)>
Applies to
StartActivityIfNeeded(Intent, Int32, Bundle)
A special variation to launch an activity only if a new activity instance is needed to handle the given Intent.
[Android.Runtime.Register("startActivityIfNeeded", "(Landroid/content/Intent;ILandroid/os/Bundle;)Z", "GetStartActivityIfNeeded_Landroid_content_Intent_ILandroid_os_Bundle_Handler")]
public virtual bool StartActivityIfNeeded (Android.Content.Intent intent, int requestCode, Android.OS.Bundle? options);[<Android.Runtime.Register("startActivityIfNeeded", "(Landroid/content/Intent;ILandroid/os/Bundle;)Z", "GetStartActivityIfNeeded_Landroid_content_Intent_ILandroid_os_Bundle_Handler")>]
abstract member StartActivityIfNeeded : Android.Content.Intent * int * Android.OS.Bundle -> bool
override this.StartActivityIfNeeded : Android.Content.Intent * int * Android.OS.Bundle -> boolParameters
- intent
- Intent
The intent to start.
- requestCode
- Int32
If >= 0, this code will be returned in
onActivityResult() when the activity exits, as described in
#startActivityForResult.
- options
- Bundle
Additional options for how the Activity should be started.
See android.content.Context#startActivity(Intent, Bundle)
Context.startActivity(Intent, Bundle)} for more details.
Returns
If a new activity was launched then true is returned; otherwise false is returned and you must handle the Intent yourself.
- Attributes
Remarks
A special variation to launch an activity only if a new activity instance is needed to handle the given Intent. In other words, this is just like #startActivityForResult(Intent, int) except: if you are using the Intent#FLAG_ACTIVITY_SINGLE_TOP flag, or singleTask or singleTop android.R.styleable#AndroidManifestActivity_launchMode launchMode, and the activity that handles <var>intent</var> is the same as your currently running activity, then a new instance is not needed. In this case, instead of the normal behavior of calling #onNewIntent this function will return and you can handle the Intent yourself.
This function can only be called from a top-level activity; if it is called from a child activity, a runtime exception will be thrown.
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.
See also
- <xref:Android.App.Activity.StartActivityForResult(Android.Content.Intent%2c+System.Int32)>