Animation API
Animation
android.view.animation
类 Animation
java.lang.Object
android.view.animation.Animation
- 所有已实现的接口：
- Cloneable
- 直接已知子类：
- AlphaAnimation, AnimationSet, RotateAnimation, ScaleAnimation, TranslateAnimation
public abstract class Animationextends Objectimplements Cloneable
Abstraction for an Animation that can be applied to Views, Surfaces, or other objects. See the animation package description file.
| 嵌套类摘要 | |
|---|---|
|
Animation.AnimationListener An animation listener receives notifications from an animation. |
| 字段摘要 | |
|---|---|
static int |
ABSOLUTE The specified dimension is an absolute number of pixels. |
static int |
INFINITE Repeat the animation indefinitely. |
static int |
RELATIVE_TO_PARENT The specified dimension holds a float and should be multiplied by the height or width of the parent of the object being animated. |
static int |
RELATIVE_TO_SELF The specified dimension holds a float and should be multiplied by the height or width of the object being animated. |
static int |
RESTART When the animation reaches the end and the repeat count is INFINTE_REPEAT or a positive value, the animation restarts from the beginning. |
static int |
REVERSE When the animation reaches the end and the repeat count is INFINTE_REPEAT or a positive value, the animation plays backward (and then forward again). |
static int |
START_ON_FIRST_FRAME Can be used as the start time to indicate the start time should be the current time when getTransformation(long, Transformation) is invoked for the first animation frame. |
static int |
ZORDER_BOTTOM Requests that the content being animated be forced under all other content for the duration of the animation. |
static int |
ZORDER_NORMAL Requests that the content being animated be kept in its current Z order. |
static int |
ZORDER_TOP Requests that the content being animated be forced on top of all other content for the duration of the animation. |
| 构造方法摘要 | |
|---|---|
Animation() Creates a new animation with a duration of 0ms, the default interpolator, with fillBefore set to true and fillAfter set to false |
|
Animation(Context context, AttributeSet attrs) Creates a new animation whose parameters come from the specified context and attributes set. |
|
| 方法摘要 | |
|---|---|
long |
computeDurationHint() Compute a hint at how long the entire animation may last, in milliseconds. |
long |
getDuration() How long this animation should last |
boolea |
getFillAfter() If fillAfter is true, this animation will apply its transformation after the end time of the animation. |
boolean |
getFillBefore() If fillBefore is true, this animation will apply its transformation before the start time of the animation. |
Interpolator |
getInterpolator() Gets the acceleration curve type for this animation. |
void |
getInvalidateRegion(int left, int top, int right, int bottom, RectF invalidate, Transformation transformation) |
int |
getRepeatCount() Defines how many times the animation should repeat. |
int |
getRepeatMode() Defines what this animation should do when it reaches the end. |
long |
getStartOffset() When this animation should start, relative to StartTime |
long |
getStartTime() When this animation should start. |
boolean |
getTransformation(long currentTime, Transformation outTransformation) Gets the transformation to apply at a specified point in time. |
int |
getZAdjustment() Returns the Z ordering mode to use while running the animation as previously set by setZAdjustment(int). |
boolean |
hasEnded() Indicates whether this animation has ended or not. |
boolean |
hasStarted() Indicates whether this animation has started or not. |
void |
initialize(int width, int height, int parentWidth, int parentHeight) Initialize this animation with the dimensions of the object being animated as well as the objects parents. |
void |
initializeInvalidateRegion(int left, int top, int right, int bottom) |
boolean |
isFillEnabled() If fillEnabled is true, this animation will apply fillBefore and fillAfter. |
boolean |
isInitialized() Whether or not the animation has been initialized. |
void |
reset() Reset the initialization state of this animation. |
void |
restrictDuration(long durationMillis) Ensure that the duration that this animation will run is not longer than durationMillis. |
void |
scaleCurrentDuration(float scale) How much to scale the duration by. |
void |
setAnimationListener(Animation.AnimationListener listener) Binds an animation listener to this animation. |
void |
setDuration(long durationMillis) How long this animation should last. |
void |
setFillAfter(boolean fillAfter) If fillAfter is true, the transformation that this animation performed will persist when it is finished. |
void |
setFillBefore(boolean fillBefore) If fillBefore is true, this animation will apply its transformation before the start time of the animation. |
void |
setFillEnabled(boolean fillEnabled) If fillEnabled is true, the animation will apply the value of fillBefore and fillAfter. |
void |
setInterpolator(Context context, int resID) Sets the acceleration curve for this animation. |
void |
setInterpolator(Interpolator i) Sets the acceleration curve for this animation. |
void |
setRepeatCount(int repeatCount) Sets how many times the animation should be repeated. |
void |
setRepeatMode(int repeatMode) Defines what this animation should do when it reaches the end. |
void |
setStartOffset(long startOffset) When this animation should start relative to the start time. |
void |
setStartTime(long startTimeMillis) When this animation should start. |
void |
setZAdjustment(int zAdjustment) Set the Z ordering mode to use while running the animation. |
void |
start() Convenience method to start the animation the first time getTransformation(long, Transformation) is invoked. |
void |
startNow() Convenience method to start the animation at the current time in milliseconds. |
boolean |
willChangeBounds() Indicates whether or not this animation will affect the bounds of the animated view. |
boolean |
willChangeTransformationMatrix() Indicates whether or not this animation will affect the transformation matrix. |
| 从类 java.lang.Object 继承的方法 |
|---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| 字段详细信息 |
|---|
INFINITE
public static final int INFINITE
-
Repeat the animation indefinitely.
- 另请参见：
- 常量字段值
RESTART
public static final int RESTART
-
When the animation reaches the end and the repeat count is INFINTE_REPEAT or a positive value, the animation restarts from the beginning.
- 另请参见：
- 常量字段值
REVERSE
public static final int REVERSE
-
When the animation reaches the end and the repeat count is INFINTE_REPEAT or a positive value, the animation plays backward (and then forward again).
- 另请参见：
- 常量字段值
START_ON_FIRST_FRAME
public static final int START_ON_FIRST_FRAME
-
Can be used as the start time to indicate the start time should be the current time when getTransformation(long, Transformation) is invoked for the first animation frame. This can is useful for short animations.
- 另请参见：
- 常量字段值
ABSOLUTE
public static final int ABSOLUTE
-
The specified dimension is an absolute number of pixels.
- 另请参见：
- 常量字段值
RELATIVE_TO_SELF
public static final int RELATIVE_TO_SELF
-
The specified dimension holds a float and should be multiplied by the height or width of the object being animated.
- 另请参见：
- 常量字段值
RELATIVE_TO_PARENT
public static final int RELATIVE_TO_PARENT
-
The specified dimension holds a float and should be multiplied by the height or width of the parent of the object being animated.
- 另请参见：
- 常量字段值
ZORDER_NORMAL
public static final int ZORDER_NORMAL
-
Requests that the content being animated be kept in its current Z order.
- 另请参见：
- 常量字段值
ZORDER_TOP
public static final int ZORDER_TOP
-
Requests that the content being animated be forced on top of all other content for the duration of the animation.
- 另请参见：
- 常量字段值
ZORDER_BOTTOM
public static final int ZORDER_BOTTOM
-
Requests that the content being animated be forced under all other content for the duration of the animation.
- 另请参见：
- 常量字段值
| 构造方法详细信息 |
|---|
Animation
public Animation()
-
Creates a new animation with a duration of 0ms, the default interpolator, with fillBefore set to true and fillAfter set to false
Animation
public Animation(Context context,
AttributeSet attrs)
-
Creates a new animation whose parameters come from the specified context and attributes set.
- 参数：
-
context- the application environment -
attrs- the set of attributes holding the animation parameters
| 方法详细信息 |
|---|
reset
public void reset()
-
Reset the initialization state of this animation.
-
- 另请参见：
- initialize(int, int, int, int)
isInitialized
public boolean isInitialized()
-
Whether or not the animation has been initialized.
-
- 返回：
- Has this animation been initialized.
- 另请参见：
- initialize(int, int, int, int)
initialize
public void initialize(int width,
int height,
int parentWidth,
int parentHeight)
-
Initialize this animation with the dimensions of the object being animated as well as the objects parents. (This is to support animation sizes being specifed relative to these dimensions.)
Objects that interpret a Animations should call this method when the sizes of the object being animated and its parent are known, and before calling getTransformation(long, android.view.animation.Transformation).
-
- 参数：
-
width- Width of the object being animated -
height- Height of the object being animated -
parentWidth- Width of the animated object's parent -
parentHeight- Height of the animated object's parent
setInterpolator
public void setInterpolator(Context context,
int resID)
-
Sets the acceleration curve for this animation. The interpolator is loaded as a resource from the specified context.
-
- 参数：
-
context- The application environment -
resID- The resource identifier of the interpolator to load
setInterpolator
public void setInterpolator(Interpolator i)
-
Sets the acceleration curve for this animation. Defaults to a linear interpolation.
-
- 参数：
-
i- The interpolator which defines the acceleration curve
setStartOffset
public void setStartOffset(long startOffset)
-
When this animation should start relative to the start time. This is most useful when composing complex animations using an AnimationSet where some of the animations components start at different times.
-
- 参数：
-
startOffset- When this Animation should start, in milliseconds from the start time of the root AnimationSet.
setDuration
public void setDuration(long durationMillis)
-
How long this animation should last. The duration cannot be negative.
-
- 参数：
-
durationMillis- Duration in milliseconds
restrictDuration
public void restrictDuration(long durationMillis)
-
Ensure that the duration that this animation will run is not longer than durationMillis. In addition to adjusting the duration itself, this ensures that the repeat count also will not make it run longer than the given time.
-
- 参数：
-
durationMillis- The maximum duration the animation is allowed to run.
scaleCurrentDuration
public void scaleCurrentDuration(float scale)
-
How much to scale the duration by.
-
- 参数：
-
scale- The amount to scale the duration.
setStartTime
public void setStartTime(long startTimeMillis)
-
When this animation should start. When the start time is set to START_ON_FIRST_FRAME, the animation will start the first time getTransformation(long, Transformation) is invoked. The time passed to this method should be obtained by calling AnimationUtils.currentAnimationTimeMillis() instead of System.currentTimeMillis().
-
- 参数：
-
startTimeMillis- the start time in milliseconds
start
public void start()
-
Convenience method to start the animation the first time getTransformation(long, Transformation) is invoked.
startNow
public void startNow()
-
Convenience method to start the animation at the current time in milliseconds.
setRepeatMode
public void setRepeatMode(int repeatMode)
-
Defines what this animation should do when it reaches the end. This setting is applied only when the repeat count is either greater than 0 or INFINITE. Defaults to RESTART.
-
- 参数：
-
repeatMode- RESTART or REVERSE
setRepeatCount
public void setRepeatCount(int repeatCount)
-
Sets how many times the animation should be repeated. If the repeat count is 0, the animation is never repeated. If the repeat count is greater than 0 or INFINITE, the repeat mode will be taken into account. The repeat count is 0 by default.
-
- 参数：
-
repeatCount- the number of times the animation should be repeated
isFillEnabled
public boolean isFillEnabled()
-
If fillEnabled is true, this animation will apply fillBefore and fillAfter.
-
- 返回：
- true if the animation will take fillBefore and fillAfter into account
setFillEnabled
public void setFillEnabled(boolean fillEnabled)
-
If fillEnabled is true, the animation will apply the value of fillBefore and fillAfter. Otherwise, fillBefore and fillAfter are ignored and the animation transformation is always applied.
-
- 参数：
-
fillEnabled- true if the animation should take fillBefore and fillAfter into account - 另请参见：
- setFillBefore(boolean), setFillAfter(boolean)
setFillBefore
public void setFillBefore(boolean fillBefore)
-
If fillBefore is true, this animation will apply its transformation before the start time of the animation. Defaults to true if not set. Note that this applies when using an AnimationSet to chain animations. The transformation is not applied before the AnimationSet itself starts.
-
- 参数：
-
fillBefore- true if the animation should apply its transformation before it starts - 另请参见：
- setFillEnabled(boolean)
setFillAfter
public void setFillAfter(boolean fillAfter)
-
If fillAfter is true, the transformation that this animation performed will persist when it is finished. Defaults to false if not set. Note that this applies when using an AnimationSet to chain animations. The transformation is not applied before the AnimationSet itself starts.
-
- 参数：
-
fillAfter- true if the animation should apply its transformation after it ends - 另请参见：
- setFillEnabled(boolean)
setZAdjustment
public void setZAdjustment(int zAdjustment)
-
Set the Z ordering mode to use while running the animation.
-
- 参数：
-
zAdjustment- The desired mode, one of ZORDER_NORMAL, ZORDER_TOP, or ZORDER_BOTTOM.
getInterpolator
public Interpolator getInterpolator()
-
Gets the acceleration curve type for this animation.
-
- 返回：
- the Interpolator associated to this animation
getStartTime
public long getStartTime()
-
When this animation should start. If the animation has not startet yet, this method might return START_ON_FIRST_FRAME.
-
- 返回：
- the time in milliseconds when the animation should start or START_ON_FIRST_FRAME
getDuration
public long getDuration()
-
How long this animation should last
-
- 返回：
- the duration in milliseconds of the animation
getStartOffset
public long getStartOffset()
-
When this animation should start, relative to StartTime
-
- 返回：
- the start offset in milliseconds
getRepeatMode
public int getRepeatMode()
-
Defines what this animation should do when it reaches the end.
-
- 返回：
- either one of REVERSE or RESTART
getRepeatCount
public int getRepeatCount()
-
Defines how many times the animation should repeat. The default value is 0.
-
- 返回：
- the number of times the animation should repeat, or INFINITE
getFillBefore
public boolean getFillBefore()
-
If fillBefore is true, this animation will apply its transformation before the start time of the animation.
-
- 返回：
- true if the animation applies its transformation before it starts
getFillAfter
public boolean getFillAfter()
-
If fillAfter is true, this animation will apply its transformation after the end time of the animation.
-
- 返回：
- true if the animation applies its transformation after it ends
getZAdjustment
public int getZAdjustment()
-
Returns the Z ordering mode to use while running the animation as previously set by setZAdjustment(int).
-
- 返回：
- Returns one of ZORDER_NORMAL, ZORDER_TOP, or ZORDER_BOTTOM.
willChangeTransformationMatrix
public boolean willChangeTransformationMatrix()
-
Indicates whether or not this animation will affect the transformation matrix. For instance, a fade animation will not affect the matrix whereas a scale animation will.
-
- 返回：
- true if this animation will change the transformation matrix
willChangeBounds
public boolean willChangeBounds()
-
Indicates whether or not this animation will affect the bounds of the animated view. For instance, a fade animation will not affect the bounds whereas a 200% scale animation will.
-
- 返回：
- true if this animation will change the view's bounds
setAnimationListener
public void setAnimationListener(Animation.AnimationListener listener)
-
Binds an animation listener to this animation. The animation listener is notified of animation events such as the end of the animation or the repetition of the animation.
-
- 参数：
-
listener- the animation listener to be notified
computeDurationHint
public long computeDurationHint()
-
Compute a hint at how long the entire animation may last, in milliseconds. Animations can be written to cause themselves to run for a different duration than what is computed here, but generally this should be accurate.
getTransformation
public boolean getTransformation(long currentTime,
Transformation outTransformation)
-
Gets the transformation to apply at a specified point in time. Implementations of this method should always replace the specified Transformation or document they are doing otherwise.
-
- 参数：
-
currentTime- Where we are in the animation. This is wall clock time. -
outTransformation- A tranformation object that is provided by the caller and will be filled in by the animation. - 返回：
- True if the animation is still running
hasStarted
public boolean hasStarted()
-
Indicates whether this animation has started or not.
-
- 返回：
- true if the animation has started, false otherwise
hasEnded
public boolean hasEnded()
-
Indicates whether this animation has ended or not.
-
- 返回：
- true if the animation has ended, false otherwise
getInvalidateRegion
public void getInvalidateRegion(int left,
int top,
int right,
int bottom,
RectF invalidate,
Transformation transformation)
-
- 参数：
-
left- -
top- -
right- -
bottom- -
invalidate- -
transformation-
initializeInvalidateRegion
public void initializeInvalidateRegion(int left,
int top,
int right,
int bottom)
-
- 参数：
-
left- -
top- -
right- -
bottom-