android.support.v4.content
Class IntentCompat

java.lang.Object
  extended by android.support.v4.content.IntentCompat

public class IntentCompat
extends Object

Helper for accessing features in Intent introduced after API level 4 in a backwards compatible fashion.


Field Summary
static 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.
static 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.
static String EXTRA_CHANGED_PACKAGE_LIST
          This field is part of Intent.ACTION_EXTERNAL_APPLICATIONS_AVAILABLE, Intent.ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE and contains a string array of all of the components that have changed.
static String EXTRA_CHANGED_UID_LIST
          This field is part of Intent.ACTION_EXTERNAL_APPLICATIONS_AVAILABLE, Intent.ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE and contains an integer array of uids of all of the components that have changed.
static String EXTRA_HTML_TEXT
          A constant String that is associated with the Intent, used with Intent.ACTION_SEND to supply an alternative to Intent.EXTRA_TEXT as HTML formatted text.
static 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.
static 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).
 
Method Summary
static android.content.Intent makeMainActivity(android.content.ComponentName mainActivity)
          Create an intent to launch the main (root) activity of a task.
static android.content.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 android.content.Intent makeRestartActivityTask(android.content.ComponentName mainActivity)
          Make an Intent that can be used to re-launch an application's task in its base state.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ACTION_EXTERNAL_APPLICATIONS_AVAILABLE

public static final 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:

This is a protected intent that can only be sent by the system.

See Also:
Constant Field Values

ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE

public static final 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:

This is a protected intent that can only be sent by the system.

See Also:
Constant Field Values

EXTRA_CHANGED_PACKAGE_LIST

public static final String EXTRA_CHANGED_PACKAGE_LIST
This field is part of Intent.ACTION_EXTERNAL_APPLICATIONS_AVAILABLE, Intent.ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE and contains a string array of all of the components that have changed.

See Also:
Constant Field Values

EXTRA_CHANGED_UID_LIST

public static final String EXTRA_CHANGED_UID_LIST
This field is part of Intent.ACTION_EXTERNAL_APPLICATIONS_AVAILABLE, Intent.ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE and contains an integer array of uids of all of the components that have changed.

See Also:
Constant Field Values

EXTRA_HTML_TEXT

public static final String EXTRA_HTML_TEXT
A constant String that is associated with the Intent, used with Intent.ACTION_SEND to supply an alternative to Intent.EXTRA_TEXT as HTML formatted text. Note that you must also supply Intent.EXTRA_TEXT.

See Also:
Constant Field Values

FLAG_ACTIVITY_TASK_ON_HOME

public static final 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 Intent.FLAG_ACTIVITY_NEW_TASK.

See Also:
Constant Field Values

FLAG_ACTIVITY_CLEAR_TASK

public static final 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 Intent.FLAG_ACTIVITY_NEW_TASK.

This flag will only be obeyed on devices supporting API 11 or higher.

See Also:
Constant Field Values
Method Detail

makeMainActivity

public static android.content.Intent makeMainActivity(android.content.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 - The main activity component that this Intent will launch.
Returns:
Returns a newly created Intent that can be used to launch the activity as a main application entry.
See Also:
Intent.setClass(android.content.Context, java.lang.Class), Intent.setComponent(android.content.ComponentName)

makeMainSelectorActivity

public static android.content.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 Intent.ACTION_MAIN as its action, and includes the category Intent.CATEGORY_LAUNCHER. This does not have Intent.FLAG_ACTIVITY_NEW_TASK set, though typically you will want to do that through Intent.addFlags(int) on the returned Intent.

Parameters:
selectorAction - The action name of the Intent's selector.
selectorCategory - The name of a category to add to the Intent's selector.
Returns:
Returns a newly created Intent that can be used to launch the activity as a main application entry.
See Also:
#setSelector(Intent)

makeRestartActivityTask

public static android.content.Intent makeRestartActivityTask(android.content.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 Intent.FLAG_ACTIVITY_NEW_TASK and FLAG_ACTIVITY_CLEAR_TASK.

Parameters:
mainActivity - 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:
Returns a newly created Intent that can be used to relaunch the activity's task in its root state.


Copyright © 2013 Marek Kedzierski. All Rights Reserved.