Transition

MATCH_ID

int MATCH_ID

与setMatchOrder(int) ，选择匹配getId() 。 负号不会被匹配。

常量值：3（0x00000003）

MATCH_INSTANCE

int MATCH_INSTANCE

随着 setMatchOrder(int) ，选择由View实例匹配。

常数值：1（0x00000001）

MATCH_ITEM_ID

int MATCH_ITEM_ID

随着setMatchOrder(int) ，选择匹配的Adapter项目编号。 当hasStableIds()返回false时，将不匹配项目。

常量值：4（0x00000004）

MATCH_NAME

int MATCH_NAME

与setMatchOrder(int) ，选择匹配getTransitionName() 。 空名称不匹配。

常量值：2（0x00000002）

Transition

Transition ()

构造一个没有目标对象的Transition对象。 没有目标的转换默认为在场景层次结构中的所有目标对象上运行（如果转换不包含在TransitionSet中），或者所有目标对象从其父级传递（如果它位于TransitionSet中）。

Transition

Transition (Context context, 
                AttributeSet attrs)

从XML执行通货膨胀并应用主题属性或样式资源中的特定于类的基本样式。 Transition的这个构造函数允许子类在膨胀时使用它们自己的基础样式。

addListener

Transition addListener (Transition.TransitionListener listener)

将侦听器添加到通过动画生命周期发送事件的侦听器集，例如start，repeat和end。

addTarget

Transition addTarget (View target)

设置此Transition对动画制作感兴趣的目标视图实例。 默认情况下，没有目标，并且Transition将侦听场景的sceneRoot下面的每个视图的变化。 设定目标会限制转换只能监听并执行这些视图。 所有其他视图将被忽略。

目标列表与targetId列表类似，只是此列表指定了实际的View实例，而不是视图的ID。 当场景变化涉及单独膨胀的视图层次时，这是一个重要的区别; 不同的视图可以共享相同的ID，但实际上不是相同的实例。 如果过渡应该把这些意见相同，则addTarget(int)应该用来代替addTarget(View) 。 另一方面，如果场景变化涉及全部在相同视图层次内的变化，则在不一定具有对其设置ID的视图中，则目标视图列表可能更方便。

addTarget

Transition addTarget (int targetId)

添加此Transition对动画感兴趣的目标视图的ID。 默认情况下，没有targetIds，并且Transition将侦听场景的sceneRoot下面的每个视图的变化。 设置targetIds会限制转换仅侦听并操作带有这些ID的视图。 具有不同ID的视图或任何ID都将被忽略。

请注意，使用ID指定目标意味着ID应该在场景根下的视图层次结构中是唯一的。

addTarget

Transition addTarget (Class targetType)

添加此Transition对动画感兴趣的目标视图的Class。 默认情况下，没有targetTypes，并且Transition将侦听场景的sceneRoot下面的每个视图的变化。 设置targetTypes会限制Transition仅侦听这些类并对其执行操作。 不同类别的视图将被忽略。

请注意，任何可以转换为targetType的视图都将包含在内，因此如果targetType为 View.class ，则将包含所有视图。

addTarget

Transition addTarget (String targetName)

添加此Transition对动画感兴趣的目标视图的transitionName。 默认情况下，没有targetNames，Transition将侦听场景的sceneRoot下面的每个视图的变化。 设置targetNames会将转换限制为仅使用这些transitionNames来侦听和操作视图。 具有不同transitionNames的视图或任何transitionName都将被忽略。

请注意，transitionNames在视图层次结构中应该是唯一的。

canRemoveViews

boolean canRemoveViews ()

captureEndValues

void captureEndValues (TransitionValues transitionValues)

在结束场景中捕获此转换监视的属性的值。 然后这些值作为endValues结构传递给createAnimator(ViewGroup, TransitionValues, TransitionValues) 。 实施的主要关注点是过渡期关注的属性以及所有这些属性的价值。 开始和结束值将在createAnimator(android.view.ViewGroup, TransitionValues, TransitionValues)方法后期进行比较，以确定应该运行哪些动画（如果有的话）。

子类必须实现此方法。 该方法只能由过渡系统调用; 它不打算从外部类中调用。

captureStartValues

void captureStartValues (TransitionValues transitionValues)

