Skip to content

Most visited

Recently visited

navigation

ActivityOptionsCompat

public class ActivityOptionsCompat
extends Object

java.lang.Object
   ↳ android.support.v4.app.ActivityOptionsCompat


Helper for accessing features in ActivityOptions introduced in API level 16 in a backwards compatible fashion.

Summary

Protected constructors

ActivityOptionsCompat()

Public methods

static ActivityOptionsCompat makeCustomAnimation(Context context, int enterResId, int exitResId)

Create an ActivityOptions specifying a custom animation to run when the activity is displayed.

static ActivityOptionsCompat makeScaleUpAnimation(View source, int startX, int startY, int startWidth, int startHeight)

Create an ActivityOptions specifying an animation where the new activity is scaled from a small originating area of the screen to its final full representation.

static ActivityOptionsCompat makeSceneTransitionAnimation(Activity activity, View sharedElement, String sharedElementName)

Create an ActivityOptions to transition between Activities using cross-Activity scene animations.

static ActivityOptionsCompat makeSceneTransitionAnimation(Activity activity, Pair...<ViewString> sharedElements)

Create an ActivityOptions to transition between Activities using cross-Activity scene animations.

static ActivityOptionsCompat makeThumbnailScaleUpAnimation(View source, Bitmap thumbnail, int startX, int startY)

Create an ActivityOptions specifying an animation where a thumbnail is scaled from a given position to the new activity window that is being started.

Bundle toBundle()

Returns the created options as a Bundle, which can be passed to startActivity(android.app.Activity, android.content.Intent, android.os.Bundle).

void update(ActivityOptionsCompat otherOptions)

Update the current values in this ActivityOptions from those supplied in otherOptions.

Inherited methods

From class java.lang.Object

Protected constructors

ActivityOptionsCompat

ActivityOptionsCompat ()

Public methods

makeCustomAnimation

ActivityOptionsCompat makeCustomAnimation (Context context, 
                int enterResId, 
                int exitResId)

Create an ActivityOptions specifying a custom animation to run when the activity is displayed.

Parameters
context Context: Who is defining this. This is the application that the animation resources will be loaded from.
enterResId int: A resource ID of the animation resource to use for the incoming activity. Use 0 for no animation.
exitResId int: A resource ID of the animation resource to use for the outgoing activity. Use 0 for no animation.
Returns
ActivityOptionsCompat Returns a new ActivityOptions object that you can use to supply these options as the options Bundle when starting an activity.

makeScaleUpAnimation

ActivityOptionsCompat makeScaleUpAnimation (View source, 
                int startX, 
                int startY, 
                int startWidth, 
                int startHeight)

Create an ActivityOptions specifying an animation where the new activity is scaled from a small originating area of the screen to its final full representation.

If the Intent this is being used with has not set its setSourceBounds(android.graphics.Rect), those bounds will be filled in for you based on the initial bounds passed in here.

Parameters
source View: The View that the new activity is animating from. This defines the coordinate space for startX and startY.
startX int: The x starting location of the new activity, relative to source.
startY int: The y starting location of the activity, relative to source.
startWidth int: The initial width of the new activity.
startHeight int: The initial height of the new activity.
Returns
ActivityOptionsCompat Returns a new ActivityOptions object that you can use to supply these options as the options Bundle when starting an activity.

makeSceneTransitionAnimation

ActivityOptionsCompat makeSceneTransitionAnimation (Activity activity, 
                View sharedElement, 
                String sharedElementName)

Create an ActivityOptions to transition between Activities using cross-Activity scene animations. This method carries the position of one shared element to the started Activity. The position of sharedElement will be used as the epicenter for the exit Transition. The position of the shared element in the launched Activity will be the epicenter of its entering Transition.

This requires FEATURE_CONTENT_TRANSITIONS to be enabled on the calling Activity to cause an exit transition. The same must be in the called Activity to get an entering transition.

Parameters
activity Activity: The Activity whose window contains the shared elements.
sharedElement View: The View to transition to the started Activity. sharedElement must have a non-null sharedElementName.
sharedElementName String: The shared element name as used in the target Activity. This may be null if it has the same name as sharedElement.
Returns
ActivityOptionsCompat Returns a new ActivityOptions object that you can use to supply these options as the options Bundle when starting an activity.

makeSceneTransitionAnimation

ActivityOptionsCompat makeSceneTransitionAnimation (Activity activity, 
                Pair...<ViewString> sharedElements)

Create an ActivityOptions to transition between Activities using cross-Activity scene animations. This method carries the position of multiple shared elements to the started Activity. The position of the first element in sharedElements will be used as the epicenter for the exit Transition. The position of the associated shared element in the launched Activity will be the epicenter of its entering Transition.

This requires FEATURE_CONTENT_TRANSITIONS to be enabled on the calling Activity to cause an exit transition. The same must be in the called Activity to get an entering transition.

Parameters
activity Activity: The Activity whose window contains the shared elements.
sharedElements Pair: The names of the shared elements to transfer to the called Activity and their associated Views. The Views must each have a unique shared element name.
Returns
ActivityOptionsCompat Returns a new ActivityOptions object that you can use to supply these options as the options Bundle when starting an activity.

makeThumbnailScaleUpAnimation

ActivityOptionsCompat makeThumbnailScaleUpAnimation (View source, 
                Bitmap thumbnail, 
                int startX, 
                int startY)

Create an ActivityOptions specifying an animation where a thumbnail is scaled from a given position to the new activity window that is being started.

If the Intent this is being used with has not set its setSourceBounds(android.graphics.Rect), those bounds will be filled in for you based on the initial thumbnail location and size provided here.

Parameters
source View: The View that this thumbnail is animating from. This defines the coordinate space for startX and startY.
thumbnail Bitmap: The bitmap that will be shown as the initial thumbnail of the animation.
startX int: The x starting location of the bitmap, relative to source.
startY int: The y starting location of the bitmap, relative to source.
Returns
ActivityOptionsCompat Returns a new ActivityOptions object that you can use to supply these options as the options Bundle when starting an activity.

toBundle

Bundle toBundle ()

Returns the created options as a Bundle, which can be passed to startActivity(android.app.Activity, android.content.Intent, android.os.Bundle). Note that the returned Bundle is still owned by the ActivityOptions object; you must not modify it, but can supply it to the startActivity methods that take an options Bundle.

Returns
Bundle

update

void update (ActivityOptionsCompat otherOptions)

Update the current values in this ActivityOptions from those supplied in otherOptions. Any values defined in otherOptions replace those in the base options.

Parameters
otherOptions ActivityOptionsCompat
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.