Summary: Ctors | Methods | Inherited Methods | [Expand All]

public class

ActivityCompat

extends ContextCompat

java.lang.Object
↳	android.support.v4.content.ContextCompat
	↳	android.support.v4.app.ActivityCompat

Class Overview

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

Summary

Public Constructors
	ActivityCompat()

Public Methods
static void	finishAffinity(Activity activity) Finish this activity, and tries to finish all activities immediately below it in the current task that have the same affinity.
static void	finishAfterTransition(Activity activity) Reverses the Activity Scene entry Transition and triggers the calling Activity to reverse its exit Transition.
static boolean	invalidateOptionsMenu(Activity activity) Invalidate the activity's options menu, if able.
static void	postponeEnterTransition(Activity activity)
static void	setEnterSharedElementCallback(Activity activity, SharedElementCallback callback) When `makeSceneTransitionAnimation(Activity, android.view.View, String)` was used to start an Activity, `callback` will be called to handle shared elements on the launched Activity.
static void	setExitSharedElementCallback(Activity activity, SharedElementCallback callback) When `makeSceneTransitionAnimation(Activity, android.view.View, String)` was used to start an Activity, `callback` will be called to handle shared elements on the launching Activity.
static void	startActivity(Activity activity, Intent intent, Bundle options) Start an activity with additional launch information, if able.
static void	startActivityForResult(Activity activity, Intent intent, int requestCode, Bundle options) Start new activity with options, if able, for which you would like a result when it finished.
static void	startPostponedEnterTransition(Activity activity)

[Expand]

Inherited Methods

From class android.support.v4.content.ContextCompat

final File	getCodeCacheDir(Context context) Returns the absolute path to the application specific cache directory on the filesystem designed for storing cached code.
final static Drawable	getDrawable(Context context, int id) Return a drawable object associated with a particular resource ID.
static File[]	getExternalCacheDirs(Context context) Returns absolute paths to application-specific directories on all external storage devices where the application can place cache files it owns.
static File[]	getExternalFilesDirs(Context context, String type) Returns absolute paths to application-specific directories on all external storage devices where the application can place persistent files it owns.
final File	getNoBackupFilesDir(Context context) Returns the absolute path to the directory on the filesystem similar to `getFilesDir()`.
static File[]	getObbDirs(Context context) Returns absolute paths to application-specific directories on all external storage devices where the application's OBB files (if there are any) can be found.
static boolean	startActivities(Context context, Intent[] intents) Start a set of activities as a synthesized task stack, if able.
static boolean	startActivities(Context context, Intent[] intents, Bundle options) Start a set of activities as a synthesized task stack, if able.

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Public Constructors

public ActivityCompat ()

Public Methods

public static void finishAffinity (Activity activity)

Finish this activity, and tries to finish all activities immediately below it in the current task that have the same affinity.

On Android 4.1+ calling this method will call through to the native version of this method. For other platforms finish() will be called instead.

public static void finishAfterTransition (Activity activity)

Reverses the Activity Scene entry Transition and triggers the calling Activity to reverse its exit Transition. When the exit Transition completes, finish() is called. If no entry Transition was used, finish() is called immediately and the Activity exit Transition is run.

On Android 4.4 or lower, this method only finishes the Activity with no special exit transition.

public static boolean invalidateOptionsMenu (Activity activity)

Invalidate the activity's options menu, if able.

Before API level 11 (Android 3.0/Honeycomb) the lifecycle of the options menu was controlled primarily by the user's operation of the hardware menu key. When the user presses down on the menu key for the first time the menu was created and prepared by calls to onCreateOptionsMenu(android.view.Menu) and onPrepareOptionsMenu(android.view.Menu) respectively. Subsequent presses of the menu key kept the existing instance of the Menu itself and called onPrepareOptionsMenu(android.view.Menu) to give the activity an opportunity to contextually alter the menu before the menu panel was shown.

In Android 3.0+ the Action Bar forces the options menu to be built early so that items chosen to show as actions may be displayed when the activity first becomes visible. The Activity method invalidateOptionsMenu forces the entire menu to be destroyed and recreated from onCreateOptionsMenu(android.view.Menu), offering a similar though heavier-weight opportunity to change the menu's contents. Normally this functionality is used to support a changing configuration of Fragments.

Applications may use this support helper to signal a significant change in activity state that should cause the options menu to be rebuilt. If the app is running on an older platform version that does not support menu invalidation the app will still receive onPrepareOptionsMenu(android.view.Menu) the next time the user presses the menu key and this method will return false. If this method returns true the options menu was successfully invalidated.

Parameters

activity	Invalidate the options menu of this activity

Returns

true if this operation was supported and it completed; false if it was not available.

public static void postponeEnterTransition (Activity activity)

public static void setEnterSharedElementCallback (Activity activity, SharedElementCallback callback)

When makeSceneTransitionAnimation(Activity, android.view.View, String) was used to start an Activity, callback will be called to handle shared elements on the launched Activity. This requires FEATURE_CONTENT_TRANSITIONS.

Parameters

callback	Used to manipulate shared element transitions on the launched Activity.

public static void setExitSharedElementCallback (Activity activity, SharedElementCallback callback)

When makeSceneTransitionAnimation(Activity, android.view.View, String) was used to start an Activity, callback will be called to handle shared elements on the launching Activity. Most calls will only come when returning from the started Activity. This requires FEATURE_CONTENT_TRANSITIONS.

Parameters

callback	Used to manipulate shared element transitions on the launching Activity.

public static void startActivity (Activity activity, Intent intent, Bundle options)

Start an activity with additional launch information, if able.

In Android 4.1+ additional options were introduced to allow for more control on activity launch animations. Applications can use this method along with ActivityOptionsCompat to use these animations when available. When run on versions of the platform where this feature does not exist the activity will be launched normally.

Parameters

activity	Context to launch activity from.
intent	The description of the activity to start.
options	Additional options for how the Activity should be started. May be null if there are no options. See `ActivityOptionsCompat` for how to build the Bundle supplied here; there are no supported definitions for building it manually.

public static void startActivityForResult (Activity activity, Intent intent, int requestCode, Bundle options)

Start new activity with options, if able, for which you would like a result when it finished.

Parameters

activity	Origin activity to launch from.
intent	The description of the activity to start.
requestCode	If >= 0, this code will be returned in onActivityResult() when the activity exits.
options	Additional options for how the Activity should be started. May be null if there are no options. See `ActivityOptionsCompat` for how to build the Bundle supplied here; there are no supported definitions for building it manually.

Results

Interfaces

Classes

Exceptions

ActivityCompat

Class Overview

Summary

Public Constructors

public ActivityCompat ()

Public Methods

public static void finishAffinity (Activity activity)

public static void finishAfterTransition (Activity activity)

public static boolean invalidateOptionsMenu (Activity activity)

Parameters

Returns

public static void postponeEnterTransition (Activity activity)

public static void setEnterSharedElementCallback (Activity activity, SharedElementCallback callback)

Parameters

public static void setExitSharedElementCallback (Activity activity, SharedElementCallback callback)

Parameters

public static void startActivity (Activity activity, Intent intent, Bundle options)

Parameters

public static void startActivityForResult (Activity activity, Intent intent, int requestCode, Bundle options)

Parameters

public static void startPostponedEnterTransition (Activity activity)