捕获此转场监视的属性在开始场景中的值。 然后在稍后调用createAnimator(ViewGroup, TransitionValues, TransitionValues)将这些值作为startValues结构createAnimator(ViewGroup, TransitionValues, TransitionValues) 。 实施的主要关注点是过渡期关注的属性以及所有这些属性的价值。 开始和结束值将在createAnimator(android.view.ViewGroup, TransitionValues, TransitionValues)方法后期进行比较，以确定应该运行哪些动画（如果有的话）。

子类必须实现此方法。 该方法只能由过渡系统调用; 它不打算从外部类中调用。

clone

Transition clone ()

创建并返回此对象的副本。 “复制”的确切含义可能取决于对象的类别。 一般意图是，对于任何对象x ，表达式：

 x.clone() != x

 x.clone().getClass() == x.getClass()

 x.clone().equals(x)

按照惯例，应该通过调用super.clone获得返回的对象。 如果一个类和它的所有超类（除了Object ）都遵守这个约定，那么情况就是这样的情况x.clone().getClass() == x.getClass() 。

按照惯例，这个方法返回的对象应该独立于这个对象（被克隆）。 为了实现这种独立性，可能需要在返回super.clone之前修改对象的一个或多个字段。 通常，这意味着复制包含被克隆对象的内部“深层结构”的任何可变对象，并将这些对象的引用替换为对这些副本的引用。 如果一个类只包含原始字段或对不可变对象的引用，那么通常情况下不需要修改super.clone返回的对象中的任何字段。

类别Object的方法clone执行特定的克隆操作。 首先，如果该对象的类没有实现接口Cloneable ，则引发CloneNotSupportedException 。 请注意，所有数组都被认为实现了接口Cloneable并且数组类型T[]的clone方法的返回类型为T[] ，其中T是任何引用或基本类型。 否则，此方法创建该对象的类的新实例，并使用该对象的相应字段的内容来初始化其所有字段，就像通过赋值一样; 这些字段的内容本身并不克隆。 因此，此方法执行此对象的“浅拷贝”，而不是“深拷贝”操作。

类 Object本身并不实现接口 Cloneable ，所以在类 Object的对象上调用 clone方法将导致在运行时抛出异常。

createAnimator

Animator createAnimator (ViewGroup sceneRoot, 
                TransitionValues startValues, 
                TransitionValues endValues)

此方法创建一个动画，该动画将为此转换运行，因为前面为start和end场景捕获的startValues和endValues结构中的信息。 Transition的子类应该覆盖此方法。 该方法只能由过渡系统调用; 它不打算从外部类中调用。

该方法由transition的父级（一直到层次结构中最高级的Transition）调用，并使用sceneRoot和start / end值进行调用，以便转换可能需要设置初始目标值并构建适当的动画。 例如，如果总体Transition是由几个子级转换组成的TransitionSet ，则一些子级转换可能希望在整个Transition转换开始之前在目标视图上设置初始值，以使其处于延迟的适当状态在开始和孩子之间的过渡开始时间。 例如，淡入一个项目的转换可能希望将开始的alpha值设置为0，以避免在实际开始动画之前的转换之前其闪烁。 这是必要的，因为触发Transition的场景变化将自动设置所有目标视图上的结束场景，因此想要从不同值开始动画的Transition应该在从此方法返回之前设置该值。

另外，Transition可以执行逻辑来确定是否需要在给定目标上运行转换以及开始/结束值。 例如，调整屏幕上对象大小的过渡可能希望避免在开始场景或结束场景中不存在的视图运行。

如果有一个动画创建并从这个方法返回，转换机制会将任何适用的持续时间，startDelay和插补器应用到该动画并启动它。 返回值null表示不应该运行动画。 默认实现返回null。

该方法针对每个可应用的目标对象进行调用，该对象存储在 view字段中。

excludeChildren

Transition excludeChildren (int targetId, 
                boolean exclude)

是否将给定ID的子项添加到要从此过渡中排除的目标列表。 exclude参数指定是否应将目标的子项添加到排除列表或从排除列表中删除。 以这种方式排除儿童提供了一种排除所有具体目标儿童的简单机制，而不是单独排除每个儿童。

