Most visited

Recently visited

Results for

Added in API level 21

RippleDrawable

public class RippleDrawable
extends LayerDrawable

java.lang.Object
↳	android.graphics.drawable.Drawable
	↳	android.graphics.drawable.LayerDrawable
		↳	android.graphics.drawable.RippleDrawable

可绘制的，显示响应状态变化的连锁反应。给定状态的波动的锚定位置可以通过用相应的状态属性标识符调用setHotspot(float, float)来指定。

触摸反馈drawable可能包含多个子图层，其中包括未绘制到屏幕的特殊遮罩图层。通过指定android:id值为mask可以将单层设置为来自XML的掩码。在运行时，可以使用setId(..., android.R.id.mask)将单个图层设置为蒙setId(..., android.R.id.mask)或者可以使用setDrawableByLayerId(android.R.id.mask, ...)替换现有的蒙版图层。

 <!-- A red ripple masked against an opaque rectangle. --/>
 &ltripple android:color="#ffff0000">
   &ltitem android:id="@android:id/mask"
         android:drawable="@android:color/white" />
 </ripple>

如果设置了遮罩层，则在将其绘制在其余子层的合成物上之前，将会将该波纹效果遮蔽在该层上。

如果没有设置遮罩层，则会对子层的合成物遮挡纹波效果。

 <!-- A green ripple drawn atop a black rectangle. --/>
 &ltripple android:color="#ff00ff00">
   &ltitem android:drawable="@android:color/black" />
 </ripple>

 <!-- A blue ripple drawn atop a drawable resource. --/>
 &ltripple android:color="#ff0000ff">
   &ltitem android:drawable="@drawable/my_drawable" />
 </ripple>

如果未指定子图层或遮罩，并且将波动设置为查看背景，则波动将绘制在视图的层次结构中第一个可用的父背景上。在这种情况下，绘图区域可能会延伸到可绘制边界之外。

 <!-- An unbounded red ripple. --/>
 &ltripple android:color="#ffff0000" />

Summary

XML attributes
`android:color`	The color to use for ripple effects.
`android:radius`	The radius of the ripple when fully expanded.

Inherited XML attributes

From class android.graphics.drawable.LayerDrawable

Constants
`int`	`RADIUS_AUTO` 指定波纹半径的半径值应根据波纹容器的大小进行计算。

Inherited constants

From class android.graphics.drawable.LayerDrawable

Public constructors
`RippleDrawable(ColorStateList color, Drawable content, Drawable mask)` 用指定的波纹颜色和可选的内容和遮罩可绘制创建一个新的波纹。

Public methods
`void`	`applyTheme(Resources.Theme t)` 将指定的主题应用于此Drawable及其子项。
`boolean`	`canApplyTheme()`
`void`	`draw(Canvas canvas)` 针对遮罩层和可选内容绘制涟漪进行了优化。
`Drawable.ConstantState`	`getConstantState()` 返回保存此Drawable的共享状态的 `Drawable.ConstantState`实例。
`Rect`	`getDirtyBounds()` 返回drawable的脏边界Rect。
`void`	`getHotspotBounds(Rect outRect)` 用热点边界填充 `outRect` 。
`int`	`getOpacity()` 返回此Drawable的不透明度/透明度。
`void`	`getOutline(Outline outline)` 用第一个可用图层轮廓填充 `outline` ，不包括遮罩层。
`int`	`getRadius()`
`void`	`inflate(Resources r, XmlPullParser parser, AttributeSet attrs, Resources.Theme theme)` 从可选的由主题设计的XML资源中扩展此Drawable。
`void`	`invalidateSelf()` 使用当前的 `Drawable.Callback`实现来绘制此Drawable。
`boolean`	`isStateful()` 指示此drawable是否会根据状态更改其外观。
`void`	`jumpToCurrentState()` 如果此Drawable确实在状态之间转换动画，请求它立即跳转到当前状态并跳过任何活动动画。
`Drawable`	`mutate()` 使这个drawable可变。
`void`	`setColor(ColorStateList color)` 设置波纹颜色。
`boolean`	`setDrawableByLayerId(int id, Drawable drawable)` 用给定的ID替换 `Drawable` 。
`void`	`setHotspot(float x, float y)` 指定可绘制内的热点位置。
`void`	`setHotspotBounds(int left, int top, int right, int bottom)` 设置热点受限的边界，如果它们应该与可绘制边界不同。
`void`	`setPaddingMode(int mode)` 指定图层填充应该如何影响后续图层的边界。
`void`	`setRadius(int radius)` 设置完全展开纹波的半径（以像素为单位）。
`boolean`	`setVisible(boolean visible, boolean restart)` 设置此Drawable是否可见。

