Most visited

Recently visited

Added in API level 16

ActivityOptions

public class ActivityOptions
extends Object

java.lang.Object
   ↳ android.app.ActivityOptions


Helper类用于构建可与 Context.startActivity(Intent, Bundle)及相关方法一起使用的选项包。

Summary

Constants

String EXTRA_USAGE_TIME_REPORT

requestUsageTimeReport(PendingIntent)交付的 requestUsageTimeReport(PendingIntent)中包含用户在应用程序流中花费的总时间(以毫秒为单位)中的很长一段时间。

String EXTRA_USAGE_TIME_REPORT_PACKAGES

requestUsageTimeReport(PendingIntent)提供的附加内容中的捆绑包,其中包含有关与应用程序关联的每个包所用时间的详细信息; 每个密钥都是一个包名称,其值是一个包含时间(以毫秒为单位)的长整型。

Public methods

Rect getLaunchBounds()

返回应该用于启动活动的范围。

static ActivityOptions makeBasic()

创建一个没有特殊动画关联的基本ActivityOptions。

static ActivityOptions makeClipRevealAnimation(View source, int startX, int startY, int width, int height)

创建一个ActivityOptions,指定一个动画,其中新活动从屏幕的一个小起始区域显示到其最终完整表示。

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

创建一个ActivityOptions,指定在显示活动时运行的自定义动画。

static ActivityOptions makeScaleUpAnimation(View source, int startX, int startY, int width, int height)

创建一个ActivityOptions,指定一个动画,其中新活动从屏幕的一个小起始区域缩放至其最终完整表示。

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

使用交叉活动场景动画创建一个ActivityOptions以在活动之间转换。

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

使用交叉活动场景动画创建一个ActivityOptions以在活动之间转换。

static ActivityOptions makeTaskLaunchBehind()

如果与Intent.FLAG_ACTIVITY_NEW_DOCUMENT一起设置,则启动的任务将不会呈现给用户,而只会通过最近的任务列表提供。

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

创建一个ActivityOptions,指定将缩略图从给定位置缩放到正在启动的新活动窗口的动画。

void requestUsageTimeReport(PendingIntent receiver)

询问系统跟踪用户在应用程序启动时花费的时间,并在完成后回报。

ActivityOptions setLaunchBounds(Rect screenSpacePixelRect)

设置活动应该启动的边界(窗口大小)。

Bundle toBundle()

将创建的选项作为捆绑包返回,可以将其传递给 Context.startActivity(Intent, Bundle)和相关方法。

void update(ActivityOptions otherOptions)

在从 otherOptions提供的与本ActivityOptions更新的当前值。

Inherited methods

From class java.lang.Object

Constants

EXTRA_USAGE_TIME_REPORT

Added in API level 23
String EXTRA_USAGE_TIME_REPORT

requestUsageTimeReport(PendingIntent)提供的 requestUsageTimeReport(PendingIntent)中包含用户在应用程序流中花费的总时间(以毫秒为单位)中的很长一段时间。

常量值:“android.activity.usage_time”

EXTRA_USAGE_TIME_REPORT_PACKAGES

Added in API level 23
String EXTRA_USAGE_TIME_REPORT_PACKAGES

requestUsageTimeReport(PendingIntent)提供的附加内容中的捆绑requestUsageTimeReport(PendingIntent) ,其中包含有关与应用程序关联的每个软件包花费的时间的详细信息; 每个密钥都是一个包名称,其值是一个包含时间(以毫秒为单位)的长整型。

常量值:“android.usage_time_packages”

Public methods

getLaunchBounds

Added in API level 24
Rect getLaunchBounds ()

返回应该用于启动活动的范围。

Returns
Rect Bounds used to launch the activity.

也可以看看:

makeBasic

Added in API level 23
ActivityOptions makeBasic ()

创建一个没有特殊动画关联的基本ActivityOptions。 其他选项仍可以设置。

Returns
ActivityOptions

makeClipRevealAnimation

Added in API level 23
ActivityOptions makeClipRevealAnimation (View source, 
                int startX, 
                int startY, 
                int width, 
                int height)

创建一个ActivityOptions,指定一个动画,其中新活动从屏幕的一个小起始区域显示到其最终完整表示。

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.
width int: The initial width of the new activity.
height int: The initial height of the new activity.
Returns
ActivityOptions Returns a new ActivityOptions object that you can use to supply these options as the options Bundle when starting an activity.

makeCustomAnimation

Added in API level 16
ActivityOptions makeCustomAnimation (Context context, 
                int enterResId, 
                int exitResId)

创建一个ActivityOptions,指定在显示活动时运行的自定义动画。

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
ActivityOptions Returns a new ActivityOptions object that you can use to supply these options as the options Bundle when starting an activity.

makeScaleUpAnimation

Added in API level 16
ActivityOptions makeScaleUpAnimation (View source, 
                int startX, 
                int startY, 
                int width, 
                int height)

创建一个ActivityOptions,指定一个动画,其中新活动从屏幕的一个小起始区域缩放至其最终完整表示。

