Most visited

Recently visited

Results for

Added in API level 1

AnimationDrawable

public class AnimationDrawable
extends DrawableContainer implements Runnable, Animatable

java.lang.Object
↳	android.graphics.drawable.Drawable
	↳	android.graphics.drawable.DrawableContainer
		↳	android.graphics.drawable.AnimationDrawable

用于创建逐帧动画的对象，由一系列Drawable对象定义，可用作View对象的背景。

创建逐帧动画的最简单方法是在XML文件中定义动画，放置在res / drawable /文件夹中，并将其设置为View对象的背景。然后，致电start()运行动画。

在XML中定义的AnimationDrawable由一个<animation-list>元素和一系列嵌套的<item>标签组成。每个项目定义了动画的一个框架。看下面的例子。

res / drawable /文件夹中的spin_animation.xml文件：

 <!-- Animation frames are wheel0.png through wheel5.png
     files inside the res/drawable/ folder -->
 <animation-list android:id="@+id/selected" android:oneshot="false">
    <item android:drawable="@drawable/wheel0" android:duration="50" />
    <item android:drawable="@drawable/wheel1" android:duration="50" />
    <item android:drawable="@drawable/wheel2" android:duration="50" />
    <item android:drawable="@drawable/wheel3" android:duration="50" />
    <item android:drawable="@drawable/wheel4" android:duration="50" />
    <item android:drawable="@drawable/wheel5" android:duration="50" />
 </animation-list>

这里是加载和播放这个动画的代码。

 // Load the ImageView that will host the animation and
 // set its background to our AnimationDrawable XML resource.
 ImageView img = (ImageView)findViewById(R.id.spinning_wheel_image);
 img.setBackgroundResource(R.drawable.spin_animation);

 // Get the background, which has been compiled to an AnimationDrawable object.
 AnimationDrawable frameAnimation = (AnimationDrawable) img.getBackground();

 // Start the animation (looped playback by default).
 frameAnimation.start();

Developer Guides

有关使用 AnimationDrawable动画 AnimationDrawable更多信息，请阅读 Drawable Animation开发人员指南。

Summary

XML attributes
`android:drawable`	Reference to a drawable resource to use for the frame.
`android:duration`	Amount of time (in milliseconds) to display this frame.
`android:oneshot`	If true, the animation will only run a single time and then stop.
`android:variablePadding`	If true, allows the drawable's padding to change based on the current state that is selected.
`android:visible`	Provides initial visibility state of the drawable; the default value is false.

Public constructors
`AnimationDrawable()`

Public methods
`void`	`addFrame(Drawable frame, int duration)` 向动画添加一个框架
`int`	`getDuration(int i)`
`Drawable`	`getFrame(int index)`
`int`	`getNumberOfFrames()`
`void`	`inflate(Resources r, XmlPullParser parser, AttributeSet attrs, Resources.Theme theme)` 从可选的由主题设计的XML资源中扩展此Drawable。
`boolean`	`isOneShot()`
`boolean`	`isRunning()` 指示动画是否正在运行。
`Drawable`	`mutate()` 使这个drawable可变。
`void`	`run()` 此方法仅用于实现目的，不应直接调用。
`void`	`setOneShot(boolean oneShot)` 设置动画是否应播放一次或重复播放。
`boolean`	`setVisible(boolean visible, boolean restart)` 设置此AnimationDrawable是否可见。
`void`	`start()` 从第一帧开始动画，必要时循环播放。
`void`	`stop()` 在当前帧停止动画。
`void`	`unscheduleSelf(Runnable what)` 使用当前的 `Drawable.Callback`实现使此Drawable `Drawable.Callback` 。

Protected methods
`void`	`setConstantState(DrawableContainer.DrawableContainerState state)`

Inherited methods

From class android.graphics.drawable.DrawableContainer