Protected methods
`void`	`onBoundsChange(Rect bounds)` 如果您根据边界而变化，请在您的子类中覆盖此内容以更改外观。
`boolean`	`onStateChange(int[] stateSet)` 如果您认识到指定的状态，请在您的子类中覆盖此内容以更改外观。

Inherited methods

From class android.graphics.drawable.LayerDrawable

`int`	`addLayer(Drawable dr)` 将包含指定的 `drawable`的新图层添加到图层列表的末尾并返回其索引。
`void`	`applyTheme(Resources.Theme t)` 将指定的主题应用于此Drawable及其子项。
`boolean`	`canApplyTheme()`
`void`	`draw(Canvas canvas)` 在其边界（通过setBounds设置）中绘制，考虑可选效果，如alpha（通过setAlpha设置）和color filter（通过setColorFilter设置）。
`Drawable`	`findDrawableByLayerId(int id)` 查找具有给定ID的图层并返回其 `Drawable` 。
`int`	`findIndexByLayerId(int id)` 返回指定 `id` 。
`int`	`getAlpha()` 获取drawable的当前alpha值。
`int`	`getBottomPadding()` 以像素为单位返回底部填充。
`int`	`getChangingConfigurations()` 返回此drawable可能更改的配置参数的掩码，要求重新创建它。
`Drawable.ConstantState`	`getConstantState()` 返回保存此Drawable的共享状态的 `Drawable.ConstantState`实例。
`Drawable`	`getDrawable(int index)` 返回指定索引处图层的drawable。
`int`	`getEndPadding()` 以像素为单位返回结尾填充。
`void`	`getHotspotBounds(Rect outRect)` 用热点边界填充 `outRect` 。
`int`	`getId(int index)` 返回指定图层的ID。
`int`	`getIntrinsicHeight()` 返回drawable的内在高度。
`int`	`getIntrinsicWidth()` 返回drawable的内部宽度。
`int`	`getLayerGravity(int index)`
`int`	`getLayerHeight(int index)`
`int`	`getLayerInsetBottom(int index)`
`int`	`getLayerInsetEnd(int index)`
`int`	`getLayerInsetLeft(int index)`
`int`	`getLayerInsetRight(int index)`
`int`	`getLayerInsetStart(int index)`
`int`	`getLayerInsetTop(int index)`
`int`	`getLayerWidth(int index)`
`int`	`getLeftPadding()` 以像素为单位返回左侧填充。
`int`	`getNumberOfLayers()` 返回此图层可绘制中包含的图层数量。
`int`	`getOpacity()` 返回此Drawable的不透明度/透明度。
`void`	`getOutline(Outline outline)` 用第一个可用（非空）图层轮廓填充 `outline` 。
`boolean`	`getPadding(Rect padding)` 返回填充此Drawable建议的插入内容以将内容放入drawable的边界内。
`int`	`getPaddingMode()`
`int`	`getRightPadding()` 以像素为单位返回正确的填充。
`int`	`getStartPadding()` 以像素为单位返回开始填充。
`int`	`getTopPadding()` 返回顶部填充像素。
`void`	`inflate(Resources r, XmlPullParser parser, AttributeSet attrs, Resources.Theme theme)` 从可选的由主题设计的XML资源中扩展此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可以调用它来安排动画的下一帧。
`void`	`setAlpha(int alpha)` 为drawable指定一个alpha值。
`void`	`setAutoMirrored(boolean mirrored)` 设置当其布局方向为RTL（从右到左）时，此Drawable是否自动镜像。
`void`	`setColorFilter(ColorFilter colorFilter)` 为绘图指定一个可选的颜色过滤器。
`void`	`setDither(boolean dither)` 此方法已弃用。该属性被忽略。
`void`	`setDrawable(int index, Drawable drawable)` 设置指定索引处图层的绘图。
`boolean`	`setDrawableByLayerId(int id, Drawable drawable)` 用给定的ID替换 `Drawable` 。
`void`	`setHotspot(float x, float y)` 指定可绘制内的热点位置。
`void`	`setHotspotBounds(int left, int top, int right, int bottom)` 设置热点受限的边界，如果它们应该与可绘制边界不同。
`void`	`setId(int index, int id)` 设置图层的ID。
`void`	`setLayerGravity(int index, int gravity)` 设置用于放置或拉伸容器内指定图层的重力。
`void`	`setLayerHeight(int index, int h)`
`void`	`setLayerInset(int index, int l, int t, int r, int b)` 指定指定索引处drawable的插图像素数。
`void`	`setLayerInsetBottom(int index, int b)`
`void`	`setLayerInsetEnd(int index, int e)`
`void`	`setLayerInsetLeft(int index, int l)`
`void`	`setLayerInsetRelative(int index, int s, int t, int e, int b)` 指定指定索引处drawable的相对插图像素数。
`void`	`setLayerInsetRight(int index, int r)`
`void`	`setLayerInsetStart(int index, int s)`
`void`	`setLayerInsetTop(int index, int t)`
`void`	`setLayerSize(int index, int w, int h)` 为指定图层设置显式大小。
`void`	`setLayerWidth(int index, int w)`
`void`	`setOpacity(int opacity)` 直接设置该drawable的不透明度，而不是从图层中收集状态。
`void`	`setPadding(int left, int top, int right, int bottom)` 设置绝对填充。
`void`	`setPaddingMode(int mode)` 指定图层填充应该如何影响后续图层的边界。
`void`	`setPaddingRelative(int start, int top, int end, 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文档创建 `Resources.Theme` 。
`static Drawable`	`createFromXmlInner(Resources r, XmlPullParser parser, AttributeSet attrs, Resources.Theme theme)` 使用可选的 `Resources.Theme`从XML文档中创建一个drawable。
`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