排除目标是允许转换在视图层次结构上运行同时跳过不应该成为转换部分的目标视图的一般机制。 例如，您可能希望避免为特定ListView或Spinner的子项设置动画。 视图可以通过它们的id，或它们的实例引用或该视图的Class（例如， Spinner ） Spinner 。

excludeChildren

Transition excludeChildren (Class type, 
                boolean exclude)

是否将给定的类型添加到其子类应该从此转换中排除的类型的列表中。 exclude参数指定是否应将目标类型添加到排除列表或从排除列表中删除。

排除目标是允许转换在视图层次结构上运行同时跳过不应该成为转换部分的目标视图的一般机制。 例如，您可能希望避免为特定ListView或Spinner的子项设置动画。 视图可以通过它们的id，或它们的实例引用，或该视图的Class（例如， Spinner ） Spinner 。

excludeChildren

Transition excludeChildren (View target, 
                boolean exclude)

是否将给定目标的孩子添加到目标孩子的列表中以排除此过渡。 exclude参数指定是否应将目标添加到排除列表或从排除列表中删除。

Excluding targets is a general mechanism for allowing transitions to run on a view hierarchy while skipping target views that should not be part of the transition. For example, you may want to avoid animating children of a specific ListView or Spinner. Views can be excluded either by their id, or by their instance reference, or by the Class of that view (eg, Spinner).

excludeTarget

Transition excludeTarget (View target, 
                boolean exclude)

是否将给定目标添加到要从此转换中排除的目标列表。 参数exclude指定是否应将目标添加到排除列表或从排除列表中删除。

Excluding targets is a general mechanism for allowing transitions to run on a view hierarchy while skipping target views that should not be part of the transition. For example, you may want to avoid animating children of a specific ListView or Spinner. Views can be excluded either by their id, or by their instance reference, or by the Class of that view (eg, Spinner).

excludeTarget

Transition excludeTarget (Class type, 
                boolean exclude)

是否将给定类型添加到要从此过渡中排除的类型列表。 exclude参数指定是否应将目标类型添加到排除列表或从排除列表中删除。

排除目标是允许转换在视图层次结构上运行同时跳过不应该成为转换部分的目标视图的一般机制。 例如，您可能希望避免为特定ListView或Spinner的子项设置动画。 视图可以通过它们的id，或它们的实例引用或该视图的Class（例如， Spinner ） Spinner 。

excludeTarget

Transition excludeTarget (String targetName, 
                boolean exclude)

是否将给定的transitionName添加到目标transitionNames的列表中以从此过渡中排除。 exclude参数指定是否应将目标添加到排除列表或从排除列表中删除。

排除目标是允许转换在视图层次结构上运行同时跳过不应该成为转换部分的目标视图的一般机制。 例如，您可能希望避免为特定ListView或Spinner的子项设置动画。 视图可以通过它们的id，它们的实例引用，它们的transitionName或者视图的Class（例如Spinner ） Spinner 。

excludeTarget

Transition excludeTarget (int targetId, 
                boolean exclude)

是否将给定的ID添加到目标ID列表中以从此过渡中排除。 参数exclude指定是否应将目标添加到排除列表或从排除列表中删除。

排除目标是允许转换在视图层次结构上运行同时跳过不应该成为转换部分的目标视图的一般机制。 例如，您可能希望避免为特定ListView或Spinner的子项设置动画。 视图可以通过它们的id或其实例引用或该视图的Class（例如Spinner ） Spinner 。

getDuration

long getDuration ()

返回在此转换中设置的持续时间。 如果没有设置持续时间，返回值将为负值，表示动画师将保留自己的持续时间。

getEpicenter

Rect getEpicenter ()

返回 Transition.EpicenterCallback指定的震中，如果不存在回调，则 Transition.EpicenterCallback null。

getEpicenterCallback

Transition.EpicenterCallback getEpicenterCallback ()

返回用于查找Transition的震中的回调。 诸如Explode类的Explode使用点或Rect来定位行进方向。 这被称为过渡的中心，通常集中在一个触摸的视图。 Transition.EpicenterCallback允许一个转换动态检索过渡期间的震中。

getInterpolator

TimeInterpolator getInterpolator ()

返回此转换中的插补器集。 如果未设置插补器，则返回的值将为空，表示动画师将保留自己的插补器。

getName

String getName ()