`void`	`applyTheme(Resources.Theme theme)` 将指定的主题应用于此Drawable及其子项。
`boolean`	`canApplyTheme()`
`void`	`draw(Canvas canvas)` 在其边界（通过setBounds设置）中绘制，考虑可选效果，如alpha（通过setAlpha设置）和color filter（通过setColorFilter设置）。
`int`	`getAlpha()` 获取drawable的当前alpha值。
`int`	`getChangingConfigurations()` 返回此drawable可能更改的配置参数的掩码，要求重新创建它。
`Drawable.ConstantState`	`getConstantState()` 返回保存此Drawable的共享状态的 `Drawable.ConstantState`实例。
`Drawable`	`getCurrent()`
`void`	`getHotspotBounds(Rect outRect)` 用热点边界填充 `outRect` 。
`int`	`getIntrinsicHeight()` 返回drawable的内在高度。
`int`	`getIntrinsicWidth()` 返回drawable的内部宽度。
`int`	`getMinimumHeight()` 返回此Drawable建议的最小高度。
`int`	`getMinimumWidth()` 返回此Drawable建议的最小宽度。
`int`	`getOpacity()` 返回此Drawable的不透明度/透明度。
`void`	`getOutline(Outline outline)` 调用drawable来填充定义其绘图区域的Outline。
`boolean`	`getPadding(Rect padding)` 返回填充此Drawable建议的插入内容以将内容放入drawable的边界内。
`void`	`invalidateDrawable(Drawable who)` 当drawable需要重绘时调用。
`boolean`	`isAutoMirrored()` 当它的布局方向是从右到左的RTL时，告诉它是否自动镜像。
`boolean`	`isStateful()` 指示此drawable是否会根据状态更改其外观。
`void`	`jumpToCurrentState()` 如果此Drawable确实在状态之间转换动画，请求它立即跳转到当前状态并跳过任何活动动画。
`Drawable`	`mutate()` 使这个drawable可变。
`void`	`onBoundsChange(Rect bounds)` 如果您根据边界而变化，请在您的子类中覆盖此内容以更改外观。
`boolean`	`onLayoutDirectionChanged(int layoutDirection)` 当drawable的解析布局方向改变时调用。
`boolean`	`onLevelChange(int level)` 如果您根据级别而变化，请在您的子类中覆盖此内容以更改外观。
`boolean`	`onStateChange(int[] state)` 如果您认识到指定的状态，请在您的子类中覆盖此内容以更改外观。
`void`	`scheduleDrawable(Drawable who, Runnable what, long when)` Drawable可以调用它来安排动画的下一帧。
`boolean`	`selectDrawable(int index)` 按索引设置当前显示的绘图。
`void`	`setAlpha(int alpha)` 为drawable指定一个alpha值。
`void`	`setAutoMirrored(boolean mirrored)` 设置当其布局方向为RTL（从右到左）时，此Drawable是否自动镜像。
`void`	`setColorFilter(ColorFilter colorFilter)` 为绘图指定一个可选的颜色过滤器。
`void`	`setConstantState(DrawableContainer.DrawableContainerState state)`
`void`	`setDither(boolean dither)` 此方法已弃用。该属性被忽略。
`void`	`setEnterFadeDuration(int ms)` 当一个新的drawable进入场景时，改变全局淡入持续时间。
`void`	`setExitFadeDuration(int ms)` 当一个新的drawable离开场景时，改变全局渐变持续时间。
`void`	`setHotspot(float x, float y)` 指定可绘制内的热点位置。
`void`	`setHotspotBounds(int left, int top, int right, int bottom)` 设置热点受限的边界，如果它们应该与可绘制边界不同。
`void`	`setTintList(ColorStateList tint)` 指定该drawable的色彩颜色作为颜色状态列表。
`void`	`setTintMode(PorterDuff.Mode tintMode)` 指定该drawable的色调混合模式。
`boolean`	`setVisible(boolean visible, boolean restart)` 设置此Drawable是否可见。
`void`	`unscheduleDrawable(Drawable who, Runnable what)` Drawable可以调用它来 `scheduleDrawable(Drawable, Runnable, long)`调度先前预定的行为 `scheduleDrawable(Drawable, Runnable, long)` 。

From class android.graphics.drawable.Drawable

