PropertyValuesHolder

clone

PropertyValuesHolder 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方法将导致在运行时抛出异常。

getPropertyName

String getPropertyName ()

获取将被动画的属性的名称。 这个名字将被用来派生一个setter函数来调用设置动画值。 例如，属性名称foo将导致调用目标对象上的函数setFoo() 。 如果valueFrom或valueTo为空，则也会派生并调用getter函数。

ofFloat

PropertyValuesHolder ofFloat (Property<?, Float> property, 
                float... values)

构造并返回一个PropertyValuesHolder，其中包含一个给定的属性和一组浮点值。

ofFloat

PropertyValuesHolder ofFloat (String propertyName, 
                float... values)

构造并返回一个PropertyValuesHolder，其中包含一个给定的属性名称和一组浮点值。

ofInt

PropertyValuesHolder ofInt (String propertyName, 
                int... values)

构造并返回一个具有给定属性名称和一组int值的PropertyValuesHolder。

ofInt

PropertyValuesHolder ofInt (Property<?, Integer> property, 
                int... values)

构造并返回一个PropertyValuesHolder，其中包含一个给定的属性和一组int值。

ofKeyframe

PropertyValuesHolder ofKeyframe (String propertyName, 
                Keyframe... values)

构造并返回一个PropertyValuesHolder对象，其中包含指定的属性名称和一组值。 这些值可以是任何类型，但类型应该一致，以便找到与公共类型匹配的适当的TypeEvaluator 。

如果只有一个值，则它被假定为动画的最终值，并且如果可能，将通过调用对象的getter函数来派生初始值。 另外，如果任何值为null，则在以相同方式开始动画时，该值将被填充。 这种自动获得空值的机制仅在PropertyValuesHolder对象与ObjectAnimator结合使用时ObjectAnimator ，并且自propertyName自动导出getter函数，否则PropertyValuesHolder无法确定该值应该是什么。

ofKeyframe

PropertyValuesHolder ofKeyframe (Property property, 
                Keyframe... values)

构造并返回一个PropertyValuesHolder对象，其中包含指定的属性和一组值。 这些值可以是任何类型，但类型应该一致，以便找到与公共类型匹配的适当的TypeEvaluator 。

如果只有一个值，则假定为动画的结束值，并且如果可能的话，将通过调用属性的get(Object)函数来派生初始值。 另外，如果任何值为null，则在以相同方式开始动画时，该值将被填充。 这种自动获取空值的机制只有在PropertyValuesHolder对象与ObjectAnimator结合使用ObjectAnimator ，否则PropertyValuesHolder无法确定该值应该是什么。

ofMultiFloat

PropertyValuesHolder ofMultiFloat (String propertyName, 
                float[][] values)

构造并返回一个PropertyValuesHolder，其中包含一个给定的属性名称和一组值为float[]值。 必须提供至少两个float[]值，一个起始值和一个最终值。 如果提供了更多值，则会从开始时间开始通过所有中间值对结果值进行动画处理。 当与ObjectAnimator一起使用时，数组的元素表示setter函数的参数。

ofMultiFloat

PropertyValuesHolder ofMultiFloat (String propertyName, 
                TypeConverter<V, float[]> converter, 
                TypeEvaluator<V> evaluator, 
                V... values)

使用ObjectAnimator多值设置器构造并返回一个PropertyValuesHolder，该PropertyValuesHolder具有给定属性和一组Object值。 对象值使用转换器转换为float[] 。

ofMultiFloat

PropertyValuesHolder ofMultiFloat (String propertyName, 
                Path path)

构造并返回一个PropertyValuesHolder，该PropertyValuesHolder具有给定的属性名称以用作多浮点设置器。 值沿路径动画，setter的第一个参数设置为x坐标，第二个参数设置为y坐标。

ofMultiFloat

PropertyValuesHolder ofMultiFloat (String propertyName, 
                TypeConverter<T, float[]> converter, 
                TypeEvaluator<T> evaluator, 
                Keyframe... values)

