public
final
class
IntentCompat
extends Object
java.lang.Object | |
↳ | android.support.v4.content.IntentCompat |
Helper for accessing features in Intent
introduced after API level 4 in a backwards compatible fashion.
Constants | |
---|---|
String |
ACTION_EXTERNAL_APPLICATIONS_AVAILABLE
Broadcast Action: Resources for a set of packages (which were previously unavailable) are currently available since the media on which they exist is available. |
String |
ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE
Broadcast Action: Resources for a set of packages are currently unavailable since the media on which they exist is unavailable. |
String |
CATEGORY_LEANBACK_LAUNCHER
Indicates an activity optimized for Leanback mode, and that should be displayed in the Leanback launcher. |
String |
EXTRA_CHANGED_PACKAGE_LIST
This field is part of
|
String |
EXTRA_CHANGED_UID_LIST
This field is part of
|
String |
EXTRA_HTML_TEXT
A constant String that is associated with the Intent, used with
|
int |
FLAG_ACTIVITY_CLEAR_TASK
If set in an Intent passed to |
int |
FLAG_ACTIVITY_TASK_ON_HOME
If set in an Intent passed to |
Public methods | |
---|---|
static
Intent
|
makeMainActivity(ComponentName mainActivity)
Create an intent to launch the main (root) activity of a task. |
static
Intent
|
makeMainSelectorActivity(String selectorAction, String selectorCategory)
Make an Intent for the main activity of an application, without specifying a specific activity to run but giving a selector to find the activity. |
static
Intent
|
makeRestartActivityTask(ComponentName mainActivity)
Make an Intent that can be used to re-launch an application's task in its base state. |
Inherited methods | |
---|---|
From
class
java.lang.Object
|
String ACTION_EXTERNAL_APPLICATIONS_AVAILABLE
Broadcast Action: Resources for a set of packages (which were
previously unavailable) are currently
available since the media on which they exist is available.
The extra data EXTRA_CHANGED_PACKAGE_LIST
contains a
list of packages whose availability changed.
The extra data EXTRA_CHANGED_UID_LIST
contains a
list of uids of packages whose availability changed.
Note that the
packages in this list do not receive this broadcast.
The specified set of packages are now available on the system.
Includes the following extras:
EXTRA_CHANGED_PACKAGE_LIST
is the set of packages
whose resources(were previously unavailable) are currently available.
EXTRA_CHANGED_UID_LIST
is the set of uids of the
packages whose resources(were previously unavailable)
are currently available.
This is a protected intent that can only be sent by the system.
Constant Value: "android.intent.action.EXTERNAL_APPLICATIONS_AVAILABLE"
String ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE
Broadcast Action: Resources for a set of packages are currently
unavailable since the media on which they exist is unavailable.
The extra data EXTRA_CHANGED_PACKAGE_LIST
contains a
list of packages whose availability changed.
The extra data EXTRA_CHANGED_UID_LIST
contains a
list of uids of packages whose availability changed.
The specified set of packages can no longer be
launched and are practically unavailable on the system.
Inclues the following extras:
EXTRA_CHANGED_PACKAGE_LIST
is the set of packages
whose resources are no longer available.
EXTRA_CHANGED_UID_LIST
is the set of packages
whose resources are no longer available.
This is a protected intent that can only be sent by the system.
Constant Value: "android.intent.action.EXTERNAL_APPLICATIONS_UNAVAILABLE"
String CATEGORY_LEANBACK_LAUNCHER
Indicates an activity optimized for Leanback mode, and that should be displayed in the Leanback launcher.
Constant Value: "android.intent.category.LEANBACK_LAUNCHER"
String EXTRA_CHANGED_PACKAGE_LIST
This field is part of
ACTION_EXTERNAL_APPLICATIONS_AVAILABLE
,
ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE
and contains a string array of all of the components that have changed.
Constant Value: "android.intent.extra.changed_package_list"
String EXTRA_CHANGED_UID_LIST
This field is part of
ACTION_EXTERNAL_APPLICATIONS_AVAILABLE
,
ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE
and contains an integer array of uids of all of the components
that have changed.
Constant Value: "android.intent.extra.changed_uid_list"
String EXTRA_HTML_TEXT
A constant String that is associated with the Intent, used with
ACTION_SEND
to supply an alternative to
EXTRA_TEXT
as HTML formatted text. Note that you must also supply
EXTRA_TEXT
.
Constant Value: "android.intent.extra.HTML_TEXT"
int FLAG_ACTIVITY_CLEAR_TASK
If set in an Intent passed to Context.startActivity()
,
this flag will cause any existing task that would be associated with the
activity to be cleared before the activity is started. That is, the activity
becomes the new root of an otherwise empty task, and any old activities
are finished. This can only be used in conjunction with
FLAG_ACTIVITY_NEW_TASK
.
This flag will only be obeyed on devices supporting API 11 or higher.
Constant Value: 32768 (0x00008000)
int FLAG_ACTIVITY_TASK_ON_HOME
If set in an Intent passed to Context.startActivity()
,
this flag will cause a newly launching task to be placed on top of the current
home activity task (if there is one). That is, pressing back from the task
will always return the user to home even if that was not the last activity they
saw. This can only be used in conjunction with
FLAG_ACTIVITY_NEW_TASK
.
Constant Value: 16384 (0x00004000)
Intent makeMainActivity (ComponentName mainActivity)
Create an intent to launch the main (root) activity of a task. This is the Intent that is started when the application's is launched from Home. For anything else that wants to launch an application in the same way, it is important that they use an Intent structured the same way, and can use this function to ensure this is the case.
The returned Intent has the given Activity component as its explicit
component, ACTION_MAIN
as its action, and includes the
category CATEGORY_LAUNCHER
. This does not have
FLAG_ACTIVITY_NEW_TASK
set,
though typically you will want to do that through addFlags(int)
on the returned Intent.
Parameters | |
---|---|
mainActivity |
ComponentName :
The main activity component that this Intent will
launch. |
Returns | |
---|---|
Intent |
Returns a newly created Intent that can be used to launch the activity as a main application entry. |
Intent makeMainSelectorActivity (String selectorAction, String selectorCategory)
Make an Intent for the main activity of an application, without specifying a specific activity to run but giving a selector to find the activity. This results in a final Intent that is structured the same as when the application is launched from Home. For anything else that wants to launch an application in the same way, it is important that they use an Intent structured the same way, and can use this function to ensure this is the case.
The returned Intent has ACTION_MAIN
as its action, and includes the
category CATEGORY_LAUNCHER
. This does not have
FLAG_ACTIVITY_NEW_TASK
set, though typically you will want
to do that through addFlags(int)
on the returned Intent.
Parameters | |
---|---|
selectorAction |
String :
The action name of the Intent's selector. |
selectorCategory |
String :
The name of a category to add to the Intent's
selector. |
Returns | |
---|---|
Intent |
Returns a newly created Intent that can be used to launch the activity as a main application entry. |
See also:
Intent makeRestartActivityTask (ComponentName mainActivity)
Make an Intent that can be used to re-launch an application's task
in its base state. This is like makeMainActivity(ComponentName)
,
but also sets the flags FLAG_ACTIVITY_NEW_TASK
and
FLAG_ACTIVITY_CLEAR_TASK
.
Parameters | |
---|---|
mainActivity |
ComponentName :
The activity component that is the root of the
task; this is the activity that has been published in the application's
manifest as the main launcher icon. |
Returns | |
---|---|
Intent |
Returns a newly created Intent that can be used to relaunch the activity's task in its root state. |