`void`	`applyTheme(Resources.Theme t)` 将指定的主题应用于此Drawable及其子项。
`boolean`	`canApplyTheme()`
`void`	`clearColorFilter()` 移除该drawable的颜色过滤器。
`final Rect`	`copyBounds()` 在新的Rect中返回可绘制边界的副本。
`final void`	`copyBounds(Rect bounds)` 在指定的Rect中返回可绘制边界的副本（由调用方分配）。
`static Drawable`	`createFromPath(String pathName)` 从文件路径名创建一个drawable。
`static Drawable`	`createFromResourceStream(Resources res, TypedValue value, InputStream is, String srcName, BitmapFactory.Options opts)` 从输入流创建drawable，使用给定的资源和值来确定密度信息。
`static Drawable`	`createFromResourceStream(Resources res, TypedValue value, InputStream is, String srcName)` 从输入流创建drawable，使用给定的资源和值来确定密度信息。
`static Drawable`	`createFromStream(InputStream is, String srcName)` 从输入流创建一个drawable
`static Drawable`	`createFromXml(Resources r, XmlPullParser parser)` 从XML文档创建一个drawable。
`static Drawable`	`createFromXml(Resources r, XmlPullParser parser, Resources.Theme theme)` 使用可选的 `Resources.Theme`从XML文档创建drawable。
`static Drawable`	`createFromXmlInner(Resources r, XmlPullParser parser, AttributeSet attrs, Resources.Theme theme)` 使用可选的 `Resources.Theme`从XML文档内部创建 `Resources.Theme` 。
`static Drawable`	`createFromXmlInner(Resources r, XmlPullParser parser, AttributeSet attrs)` 从XML文档内部创建。
`abstract void`	`draw(Canvas canvas)` 在其边界（通过setBounds设置）中绘制，考虑可选效果，如alpha（通过setAlpha设置）和color filter（通过setColorFilter设置）。
`int`	`getAlpha()` 获取drawable的当前alpha值。
`final Rect`	`getBounds()` 返回drawable的边界Rect。
`Drawable.Callback`	`getCallback()` 返回附加到此Drawable的当前 `Drawable.Callback`实现。
`int`	`getChangingConfigurations()` 返回此drawable可能更改的配置参数的掩码，要求重新创建它。
`ColorFilter`	`getColorFilter()` 返回当前的颜色过滤器，如果没有设置，则返回 `null` 。
`Drawable.ConstantState`	`getConstantState()` 返回包含此Drawable的共享状态的 `Drawable.ConstantState`实例。
`Drawable`	`getCurrent()`
`Rect`	`getDirtyBounds()` 返回drawable的脏边界Rect。
`void`	`getHotspotBounds(Rect outRect)` 用热点边界填充 `outRect` 。
`int`	`getIntrinsicHeight()` 返回drawable的内在高度。
`int`	`getIntrinsicWidth()` 返回drawable的内部宽度。
`int`	`getLayoutDirection()` 返回此Drawable的已解析布局方向。
`final int`	`getLevel()` 检索当前级别。
`int`	`getMinimumHeight()` 返回此Drawable建议的最小高度。
`int`	`getMinimumWidth()` 返回此Drawable建议的最小宽度。
`abstract int`	`getOpacity()` 返回此Drawable的不透明度/透明度。
`void`	`getOutline(Outline outline)` 调用drawable来填充定义其绘图区域的Outline。
`boolean`	`getPadding(Rect padding)` 返回填充此Drawable建议的插入内容以将内容放入drawable的边界内。
`int[]`	`getState()` 描述了当前状态，如primitve状态的联合，如 `state_focused` ， `state_selected`等
`Region`	`getTransparentRegion()` 返回表示完全透明的Drawable部分的区域。
`void`	`inflate(Resources r, XmlPullParser parser, AttributeSet attrs, Resources.Theme theme)` 从可选的由主题设计的XML资源中扩展此Drawable。
`void`	`inflate(Resources r, XmlPullParser parser, AttributeSet attrs)` 从XML资源膨胀此Drawable。
`void`	`invalidateSelf()` 使用当前的 `Drawable.Callback`实现将此Drawable重绘。
`boolean`	`isAutoMirrored()` 当它的布局方向是从右到左的RTL时，告诉它是否自动镜像。
`boolean`	`isFilterBitmap()`
`boolean`	`isStateful()` 指示此drawable是否会根据状态更改其外观。
`final boolean`	`isVisible()`
`void`	`jumpToCurrentState()` 如果此Drawable确实在状态之间转换动画，请求它立即跳转到当前状态并跳过任何活动动画。
`Drawable`	`mutate()` 使这个drawable可变。
`void`	`onBoundsChange(Rect bounds)` 如果您根据边界而变化，请在您的子类中覆盖此内容以更改外观。
`boolean`	`onLayoutDirectionChanged(int layoutDirection)` 当drawable的解析布局方向改变时调用。
`boolean`	`onLevelChange(int level)` 如果您根据级别而变化，请在您的子类中覆盖此内容以更改外观。
`boolean`	`onStateChange(int[] state)` 如果您认识到指定的状态，请在您的子类中覆盖此内容以更改外观。
`static int`	`resolveOpacity(int op1, int op2)` 为两个源不透明度返回适当的不透明度值。
`void`	`scheduleSelf(Runnable what, long when)` 使用当前的 `Drawable.Callback`实现来绘制此Drawable。
`abstract void`	`setAlpha(int alpha)` 为drawable指定一个alpha值。
`void`	`setAutoMirrored(boolean mirrored)` 设置当其布局方向为RTL（从右到左）时，此Drawable是否自动镜像。
`void`	`setBounds(int left, int top, int right, int bottom)` 为Drawable指定一个边界矩形。
`void`	`setBounds(Rect bounds)` 为Drawable指定一个边界矩形。
`final void`	`setCallback(Drawable.Callback cb)` 将 `Drawable.Callback`对象绑定到此Drawable。
`void`	`setChangingConfigurations(int configs)` 设置该drawable可能更改的配置参数的掩码，要求重新创建它。
`void`	`setColorFilter(int color, PorterDuff.Mode mode)` 指定一个颜色和Porter-Duff模式作为该drawable的颜色过滤器。
`abstract void`	`setColorFilter(ColorFilter colorFilter)` 为绘图指定一个可选的颜色过滤器。
`void`	`setDither(boolean dither)` 此方法在API级别23中已弃用。此属性将被忽略。
`void`	`setFilterBitmap(boolean filter)` 设置为true时，在缩放或旋转时使可绘制滤镜具有双线性采样的位图。
`void`	`setHotspot(float x, float y)` 指定可绘制内的热点位置。
`void`	`setHotspotBounds(int left, int top, int right, int bottom)` 设置热点受限的边界，如果它们应该与可绘制边界不同。
`final boolean`	`setLayoutDirection(int layoutDirection)` 设置该drawable的布局方向。
`final boolean`	`setLevel(int level)` 指定drawable的级别。
`boolean`	`setState(int[] stateSet)` 为drawable指定一组状态。
`void`	`setTint(int tintColor)` 指定该drawable的色调颜色。
`void`	`setTintList(ColorStateList tint)` 指定该drawable的色彩颜色作为颜色状态列表。
`void`	`setTintMode(PorterDuff.Mode tintMode)` 指定该drawable的色调混合模式。
`boolean`	`setVisible(boolean visible, boolean restart)` 设置此Drawable是否可见。
`void`	`unscheduleSelf(Runnable what)` 使用当前的 `Drawable.Callback`实现使此Drawable `Drawable.Callback` 。