使用ObjectAnimator构造并返回一个带有指定属性名称或设置者名称的PropertyValuesHolder对象，用于多浮点设置函数。 值可以是任何类型，但类型应该一致，以便可以使用提供的TypeEvaluator来评估动画值。 converter将值转换为setter函数中的参数。

至少必须提供两个值，即开始值和结束值。

ofMultiInt

PropertyValuesHolder ofMultiInt (String propertyName, 
                Path path)

构造并返回一个PropertyValuesHolder，该PropertyValuesHolder具有给定的属性名称以用作多诠释设置器。 值沿路径动画，setter的第一个参数设置为x坐标，第二个参数设置为y坐标。

ofMultiInt

PropertyValuesHolder ofMultiInt (String propertyName, 
                TypeConverter<T, int[]> converter, 
                TypeEvaluator<T> evaluator, 
                Keyframe... values)

使用ObjectAnimator构造并返回一个PropertyValuesHolder对象，该对象具有指定的属性名称或设置者名称以用于多int设置器函数。 值可以是任何类型，但类型应该一致，以便提供的TypeEvaluator可用于评估动画值。 converter将值转换为setter函数中的参数。

至少必须提供两个值，即开始值和结束值。

ofMultiInt

PropertyValuesHolder ofMultiInt (String propertyName, 
                TypeConverter<V, int[]> converter, 
                TypeEvaluator<V> evaluator, 
                V... values)

使用ObjectAnimator多值设置器构造并返回一个PropertyValuesHolder，该PropertyValuesHolder具有给定属性和一组Object值。 对象值使用转换器转换为int[] 。

ofMultiInt

PropertyValuesHolder ofMultiInt (String propertyName, 
                int[][] values)

构造并返回一个PropertyValuesHolder，其中包含一个给定的属性名称和一组值为int[]值。 必须提供至少两个int[]值，一个开始和结束值。 如果提供了更多值，则会从开始时间开始通过所有中间值对结果值进行动画处理。 当与ObjectAnimator一起使用时，数组的元素表示setter函数的参数。

ofObject

PropertyValuesHolder ofObject (String propertyName, 
                TypeConverter<PointF, ?> converter, 
                Path path)

构造并返回一个PropertyValuesHolder，该PropertyValuesHolder具有给定的属性名称和一个路径，值应该用于动画。 该变体支持将TypeConverter从PointF转换为目标类型。

如果 converter是 null ，则PointF传递给 converter或 property ， converter值在每个动画帧上重复使用，不应由setter或TypeConverter存储。

ofObject

PropertyValuesHolder ofObject (String propertyName, 
                TypeEvaluator evaluator, 
                Object... values)

构造并返回一个PropertyValuesHolder，其中包含一个给定的属性名称和一组Object值。 此变体也采用TypeEvaluator，因为系统不能在未知类型的对象之间自动插值。

注意： Object值存储为对原始对象的引用，这意味着调用此方法后对这些对象的更改将影响PropertyValuesHolder上的值。 如果在调用此方法后对象将在外部发生变化，则调用者应该传递这些对象的副本。

ofObject

PropertyValuesHolder ofObject (Property<?, V> property, 
                TypeConverter<T, V> converter, 
                TypeEvaluator<T> evaluator, 
                T... values)

构造并返回一个PropertyValuesHolder，其中包含一个给定的属性和一组Object值。 此变体也采用TypeEvaluator，因为系统不能在未知类型的对象之间自动插值。 该变体还需要TypeConverter将动画值转换为属性的类型。 如果仅提供一个值，则TypeConverter必须是BidirectionalTypeConverter才能检索当前值。

注意： Object值存储为对原始对象的引用，这意味着调用此方法后对这些对象的更改将影响PropertyValuesHolder上的值。 如果在调用此方法后对象将在外部发生变化，则调用者应该传递这些对象的副本。

ofObject

PropertyValuesHolder ofObject (Property property, 
                TypeEvaluator<V> evaluator, 
                V... values)

构造并返回一个PropertyValuesHolder，其中包含一个给定的属性和一组Object值。 此变体也采用TypeEvaluator，因为系统不能在未知类型的对象之间自动插值。