XML attributes

android:color

用于涟漪效果的颜色。该属性是必需的。

必须是“ #rgb ”，“ #argb ”，“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

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

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

相关方法：

setColor(ColorStateList)

android:radius

波纹半径完全展开时。默认情况下，半径是根据波纹容器的大小计算出来的。

必须是维度值，这是一个浮点数，后面跟着一个单位，例如“ 14.5sp ”。可用单位为：px（像素），dp（密度独立像素），sp（基于首选字体大小的缩放像素），单位为英寸，毫米（毫米）。

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

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

相关方法：

setRadius(int)

Constants

RADIUS_AUTO

Added in API level 23

int RADIUS_AUTO

指定波纹半径的半径值应根据波纹容器的大小进行计算。

常量值：-1（0xffffffff）

Public constructors

RippleDrawable

Added in API level 21

RippleDrawable (ColorStateList color, 
                Drawable content, 
                Drawable mask)

用指定的波纹颜色和可选的内容和遮罩可绘制创建一个新的波纹。

Parameters
`color`	`ColorStateList`: The ripple color
`content`	`Drawable`: The content drawable, may be `null`
`mask`	`Drawable`: The mask drawable, may be `null`

Public methods

applyTheme

Added in API level 21

void applyTheme (Resources.Theme t)

将指定的主题应用于此Drawable及其子项。

Parameters
`t`	`Resources.Theme`: the theme to apply

canApplyTheme

Added in API level 21

boolean canApplyTheme ()

Returns
`boolean`

draw

Added in API level 21

void draw (Canvas canvas)

针对遮罩层和可选内容绘制涟漪进行了优化。

Parameters
`canvas`	`Canvas`: The canvas to draw into

getConstantState

Added in API level 21

Drawable.ConstantState getConstantState ()

返回保存此Drawable的共享状态的 Drawable.ConstantState实例。

Returns
`Drawable.ConstantState`	The ConstantState associated to that Drawable.

getDirtyBounds

Added in API level 21

Rect getDirtyBounds ()

返回drawable的脏边界Rect。注意：为了提高效率，返回的对象可能是存储在drawable中的相同对象（尽管这不能保证）。

默认情况下，这将返回完整的可绘制边界。自定义绘图可能会重写此方法以执行更精确的失效。

Returns
`Rect`	The dirty bounds of this drawable

getHotspotBounds

Added in API level 23

void getHotspotBounds (Rect outRect)

用热点边界填充 outRect 。

Parameters
`outRect`	`Rect`: the rect to populate with the hotspot bounds

getOpacity

Added in API level 21

int getOpacity ()

返回此Drawable的不透明度/透明度。返回的值是在抽象格式常数之一PixelFormat ： UNKNOWN ， TRANSLUCENT ， TRANSPARENT ，或OPAQUE 。

OPAQUE drawable是一个绘制所有内容的范围，完全覆盖drawable后面的所有内容。一个TRANSPARENT drawable是一个在其范围内没有绘制任何东西的图形，允许它后面的所有东西都显示出来。 TRANSLUCENT drawable是任何其他状态中的drawable，drawable将绘制其边界内的一些内容，但不是全部内容，并且至少drawable后面的某些内容将可见。如果无法确定可绘制内容的可见性，则最安全/最佳返回值为TRANSLUCENT。

一般而言，Drawable应该尽可能保守并且返回值。例如，如果它包含多个子drawable，并且一次只显示其中一个，如果只有一个子项是TRANSLUCENT，而其他子项是OPAQUE，则应返回TRANSLUCENT。您可以使用方法resolveOpacity(int, int)将两个不透明度标准减少到适当的单个输出。