如果使用的Intent没有设置其值 Intent.setSourceBounds ,那么将根据传入的初始界限为您填充这些界限。

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.
width int: The initial width of the new activity.
height int: The initial height of the new activity.
Returns
ActivityOptions Returns a new ActivityOptions object that you can use to supply these options as the options Bundle when starting an activity.

makeSceneTransitionAnimation

Added in API level 21
ActivityOptions makeSceneTransitionAnimation (Activity activity, 
                View sharedElement, 
                String sharedElementName)

使用交叉活动场景动画创建一个ActivityOptions以在活动之间转换。 该方法将一个共享元素的位置带到启动的Activity中。 sharedElement的位置将被用作退出过渡的中心。 共享元素在启动的Activity中的位置将成为其进入Transition的中心。

这要求在调用Activity上启用FEATURE_ACTIVITY_TRANSITIONS以导致退出转换。 被调用的活动中必须有相同的输入转换。

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

也可以看看:

makeSceneTransitionAnimation

Added in API level 21
ActivityOptions makeSceneTransitionAnimation (Activity activity, 
                Pair...<ViewString> sharedElements)

使用交叉活动场景动画创建一个ActivityOptions以在活动之间转换。 该方法将多个共享元素的位置传递给启动的Activity。 sharedElements中第一个元素的位置将用作退出过渡的中心。 相关共享元素在启动的Activity中的位置将成为其进入Transition的中心。

这要求在调用Activity上启用FEATURE_ACTIVITY_TRANSITIONS以导致退出转换。 被调用的活动中必须有相同的输入转换。

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
ActivityOptions Returns a new ActivityOptions object that you can use to supply these options as the options Bundle when starting an activity.

也可以看看:

makeTaskLaunchBehind

Added in API level 21
ActivityOptions makeTaskLaunchBehind ()

如果与Intent.FLAG_ACTIVITY_NEW_DOCUMENT一起设置,则启动的任务将不会呈现给用户,而只会通过最近的任务列表提供。 此外,新任务将与发起活动的任务相关联。 附属任务在最近任务列表中分组在一起。

不支持此行为活动, launchModesingleInstance或者 singleTask

Returns
ActivityOptions

makeThumbnailScaleUpAnimation

Added in API level 16
ActivityOptions makeThumbnailScaleUpAnimation (View source, 
                Bitmap thumbnail, 
                int startX, 
                int startY)

创建一个ActivityOptions,指定将缩略图从给定位置缩放到正在启动的新活动窗口的动画。

如果正在使用的意图未设置其 Intent.setSourceBounds ,那么将根据此处提供的初始缩略图位置和大小为您填充这些界限。

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
ActivityOptions Returns a new ActivityOptions object that you can use to supply these options as the options Bundle when starting an activity.

requestUsageTimeReport

Added in API level 23
void requestUsageTimeReport (PendingIntent receiver)

询问系统跟踪用户在应用程序启动时花费的时间,并在完成后回报。 该报告将被发送到给定的接收方,并填写额外的EXTRA_USAGE_TIME_REPORTEXTRA_USAGE_TIME_REPORT_PACKAGES

跟踪的时间间隔来自启动此活动直到用户离开该活动的流程。 只要新活动正在启动或从原始流程返回,即使这些活动跨越一揽子计划或任务边界,他们也会被视为停留在流程中。 例如,如果发起者启动一个活动来查看图像,并且在用户选择共享的情况下启动他们的电子邮件应用程序,然后他们完成共享,那么整个操作过程中的时间将被包括在内,直到他们最后从原始图像查看器活动中回放。

一旦用户切换到另一个不属于追踪流程的活动,则认为该用户完成流程。 例如,可能会发生这种情况,可以使用通知栏,启动器或最近发布或切换到其他应用程序。 简单地进入这些导航元素不会中断流程(尽管启动器和最近会停止时间跟踪会话); 这是去其他地方完成跟踪的行为。

Parameters
receiver PendingIntent: A broadcast receiver that willl receive the report.

setLaunchBounds

Added in API level 24
ActivityOptions setLaunchBounds (Rect screenSpacePixelRect)

设置活动应该启动的界限(窗口大小)。应该以像素和屏幕坐标提供Rect位置。 全屏设置为空。

注意: 在没有启用FEATURE_FREEFORM_WINDOW_MANAGEMENTFEATURE_PICTURE_IN_PICTURE设备上,此值将被忽略。

Parameters
screenSpacePixelRect Rect: Launch bounds to use for the activity or null for fullscreen.
Returns
ActivityOptions

toBundle

Added in API level 16
Bundle toBundle ()

将创建的选项作为一个Bundle返回,可以将其传递给Context.startActivity(Intent, Bundle)和相关方法。 请注意,返回的Bundle仍属于ActivityOptions对象; 您不得修改它,但可以将其提供给采用选项Bundle的startActivity方法。

Returns
Bundle

update

Added in API level 16
void update (ActivityOptions otherOptions)

在从otherOptions提供的与本ActivityOptions更新的当前值。 otherOptions定义的任何值替换那些在基体的选项。

Parameters
otherOptions ActivityOptions