From class java.lang.Object

From interface android.graphics.drawable.Drawable.Callback

From interface java.lang.Runnable

From interface android.graphics.drawable.Animatable

XML attributes

android:drawable

引用可用于该帧的可绘制资源。如果没有给出，drawable必须由第一个子标签定义。

必须是另一个资源的引用，其形式为“ @[+][package:]type:name ”，或者其形式为“一个主题属性 ?[package:][type:]name ”。

这对应于全局属性资源符号 drawable 。

android:duration

显示此帧的时间量（以毫秒为单位）。

必须是整数值，例如“ 100 ”。

这也可能是对包含此类型值的资源（形式为“ @[package:]type:name ”）或主题属性（形式为“ ?[package:][type:]name ”）的 ?[package:][type:]name 。

这对应于全局属性资源符号 duration 。

android:oneshot

如果为true，则动画将只运行一次然后停止。如果为false（默认值），它将持续运行，在最后一次完成后的第一帧重新开始。

必须是布尔值，可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源（形式为“ @[package:]type:name ”）或主题属性（形式为“ ?[package:][type:]name ”）的 ?[package:][type:]name 。

这对应于全局属性资源符号 oneshot 。

android:variablePadding

如果为true，则允许绘制的填充根据所选的当前状态进行更改。如果为false，则填充将保持不变（基于所有状态的最大填充）。启用此功能要求可绘制的所有者在状态更改时处理布局，这通常不受支持。

必须是布尔值，可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源（形式为“ @[package:]type:name ”）或主题属性（形式为“ ?[package:][type:]name ”）的 ?[package:][type:]name 。

这对应于全局属性资源符号 variablePadding 。

android:visible

提供drawable的初始可见性状态; 默认值是false。见setVisible(boolean, boolean) 。

必须是布尔值，可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源（形式为“ @[package:]type:name ”）或主题属性（形式为“ ?[package:][type:]name ”）的 ?[package:][type:]name 。

这对应于全局属性资源符号 visible 。

Public constructors

AnimationDrawable

Added in API level 1

AnimationDrawable ()

Public methods

addFrame

Added in API level 1

void addFrame (Drawable frame, 
                int duration)

向动画添加一个框架

Parameters
`frame`	`Drawable`: The frame to add
`duration`	`int`: How long in milliseconds the frame should appear

getDuration

Added in API level 1

int getDuration (int i)

Parameters
`i`	`int`