请注意，返回的值不一定会考虑客户端通过setAlpha(int)或setColorFilter(ColorFilter)方法应用的自定义alpha或颜色过滤器。一些子类，比如BitmapDrawable ， ColorDrawable ，并GradientDrawable ，对价值做账setAlpha(int) ，但总的行为是依赖于子类实现的。

Returns
`int`	int The opacity class of the Drawable.

getOutline

Added in API level 21

void getOutline (Outline outline)

用第一个可用图层轮廓填充 outline ，不包括遮罩层。

Parameters
`outline`	`Outline`: Outline in which to place the first available layer outline

getRadius

Added in API level 23

int getRadius ()

相关XML属性：

android:radius

Returns
`int`	the radius in pixels of the fully expanded ripple if an explicit radius has been set, or `RADIUS_AUTO` if the radius is computed based on the container size

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`

invalidateSelf

Added in API level 21

void invalidateSelf ()

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

isStateful

Added in API level 21

boolean isStateful ()

指示此drawable是否会根据状态更改其外观。客户可以使用它来确定是否有必要计算它们的状态并调用setState。

Returns
`boolean`	True if this drawable changes its appearance based on state, false otherwise.

jumpToCurrentState

Added in API level 21

void jumpToCurrentState ()

如果此Drawable确实在状态之间转换动画，请求它立即跳转到当前状态并跳过任何活动动画。

mutate

Added in API level 21

Drawable mutate ()

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

Returns
`Drawable`	This drawable.

setColor

Added in API level 21

void setColor (ColorStateList color)

设置波纹颜色。

相关XML属性：

android:color

Parameters
`color`	`ColorStateList`: Ripple color as a color state list.

setDrawableByLayerId

Added in API level 21

boolean setDrawableByLayerId (int id, 
                Drawable drawable)

用给定的ID替换 Drawable 。

Parameters
`id`	`int`: The layer ID to search for.
`drawable`	`Drawable`: The replacement `Drawable`.

Returns
`boolean`	Whether the `Drawable` was replaced (could return false if the id was not found).

setHotspot

Added in API level 21

void setHotspot (float x, 
                float y)

指定可绘制内的热点位置。

Parameters
`x`	`float`: The X coordinate of the center of the hotspot
`y`	`float`: The Y coordinate of the center of the hotspot

setHotspotBounds

Added in API level 21

void setHotspotBounds (int left, 
                int top, 
                int right, 
                int bottom)

设置热点受限的边界，如果它们应该与可绘制边界不同。

Parameters
`left`	`int`: position in pixels of the left bound
`top`	`int`: position in pixels of the top bound
`right`	`int`: position in pixels of the right bound
`bottom`	`int`: position in pixels of the bottom bound

setPaddingMode

Added in API level 21

void setPaddingMode (int mode)

指定图层填充应该如何影响后续图层的边界。 RippleDrawable的默认值和推荐值是PADDING_MODE_STACK 。

Parameters
`mode`	`int`: padding mode, one of: `PADDING_MODE_NEST` to nest each layer inside the padding of the previous layer `PADDING_MODE_STACK` to stack each layer directly atop the previous layer

也可以看看：

getPaddingMode()

setRadius

Added in API level 23

void setRadius (int radius)

设置完全展开纹波的半径（以像素为单位）。

相关XML属性：

android:radius

Parameters
`radius`	`int`: ripple radius in pixels, or `RADIUS_AUTO` to compute the radius based on the container size

setVisible

Added in API level 21

boolean setVisible (boolean visible, 
                boolean restart)

设置此Drawable是否可见。这通常不会影响Drawable的行为，但它是一些可供Drawables使用的提示，例如，可以决定是否运行动画。

Parameters
`visible`	`boolean`: Set to true if visible, false if not.
`restart`	`boolean`: You can supply true here to force the drawable to behave as if it has just become visible, even if it had last been set visible. Used for example to force animations to restart.

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

Protected methods

onBoundsChange

Added in API level 21

void onBoundsChange (Rect bounds)

如果您根据边界而变化，请在您的子类中覆盖此内容以更改外观。

Parameters
`bounds`	`Rect`

onStateChange

Added in API level 21

boolean onStateChange (int[] stateSet)

如果您认识到指定的状态，请在您的子类中覆盖此内容以更改外观。

Parameters
`stateSet`	`int`

Returns
`boolean`	Returns true if the state change has caused the appearance of the Drawable to change (that is, it needs to be drawn), else false if it looks the same and there is no need to redraw it since its last state.