PropertyValuesHolder

clone

@NonNull open fun clone(): PropertyValuesHolder

getPropertyName

@NonNull open fun getPropertyName(): String

Gets the name of the property that will be animated. This name will be used to derive a setter function that will be called to set animated values. For example, a property name of foo will result in a call to the function setFoo() on the target object. If either valueFrom or valueTo is null, then a getter function will also be derived and called.

ofFloat

@NonNull open static fun ofFloat(
    @NonNull propertyName: String, 
    @NonNull vararg values: Float
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property name and set of float values.

ofFloat

@NonNull open static fun ofFloat(
    @NonNull property: Property<*, Float!>, 
    @NonNull vararg values: Float
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property and set of float values.

ofInt

@NonNull open static fun ofInt(
    @NonNull propertyName: String, 
    @NonNull vararg values: Int
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property name and set of int values.

ofInt

@NonNull open static fun ofInt(
    @NonNull property: Property<*, Int!>, 
    @NonNull vararg values: Int
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property and set of int values.

ofKeyframe

@SafeVarargs @NonNull open static fun ofKeyframe(
    @NonNull propertyName: String, 
    @NonNull vararg values: Keyframe<Any!>!
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder object with the specified property name and set of values. These values can be of any type, but the type should be consistent so that an appropriate TypeEvaluator can be found that matches the common type.

If there is only one value, it is assumed to be the end value of an animation, and an initial value will be derived, if possible, by calling a getter function on the object. Also, if any value is null, the value will be filled in when the animation starts in the same way. This mechanism of automatically getting null values only works if the PropertyValuesHolder object is used in conjunction ObjectAnimator, and with a getter function derived automatically from propertyName, since otherwise PropertyValuesHolder has no way of determining what the value should be.

ofKeyframe

@SafeVarargs @NonNull open static fun ofKeyframe(
    @NonNull property: Property<Any!, Any!>, 
    @NonNull vararg values: Keyframe<Any!>!
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder object with the specified property and set of values. These values can be of any type, but the type should be consistent so that an appropriate androidx.core.animation.TypeEvaluator can be found that matches the common type.

If there is only one value, it is assumed to be the end value of an animation, and an initial value will be derived, if possible, by calling the property's android.util.Property#get(Object) function. Also, if any value is null, the value will be filled in when the animation starts in the same way. This mechanism of automatically getting null values only works if the PropertyValuesHolder object is used in conjunction with ObjectAnimator, since otherwise PropertyValuesHolder has no way of determining what the value should be.

ofMultiFloat

@NonNull open static fun ofMultiFloat(
    @NonNull propertyName: String, 
    @NonNull values: Array<FloatArray!>
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property name and set of float[] values. At least two float[] values must be supplied, a start and end value. If more values are supplied, the values will be animated from the start, through all intermediate values to the end value. When used with ObjectAnimator, the elements of the array represent the parameters of the setter function.

ofMultiFloat

@NonNull open static fun ofMultiFloat(
    @NonNull propertyName: String, 
    @NonNull path: Path
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property name to use as a multi-float setter. The values are animated along the path, with the first parameter of the setter set to the x coordinate and the second set to the y coordinate.

ofMultiFloat

@SafeVarargs @NonNull open static fun <V : Any!> ofMultiFloat(
    @NonNull propertyName: String, 
    @NonNull converter: TypeConverter<V, FloatArray!>, 
    @NonNull evaluator: TypeEvaluator<V>, 
    @NonNull vararg values: V
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property and set of Object values for use with ObjectAnimator multi-value setters. The Object values are converted to float[] using the converter.

ofMultiFloat

@SafeVarargs @NonNull open static fun <T : Any!> ofMultiFloat(
    @NonNull propertyName: String, 
    @Nullable converter: TypeConverter<T, FloatArray!>?, 
    @NonNull evaluator: TypeEvaluator<T>, 
    @NonNull vararg values: Keyframe<Any!>!
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder object with the specified property name or setter name for use in a multi-float setter function using ObjectAnimator. The values can be of any type, but the type should be consistent so that the supplied TypeEvaluator can be used to to evaluate the animated value. The converter converts the values to parameters in the setter function.

At least two values must be supplied, a start and an end value.

ofMultiInt

@NonNull open static fun ofMultiInt(
    @NonNull propertyName: String, 
    @NonNull values: Array<IntArray!>
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property name and set of int[] values. At least two int[] values must be supplied, a start and end value. If more values are supplied, the values will be animated from the start, through all intermediate values to the end value. When used with ObjectAnimator, the elements of the array represent the parameters of the setter function.

ofMultiInt

@NonNull open static fun ofMultiInt(
    @NonNull propertyName: String, 
    @NonNull path: Path
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property name to use as a multi-int setter. The values are animated along the path, with the first parameter of the setter set to the x coordinate and the second set to the y coordinate.

ofMultiInt

@SafeVarargs @NonNull open static fun <V : Any!> ofMultiInt(
    @NonNull propertyName: String, 
    @NonNull converter: TypeConverter<V, IntArray!>, 
    @NonNull evaluator: TypeEvaluator<V>, 
    @NonNull vararg values: V
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property and set of Object values for use with ObjectAnimator multi-value setters. The Object values are converted to int[] using the converter.

ofMultiInt

@SafeVarargs @NonNull open static fun <T : Any!> ofMultiInt(
    @NonNull propertyName: String, 
    @Nullable converter: TypeConverter<T, IntArray!>?, 
    @NonNull evaluator: TypeEvaluator<T>, 
    @NonNull vararg values: Keyframe<Any!>!
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder object with the specified property name or setter name for use in a multi-int setter function using ObjectAnimator. The values can be of any type, but the type should be consistent so that the supplied TypeEvaluator can be used to to evaluate the animated value. The converter converts the values to parameters in the setter function.

At least two values must be supplied, a start and an end value.

ofObject

@NonNull open static fun ofObject(
    @NonNull propertyName: String, 
    @NonNull evaluator: TypeEvaluator<Any!>, 
    @NonNull vararg values: Any!
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property name and set of Object values. This variant also takes a TypeEvaluator because the system cannot automatically interpolate between objects of unknown type.

Note: The Object values are stored as references to the original objects, which means that changes to those objects after this method is called will affect the values on the PropertyValuesHolder. If the objects will be mutated externally after this method is called, callers should pass a copy of those objects instead.

ofObject

@NonNull open static fun ofObject(
    @NonNull propertyName: String, 
    @Nullable converter: TypeConverter<PointF!, *>?, 
    @NonNull path: Path
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property name and a Path along which the values should be animated. This variant supports a TypeConverter to convert from PointF to the target type.

The PointF passed to converter or property, if converter is null, is reused on each animation frame and should not be stored by the setter or TypeConverter.

ofObject

@SafeVarargs @NonNull open static fun <V : Any!> ofObject(
    @NonNull property: Property<Any!, Any!>, 
    @NonNull evaluator: TypeEvaluator<V>, 
    @NonNull vararg values: V
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property and set of Object values. This variant also takes a TypeEvaluator because the system cannot automatically interpolate between objects of unknown type.

Note: The Object values are stored as references to the original objects, which means that changes to those objects after this method is called will affect the values on the PropertyValuesHolder. If the objects will be mutated externally after this method is called, callers should pass a copy of those objects instead.

ofObject

@SafeVarargs @NonNull open static fun <T : Any!, V : Any!> ofObject(
    @NonNull property: Property<*, V>, 
    @NonNull converter: TypeConverter<T, V>, 
    @NonNull evaluator: TypeEvaluator<T>, 
    @NonNull vararg values: T
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property and set of Object values. This variant also takes a TypeEvaluator because the system cannot automatically interpolate between objects of unknown type. This variant also takes a TypeConverter to convert from animated values to the type of the property. If only one value is supplied, the TypeConverter must be a BidirectionalTypeConverter to retrieve the current value.

Note: The Object values are stored as references to the original objects, which means that changes to those objects after this method is called will affect the values on the PropertyValuesHolder. If the objects will be mutated externally after this method is called, callers should pass a copy of those objects instead.

ofObject

@NonNull open static fun <V : Any!> ofObject(
    @NonNull property: Property<*, V>, 
    @Nullable converter: TypeConverter<PointF!, V>?, 
    @NonNull path: Path
): PropertyValuesHolder

Constructs and returns a PropertyValuesHolder with a given property and a Path along which the values should be animated. This variant supports a TypeConverter to convert from PointF to the target type.

The PointF passed to converter or property, if converter is null, is reused on each animation frame and should not be stored by the setter or TypeConverter.

setConverter

open fun setConverter(@Nullable converter: TypeConverter<Any!, Any!>?): Unit

Sets the converter to convert from the values type to the setter's parameter type. If only one value is supplied, converter must be a BidirectionalTypeConverter.

setEvaluator

open fun setEvaluator(@NonNull evaluator: TypeEvaluator<Any!>): Unit

The TypeEvaluator will be automatically determined based on the type of values supplied to PropertyValuesHolder. The evaluator can be manually set, however, if so desired. This may be important in cases where either the type of the values supplied do not match the way that they should be interpolated between, or if the values are of a custom type or one not currently understood by the animation system. Currently, only values of type float and int (and their Object equivalents: Float and Integer) are correctly interpolated; all other types require setting a TypeEvaluator.

setFloatValues

open fun setFloatValues(@NonNull vararg values: Float): Unit

Set the animated values for this object to this set of floats. If there is only one value, it is assumed to be the end value of an animation, and an initial value will be derived, if possible, by calling a getter function on the object. Also, if any value is null, the value will be filled in when the animation starts in the same way. This mechanism of automatically getting null values only works if the PropertyValuesHolder object is used in conjunction ObjectAnimator, and with a getter function derived automatically from propertyName, since otherwise PropertyValuesHolder has no way of determining what the value should be.

setIntValues

open fun setIntValues(@NonNull vararg values: Int): Unit

Set the animated values for this object to this set of ints. If there is only one value, it is assumed to be the end value of an animation, and an initial value will be derived, if possible, by calling a getter function on the object. Also, if any value is null, the value will be filled in when the animation starts in the same way. This mechanism of automatically getting null values only works if the PropertyValuesHolder object is used in conjunction ObjectAnimator, and with a getter function derived automatically from propertyName, since otherwise PropertyValuesHolder has no way of determining what the value should be.

setKeyframes

open fun setKeyframes(@NonNull vararg values: Keyframe<Any!>!): Unit

Set the animated values for this object to this set of Keyframes.

setObjectValues

open fun setObjectValues(@NonNull vararg values: Any!): Unit

Set the animated values for this object to this set of Objects. If there is only one value, it is assumed to be the end value of an animation, and an initial value will be derived, if possible, by calling a getter function on the object. Also, if any value is null, the value will be filled in when the animation starts in the same way. This mechanism of automatically getting null values only works if the PropertyValuesHolder object is used in conjunction ObjectAnimator, and with a getter function derived automatically from propertyName, since otherwise PropertyValuesHolder has no way of determining what the value should be.

Note: The Object values are stored as references to the original objects, which means that changes to those objects after this method is called will affect the values on the PropertyValuesHolder. If the objects will be mutated externally after this method is called, callers should pass a copy of those objects instead.

setProperty

open fun setProperty(@NonNull property: Property<Any!, Any!>): Unit

Sets the property that will be animated.

Note that if this PropertyValuesHolder object is used with ObjectAnimator, the property must exist on the target object specified in that ObjectAnimator.

setPropertyName

open fun setPropertyName(@NonNull propertyName: String): Unit

Sets the name of the property that will be animated. This name is used to derive a setter function that will be called to set animated values. For example, a property name of foo will result in a call to the function setFoo() on the target object. If either valueFrom or valueTo is null, then a getter function will also be derived and called.

Note that the setter function derived from this property name must take the same parameter type as the valueFrom and valueTo properties, otherwise the call to the setter function will fail.

toString

@NonNull open fun toString(): String