返回此Transition的名称。 该名称在内部用于区分不同的转换以确定何时中断转换重叠。 例如，与另一个ChangeBounds在同一个目标视图上运行的ChangeBounds应确定旧的过渡是否动画到不同的最终值，并且应该取消以支持新的过渡。

默认情况下，Transition的名称只是 getName()的值，但子类可以自由覆盖并返回不同的内容。

getPathMotion

PathMotion getPathMotion ()

返回用于沿着两个维度进行插值的算法对象。 这通常用于确定两点之间的视图运动。

在用XML描述时，为路径运动使用嵌套的XML标记。 它可以是内置标签arcMotion或patternPathMotion ，也可以是使用pathMotion的定制PathMotion， class归因于完全描述的类名称。 例如：

<changeBounds>
     <pathMotion class="my.app.transition.MyPathMotion"/>
 </changeBounds>
 

要么

<changeBounds>
   <arcMotion android:minimumHorizontalAngle="15"
              android:minimumVerticalAngle="0"
              android:maximumAngle="90"/>
 </changeBounds>
 

getPropagation

TransitionPropagation getPropagation ()

返回用于计算Animator启动延迟的TransitionPropagation 。 当一个转换影响像Explode或Slide这样的几个视图时，可能需要有一个“波前”效应，这样动画开始延迟取决于视图的位置。 TransitionPropagation指定如何计算启动延迟。

getStartDelay

long getStartDelay ()

返回此转换中设置的startDelay。 如果没有设置startDelay，则返回的值将为负值，表示生成的动画人员将保留自己的startDelay。

getTargetIds

List<Integer> getTargetIds ()

返回此转换将其自身限制为跟踪和动画的目标ID列表。 如果列表为空或为空getTargetIds() ， getTargets() ， getTargetNames() ，并getTargetTypes()那么这种转变并不限于特定的意见，并将处理变化的场景变化的层次结构的任何意见。

getTargetNames

List<String> getTargetNames ()

返回此转换将其自身限制为跟踪和动画的目标transitionNames的列表。 如果列表为空或为空getTargetIds() ， getTargets() ， getTargetNames() ，并getTargetTypes()那么这种转变并不限于特定的意见，并将处理变化的场景变化的层次结构的任何意见。

getTargetTypes

List<Class> getTargetTypes ()

返回此转换将其自身限制为跟踪和动画的目标transitionNames的列表。 如果列表为空或为空getTargetIds() ， getTargets() ， getTargetNames() ，并getTargetTypes()那么这种转变并不限于特定的意见，并将处理变化的场景变化的层次结构的任何意见。

getTargets

List<View> getTargets ()

返回此转换将其自身限制为跟踪和动画的目标视图列表。 如果列表为空或为空getTargetIds() ， getTargets() ， getTargetNames() ，并getTargetTypes()那么这种转变并不限于特定的意见，并将处理变化的场景变化的层次结构的任何意见。

getTransitionProperties

String[] getTransitionProperties ()

返回存储在传递到TransitionValues对象中的属性名称captureStartValues(TransitionValues) ，此对象用于取消重叠动画。 当在给定场景根上开始任何转场时，将检查当前在同一场景根上运行的所有转场，以查看它们基于其动画的属性是否与新转场中相同属性的最终值一致。 如果最终值不相等，则旧的动画将被取消，因为新的转换将为这些新值开始新的动画。 如果值相等，则允许旧动画继续，并且不会为该转换启动新的动画。

过渡不需要重写此方法。 但是，如果不这样做，则意味着上一段中所述的取消逻辑将跳过该转换，可能会导致人为因素，因为旧转换和同一目标上的新转换并行运行，将视图动画化为可能不同的最终值。

getTransitionValues

TransitionValues getTransitionValues (View view, 
                boolean start)

在转换播放过程中，可以通过转换来调用此方法以获取任何特定视图的TransitionValues。 例如，这可能是必要的，以查询给定转换的相关视图的前/后状态。

isTransitionRequired

boolean isTransitionRequired (TransitionValues startValues, 
                TransitionValues endValues)

基于captureStartValues(TransitionValues)和captureEndValues(TransitionValues)期间捕获的值，返回过渡是否应创建Animator。 默认实现比较从getTransitionProperties()返回的属性值，或者如果getTransitionProperties()返回null，则返回所有属性值。 子类可以重写此方法来为转换实现提供更具体的逻辑。