Returns
`int`	The duration in milliseconds of the frame at the specified index

getFrame

Added in API level 1

Drawable getFrame (int index)

Parameters
`index`	`int`

Returns
`Drawable`	The Drawable at the specified frame index

getNumberOfFrames

Added in API level 1

int getNumberOfFrames ()

Returns
`int`	The number of frames in the animation

inflate

Added in API level 21

void inflate (Resources r, 
                XmlPullParser parser, 
                AttributeSet attrs, 
                Resources.Theme theme)

从可选的由主题设计的XML资源中扩展此Drawable。对于每个Drawable，这不能被调用一次以上。请注意，框架可能已经调用过这一次从XML资源创建Drawable实例。

Parameters
`r`	`Resources`: Resources used to resolve attribute values
`parser`	`XmlPullParser`: XML parser from which to inflate this Drawable
`attrs`	`AttributeSet`: Base set of attribute values
`theme`	`Resources.Theme`: Theme to apply, may be null

Throws
`XmlPullParserException`
`IOException`

isOneShot

Added in API level 1

boolean isOneShot ()

Returns
`boolean`	True of the animation will play once, false otherwise

isRunning

Added in API level 1

boolean isRunning ()

指示动画是否正在运行。

Returns
`boolean`	true if the animation is running, false otherwise

mutate

Added in API level 3

Drawable mutate ()

使这个drawable可变。这个操作不能逆转。一个可变的drawable保证不与其他drawable共享它的状态。当你需要修改从资源加载的drawable的属性时，这是特别有用的。默认情况下，从同一资源加载的所有可绘制实例共享一个公共状态; 如果修改一个实例的状态，则所有其他实例都将收到相同的修改。在可变Drawable上调用此方法将不起作用。

Returns
`Drawable`	This drawable.

run

Added in API level 1

void run ()

此方法仅用于实现目的，不应直接调用。改为调用start() 。

也可以看看：

start()

setOneShot

Added in API level 1

void setOneShot (boolean oneShot)

设置动画是否应播放一次或重复播放。

Parameters
`oneShot`	`boolean`: Pass true if the animation should only play once

setVisible

Added in API level 1

boolean setVisible (boolean visible, 
                boolean restart)

设置此AnimationDrawable是否可见。

当drawable变为不可见时，它将暂停其动画。随后将restart设置为true的可见变化将从第一帧重新开始动画。如果restart为假， restart绘制将从最近的帧中恢复。如果drawable已经到达最后一帧，它将循环回到第一帧，除非它是可单setOneShot(boolean) （通过setOneShot(boolean)设置），在这种情况下，它将保留在最后一帧。

Parameters
`visible`	`boolean`: true if visible, false otherwise
`restart`	`boolean`: when visible, true to force the animation to restart from the first frame

Returns
`boolean`	true if the new visibility is different than its previous state

start

Added in API level 1

void start ()

从第一帧开始动画，必要时循环播放。如果动画正在运行，则此方法不起作用。

注意：不要在您的活动的onCreate(Bundle)方法中调用此方法，因为AnimationDrawable尚未完全附加到窗口。如果您想要在不需要交互的情况下立即播放动画，那么您可能需要从您的活动中的onWindowFocusChanged(boolean)方法中调用该方法，这会在Android将您的窗口聚焦时调用。

也可以看看：

isRunning()
stop()

stop

Added in API level 1

void stop ()

在当前帧停止动画。如果动画未运行，则此方法无效。

也可以看看：

isRunning()
start()

unscheduleSelf

Added in API level 1

void unscheduleSelf (Runnable what)

使用当前的Drawable.Callback实现使此Drawable Drawable.Callback 。如果Drawable没有附加回调，则不执行任何操作。

Parameters
`what`	`Runnable`: The runnable that you no longer want called.

Protected methods

setConstantState

Added in API level 1

void setConstantState (DrawableContainer.DrawableContainerState state)

Parameters
`state`	`DrawableContainer.DrawableContainerState`

Interfaces

Classes

Enums

Most visited

Recently visited

Results for

AnimationDrawable

Developer Guides

Summary

XML attributes

Public constructors

Public methods

Protected methods

Inherited methods

XML attributes

android:drawable

android:duration

android:oneshot

android:variablePadding

android:visible

Public constructors

AnimationDrawable

Public methods

addFrame

getDuration

getFrame

getNumberOfFrames

inflate

isOneShot

isRunning

mutate

run

setOneShot

setVisible

start

stop

unscheduleSelf

Protected methods

setConstantState