注意： Object值存储为对原始对象的引用，这意味着调用此方法后对这些对象的更改将影响PropertyValuesHolder上的值。 如果在调用此方法后对象将在外部发生变化，则调用者应该传递这些对象的副本。

ofObject

PropertyValuesHolder ofObject (Property<?, V> property, 
                TypeConverter<PointF, V> converter, 
                Path path)

构造并返回一个PropertyValuesHolder，该PropertyValuesHolder具有一个给定的属性和一个路径，值应该沿着这个路径动画化。 此变体支持将TypeConverter从PointF转换为目标类型。

如果 converter为 null ，则PointF传递给 converter或 property ， converter值在每个动画帧上重复使用，不应由setter或TypeConverter存储。

setConverter

void setConverter (TypeConverter converter)

将转换器设置为从值类型转换为设置者的参数类型。 如果只提供一个值，则转换器必须是BidirectionalTypeConverter 。

setEvaluator

void setEvaluator (TypeEvaluator evaluator)

TypeEvaluator将根据提供给PropertyValuesHolder的值的类型自动确定。 但是，如果需要，评估人员可以手动设置。 如果提供的值的类型与它们之间插值的方式不匹配，或者值是自定义类型或动画系统当前不能理解的值，则这可能很重要。 目前，只有float和int类型的值（以及它们的Object对象：Float和Integer）才被正确插值; 所有其他类型都需要设置TypeEvaluator。

setFloatValues

void setFloatValues (float... values)

将此对象的动画值设置为这组浮点数。 如果只有一个值，则它被假定为动画的最终值，并且如果可能，将通过调用对象的getter函数来派生初始值。 另外，如果任何值为null，则在以相同方式开始动画时，该值将被填充。 这种自动获得空值的机制只有在PropertyValuesHolder对象与ObjectAnimator结合ObjectAnimator ，以及从propertyName自动导出的getter函数propertyName ，因为否则，PropertyValuesHolder无法确定该值应该是什么。

setIntValues

void setIntValues (int... values)

将此对象的动画值设置为这组int值。 如果只有一个值，则它被假定为动画的最终值，并且如果可能，将通过调用对象的getter函数来派生初始值。 另外，如果任何值为null，则在以相同方式开始动画时，该值将被填充。 这种自动获取空值的机制仅在PropertyValuesHolder对象与ObjectAnimator结合使用时ObjectAnimator ，并且自propertyName自动导出getter函数，否则PropertyValuesHolder无法确定值应该是什么。

setKeyframes

void setKeyframes (Keyframe... values)

将此对象的动画值设置为这组关键帧。

setObjectValues

void setObjectValues (Object... values)

将此对象的动画值设置为这组对象。 如果只有一个值，则它被假定为动画的最终值，并且如果可能，将通过调用对象的getter函数来派生初始值。 另外，如果任何值为null，则在以相同方式开始动画时，该值将被填充。 这种自动获得空值的机制仅在PropertyValuesHolder对象与ObjectAnimator结合使用时ObjectAnimator ，并且自propertyName自动导出getter函数，否则PropertyValuesHolder无法确定值应该是什么。

注意： Object值存储为对原始对象的引用，这意味着调用此方法后对这些对象的更改将影响PropertyValuesHolder上的值。 如果在调用此方法后对象将在外部发生变化，则调用者应该传递这些对象的副本。

setProperty

void setProperty (Property property)

设置将被动画的属性。

请注意，如果此PropertyValuesHolder对象与ObjectAnimator一起使用，则该属性必须存在于该ObjectAnimator中指定的目标对象上。

setPropertyName

void setPropertyName (String propertyName)

设置将要动画的属性的名称。 这个名字被用来派生一个setter函数来调用设置动画值。 例如，属性名称foo将导致调用目标对象上的函数setFoo() 。 如果valueFrom或valueTo为空，则也会派生并调用getter函数。

请注意，从此属性名派生的setter函数必须采用与 valueFrom和 valueTo属性相同的参数类型，否则调用setter函数的调用将失败。

toString

String toString ()

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

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

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