removeListener

Transition removeListener (Transition.TransitionListener listener)

从侦听此动画的集合中删除侦听器。

removeTarget

Transition removeTarget (int targetId)

从该Transition对动画感兴趣的id列表中移除给定的targetId。

removeTarget

Transition removeTarget (View target)

从该转换对动画感兴趣的目标列表中删除给定的目标。

removeTarget

Transition removeTarget (String targetName)

从Transition转换对动画感兴趣的transitionNames列表中删除给定的targetName。

removeTarget

Transition removeTarget (Class target)

从该转换对动画感兴趣的目标列表中删除给定的目标。

setDuration

Transition setDuration (long duration)

设置此转换的持续时间。 默认情况下，没有持续时间（由负数表示），这意味着由过渡创建的动画制作者将拥有自己的指定持续时间。 如果设置了过渡的持续时间，则该持续时间将覆盖动画持续时间。

相关XML属性：

• android:duration

setEpicenterCallback

void setEpicenterCallback (Transition.EpicenterCallback epicenterCallback)

设置回调以用于查找转场的震中。 空值表示Transition中没有震中，onGetEpicenter（）将返回null。 诸如Explode类的Explode使用一个点或Rect来定位行进方向。 这被称为过渡的中心，通常集中在一个触摸的视图。 Transition.EpicenterCallback允许转换在转换期间动态检索震中。

setInterpolator

Transition setInterpolator (TimeInterpolator interpolator)

设置此转换的插补器。 默认情况下，插补器为空，这意味着由转换创建的Animator将拥有自己的指定插补器。 如果设置了Transition的插补器，则该插补器将覆盖Animator插补器。

相关XML属性：

• android:interpolator

setMatchOrder

void setMatchOrder (int... matches)

设置Transition与View开始值和结束值的匹配顺序。

默认行为是通过首先匹配getTransitionName() ，然后通过查看实例，然后通过getId()其项目编号以及最后如果是在ListView控件的直接子。 来电者只能选择有一些或全部的值MATCH_INSTANCE ， MATCH_NAME ， MATCH_ITEM_ID ，并MATCH_ID 。 只有提供的匹配算法才会用于确定视图在开始场景和结束场景中是否相同。 不匹配的视图将被视为进入或离开场景。

setPathMotion

void setPathMotion (PathMotion pathMotion)

设置用于计算二维插值的算法。

诸如ChangeBounds转ChangeBounds移动视图，通常位于起始位置和结束位置之间的直线路径中。 希望让这些运动以曲线形式移动的应用程序可以通过扩展PathMotion并实现getPath(float, float, float, float)来改变View在二维中的内插getPath(float, float, float, float) 。

在用XML描述时，为路径运动使用嵌套的XML标记。 它可以是内置标签arcMotion或patternPathMotion ，也可以是使用pathMotion的自定义PathMotion， class属于完全描述的类名称。 例如：

 <changeBounds>
     <pathMotion class="my.app.transition.MyPathMotion"/>
 </changeBounds>
 
 

要么

 <changeBounds>
   <arcMotion android:minimumHorizontalAngle="15"
     android:minimumVerticalAngle="0" android:maximumAngle="90"/>
 </changeBounds>
 
 

setPropagation

void setPropagation (TransitionPropagation transitionPropagation)

设置确定动画制作者启动延迟的方法。 当过渡影响像Explode或Slide这样的几个视图时，可能需要产生“波前”效应，以使动画开始延迟取决于视图的位置。 TransitionPropagation指定如何计算启动延迟。

setStartDelay

Transition setStartDelay (long startDelay)

设置此转换的startDelay。 默认情况下，没有延迟（由负数表示），这意味着由过渡创建的Animator将拥有自己的指定startDelay。 如果设置了延迟时间，则延迟将覆盖Animator延迟。

相关XML属性：

• android:startDelay

toString

String toString ()

返回对象的字符串表示形式。 通常， toString方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述，对于一个人来说很容易阅读。 建议所有子类重写此方法。

toString类的方法Object返回一个字符串，其中包含对象为实例的类的名称，符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示。 换句话说，这个方法返回一个字符串，其值等于：

 getClass().getName() + '@' + Integer.toHexString(hashCode())