IT. Expert System.

Android Reference

ViewPropertyAnimator


android.view

Class ViewPropertyAnimator



  • public class ViewPropertyAnimator
    extends Object
    This class enables automatic and optimized animation of select properties on View objects. If only one or two properties on a View object are being animated, then using an ObjectAnimator is fine; the property setters called by ObjectAnimator are well equipped to do the right thing to set the property and invalidate the view appropriately. But if several properties are animated simultaneously, or if you just want a more convenient syntax to animate a specific property, then ViewPropertyAnimator might be more well-suited to the task.

    This class may provide better performance for several simultaneous animations, because it will optimize invalidate calls to take place only once for several properties instead of each animated property independently causing its own invalidation. Also, the syntax of using this class could be easier to use because the caller need only tell the View object which property to animate, and the value to animate either to or by, and this class handles the details of configuring the underlying Animator class and starting it.

    This class is not constructed by the caller, but rather by the View whose properties it will animate. Calls to View.animate() will return a reference to the appropriate ViewPropertyAnimator object for that View.

    • Method Detail

      • setDuration

        public ViewPropertyAnimator setDuration(long duration)
        Sets the duration for the underlying animator that animates the requested properties. By default, the animator uses the default value for ValueAnimator. Calling this method will cause the declared value to be used instead.
        Parameters:
        duration - The length of ensuing property animations, in milliseconds. The value cannot be negative.
        Returns:
        This object, allowing calls to methods in this class to be chained.
      • getDuration

        public long getDuration()
        Returns the current duration of property animations. If the duration was set on this object, that value is returned. Otherwise, the default value of the underlying Animator is returned.
        Returns:
        The duration of animations, in milliseconds.
        See Also:
        setDuration(long)
      • getStartDelay

        public long getStartDelay()
        Returns the current startDelay of property animations. If the startDelay was set on this object, that value is returned. Otherwise, the default value of the underlying Animator is returned.
        Returns:
        The startDelay of animations, in milliseconds.
        See Also:
        setStartDelay(long)
      • setStartDelay

        public ViewPropertyAnimator setStartDelay(long startDelay)
        Sets the startDelay for the underlying animator that animates the requested properties. By default, the animator uses the default value for ValueAnimator. Calling this method will cause the declared value to be used instead.
        Parameters:
        startDelay - The delay of ensuing property animations, in milliseconds. The value cannot be negative.
        Returns:
        This object, allowing calls to methods in this class to be chained.
      • setInterpolator

        public ViewPropertyAnimator setInterpolator(TimeInterpolator interpolator)
        Sets the interpolator for the underlying animator that animates the requested properties. By default, the animator uses the default interpolator for ValueAnimator. Calling this method will cause the declared object to be used instead.
        Parameters:
        interpolator - The TimeInterpolator to be used for ensuing property animations.
        Returns:
        This object, allowing calls to methods in this class to be chained.
      • setListener

        public ViewPropertyAnimator setListener(Animator.AnimatorListener listener)
        Sets a listener for events in the underlying Animators that run the property animations.
        Parameters:
        listener - The listener to be called with AnimatorListener events.
        Returns:
        This object, allowing calls to methods in this class to be chained.
      • start

        public void start()
        Starts the currently pending property animations immediately. Calling start() is optional because all animations start automatically at the next opportunity. However, if the animations are needed to start immediately and synchronously (not at the time when the next event is processed by the hierarchy, which is when the animations would begin otherwise), then this method can be used.
      • cancel

        public void cancel()
        Cancels all property animations that are currently running or pending.
      • x

        public ViewPropertyAnimator x(float value)
        This method will cause the View's x property to be animated to the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The value to be animated to.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setX(float)
      • xBy

        public ViewPropertyAnimator xBy(float value)
        This method will cause the View's x property to be animated by the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The amount to be animated by, as an offset from the current value.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setX(float)
      • y

        public ViewPropertyAnimator y(float value)
        This method will cause the View's y property to be animated to the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The value to be animated to.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setY(float)
      • yBy

        public ViewPropertyAnimator yBy(float value)
        This method will cause the View's y property to be animated by the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The amount to be animated by, as an offset from the current value.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setY(float)
      • rotation

        public ViewPropertyAnimator rotation(float value)
        This method will cause the View's rotation property to be animated to the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The value to be animated to.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setRotation(float)
      • rotationBy

        public ViewPropertyAnimator rotationBy(float value)
        This method will cause the View's rotation property to be animated by the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The amount to be animated by, as an offset from the current value.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setRotation(float)
      • rotationX

        public ViewPropertyAnimator rotationX(float value)
        This method will cause the View's rotationX property to be animated to the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The value to be animated to.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setRotationX(float)
      • rotationXBy

        public ViewPropertyAnimator rotationXBy(float value)
        This method will cause the View's rotationX property to be animated by the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The amount to be animated by, as an offset from the current value.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setRotationX(float)
      • rotationY

        public ViewPropertyAnimator rotationY(float value)
        This method will cause the View's rotationY property to be animated to the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The value to be animated to.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setRotationY(float)
      • rotationYBy

        public ViewPropertyAnimator rotationYBy(float value)
        This method will cause the View's rotationY property to be animated by the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The amount to be animated by, as an offset from the current value.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setRotationY(float)
      • translationX

        public ViewPropertyAnimator translationX(float value)
        This method will cause the View's translationX property to be animated to the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The value to be animated to.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setTranslationX(float)
      • translationXBy

        public ViewPropertyAnimator translationXBy(float value)
        This method will cause the View's translationX property to be animated by the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The amount to be animated by, as an offset from the current value.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setTranslationX(float)
      • translationY

        public ViewPropertyAnimator translationY(float value)
        This method will cause the View's translationY property to be animated to the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The value to be animated to.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setTranslationY(float)
      • translationYBy

        public ViewPropertyAnimator translationYBy(float value)
        This method will cause the View's translationY property to be animated by the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The amount to be animated by, as an offset from the current value.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setTranslationY(float)
      • scaleX

        public ViewPropertyAnimator scaleX(float value)
        This method will cause the View's scaleX property to be animated to the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The value to be animated to.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setScaleX(float)
      • scaleXBy

        public ViewPropertyAnimator scaleXBy(float value)
        This method will cause the View's scaleX property to be animated by the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The amount to be animated by, as an offset from the current value.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setScaleX(float)
      • scaleY

        public ViewPropertyAnimator scaleY(float value)
        This method will cause the View's scaleY property to be animated to the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The value to be animated to.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setScaleY(float)
      • scaleYBy

        public ViewPropertyAnimator scaleYBy(float value)
        This method will cause the View's scaleY property to be animated by the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The amount to be animated by, as an offset from the current value.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setScaleY(float)
      • alpha

        public ViewPropertyAnimator alpha(float value)
        This method will cause the View's alpha property to be animated to the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The value to be animated to.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setAlpha(float)
      • alphaBy

        public ViewPropertyAnimator alphaBy(float value)
        This method will cause the View's alpha property to be animated by the specified value. Animations already running on the property will be canceled.
        Parameters:
        value - The amount to be animated by, as an offset from the current value.
        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setAlpha(float)
      • withLayer

        public ViewPropertyAnimator withLayer()
        The View associated with this ViewPropertyAnimator will have its layer type set to View.LAYER_TYPE_HARDWARE for the duration of the next animation. As stated in the documentation for View.LAYER_TYPE_HARDWARE, the actual type of layer used internally depends on the runtime situation of the view. If the activity and this view are hardware-accelerated, then the layer will be accelerated as well. If the activity or the view is not accelerated, then the layer will effectively be the same as View.LAYER_TYPE_SOFTWARE.

        This state is not persistent, either on the View or on this ViewPropertyAnimator: the layer type of the View will be restored when the animation ends to what it was when this method was called, and this setting on ViewPropertyAnimator is only valid for the next animation. Note that calling this method and then independently setting the layer type of the View (by a direct call to View.setLayerType(int, android.graphics.Paint)) will result in some inconsistency, including having the layer type restored to its pre-withLayer() value when the animation ends.

        Returns:
        This object, allowing calls to methods in this class to be chained.
        See Also:
        View.setLayerType(int, android.graphics.Paint)
      • withStartAction

        public ViewPropertyAnimator withStartAction(Runnable runnable)
        Specifies an action to take place when the next animation runs. If there is a startDelay set on this ViewPropertyAnimator, then the action will run after that startDelay expires, when the actual animation begins. This method, along with withEndAction(Runnable), is intended to help facilitate choreographing ViewPropertyAnimator animations with other animations or actions in the application.
        Parameters:
        runnable - The action to run when the next animation starts.
        Returns:
        This object, allowing calls to methods in this class to be chained.
      • withEndAction

        public ViewPropertyAnimator withEndAction(Runnable runnable)
        Specifies an action to take place when the next animation ends. The action is only run if the animation ends normally; if the ViewPropertyAnimator is canceled during that animation, the runnable will not run. This method, along with withStartAction(Runnable), is intended to help facilitate choreographing ViewPropertyAnimator animations with other animations or actions in the application.

        For example, the following code animates a view to x=200 and then back to 0:

             Runnable endAction = new Runnable() {
                 public void run() {
                     view.animate().x(0);
                 }
             };
             view.animate().x(200).onEnd(endAction);
         
        Parameters:
        runnable - The action to run when the next animation ends.
        Returns:
        This object, allowing calls to methods in this class to be chained.


Content

Android Reference

Java basics

Java Enterprise Edition (EE)

Java Standard Edition (SE)

SQL

HTML

PHP

CSS

Java Script

MYSQL

JQUERY

VBS

REGEX

C

C++

C#

Design patterns

RFC (standard status)

RFC (proposed standard status)

RFC (draft standard status)

RFC (informational status)

RFC (experimental status)

RFC (best current practice status)

RFC (historic status)

RFC (unknown status)

IT dictionary

License.
All information of this service is derived from the free sources and is provided solely in the form of quotations. This service provides information and interfaces solely for the familiarization (not ownership) and under the "as is" condition.
Copyright 2016 © ELTASK.COM. All rights reserved.
Site is optimized for mobile devices.
Downloads: 3098 / . Delta: 0.03832 с