鸿蒙OS开发文档 鸿蒙OS ComponentTransition

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 2

ComponentTransition

java.lang.Object
|---ohos.agp.components.ComponentTransition

public class ComponentTransition
extends Object

为 ComponentContainer 对象的布局更改提供动画。

要在布局容器上执行布局转换,请创建一个 ComponentTransition 对象,然后使用 ComponentContainer#setComponentTransition 设置一个 ComponentContainer 对象。

字段摘要

修饰符和类型字段描述
static intCHANGING指示在由布局修改更改的组件上运行的动画,而不是通过在布局容器中添加或删除组件。
static intOTHERS_GONE指示在组件上运行的动画,因为它们的关联组件之一从 ComponentContainer 中消失而发生更改。
static intOTHERS_SHOW指示在组件上运行的动画,因为它们的关联组件之一出现在 ComponentContainer 中而发生更改。
static intSELF_GONE表示当组件从 ComponentContainer 中消失时在组件上运行的动画。
static intSELF_SHOW表示当组件出现在 ComponentContainer 中时在组件上运行的动画。

构造函数摘要

构造函数描述
ComponentTransition()用于创建 ComponentTransition 实例的默认构造函数。

方法总结

修饰符和类型方法描述
voidaddTransitionType(int type)为 ComponentTransition 对象启用过渡类型。
AnimatorPropertygetAnimatorProperty(int type)获取指定转场类型的组件属性动画器。
booleanhasTransitionType(int type)检查是否为 ComponentTransition 对象启用了指定的过渡类型。
voidrelease()释放一个 ComponentTransition 对象。
voidremoveTransitionType(int type)从 ComponentTransition 对象中移除过渡类型。
voidsetAnimatorProperty(int type, AnimatorProperty animator)设置指定转换类型的可自定义组件属性动画器。
voidsetTransitionTypeDuration(int type, int duration)设置指定过渡类型动画的持续时间。
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

CHANGING

public static final int CHANGING

指示在由布局修改更改的组件上运行的动画,而不是通过在布局容器中添加或删除组件。

默认情况下,此转换类型被禁用。 您可以调用 addTransitionType(int) 来启用它。

OTHERS_GONE

public static final int OTHERS_GONE

指示在组件上运行的动画,因为它们的关联组件之一从 ComponentContainer 中消失而发生更改。

OTHERS_SHOW

public static final int OTHERS_SHOW

指示在组件上运行的动画,因为它们的关联组件之一出现在 ComponentContainer 中而发生更改。

SELF_GONE

public static final int SELF_GONE

表示当组件从 ComponentContainer 中消失时在组件上运行的动画。

SELF_SHOW

public static final int SELF_SHOW

表示当组件出现在 ComponentContainer 中时在组件上运行的动画。

构造函数详细信息

ComponentTransition

public ComponentTransition()

用于创建 ComponentTransition 实例的默认构造函数。

方法详情

release

public void release()

释放一个 ComponentTransition 对象。

addTransitionType

public void addTransitionType(int type)

为 ComponentTransition 对象启用过渡类型。

过渡类型包括 SELF_SHOW、OTHERS_SHOW、OTHERS_GONE、SELF_GONE 和 CHANGING。

参数:

参数名称参数描述
type指示要启用的转换类型。

removeTransitionType

public void removeTransitionType(int type)

从 ComponentTransition 对象中移除过渡类型。

默认情况下,启用除 CHANGING 之外的所有转换类型。

参数:

参数名称参数描述
type指示要删除的转换类型。

hasTransitionType

public boolean hasTransitionType(int type)

检查是否为 ComponentTransition 对象启用了指定的过渡类型。

参数:

参数名称参数描述
type表示指定的过渡类型。

返回:

如果添加了指定的过渡类型,则返回 true; 否则返回 false。

setTransitionTypeDuration

public void setTransitionTypeDuration(int type, int duration)

设置指定过渡类型动画的持续时间。

参数:

参数名称参数描述
type表示指定的转场类型,可以是SELF_SHOW、OTHERS_SHOW、OTHERS_GONE、SELF_GONE或CHANGING。
duration指示过渡动画的持续时间,以毫秒为单位。

setAnimatorProperty

public void setAnimatorProperty(int type, AnimatorProperty animator)

设置指定转换类型的可自定义组件属性动画器。

参数:

参数名称参数描述
type表示指定的转场类型,可以是SELF_SHOW、OTHERS_SHOW、OTHERS_GONE、SELF_GONE或CHANGING。
animator表示组件属性动画器。

getAnimatorProperty

public AnimatorProperty getAnimatorProperty(int type)

获取指定转场类型的组件属性动画器。

参数:

参数名称参数描述
type表示指定的转场类型,可以是SELF_SHOW、OTHERS_SHOW、OTHERS_GONE、SELF_GONE或CHANGING。

返回:

返回指定转场类型的AnimatorProperty对象; 否则返回 null。