Drawable

Drawable

Drawable ()

applyTheme

void applyTheme (Resources.Theme t)

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

canApplyTheme

boolean canApplyTheme ()

clearColorFilter

void clearColorFilter ()

移除该drawable的颜色过滤器。

copyBounds

Rect copyBounds ()

在新的Rect中返回可绘制边界的副本。 这将返回与getBounds（）相同的值，但返回的对象保证不会被drawable稍后更改（即，它不保留对此rect的引用）。 如果调用者已经分配了Rect，则调用copyBounds（rect）。

copyBounds

void copyBounds (Rect bounds)

在指定的Rect中返回可绘制边界的副本（由调用方分配）。 当它的draw（）方法被调用时，边界指定了它将在哪里绘制。

createFromPath

Drawable createFromPath (String pathName)

从文件路径名创建一个drawable。

createFromResourceStream

Drawable createFromResourceStream (Resources res, 
                TypedValue value, 
                InputStream is, 
                String srcName, 
                BitmapFactory.Options opts)

从输入流创建drawable，使用给定的资源和值来确定密度信息。

createFromResourceStream

Drawable createFromResourceStream (Resources res, 
                TypedValue value, 
                InputStream is, 
                String srcName)

从输入流创建drawable，使用给定的资源和值来确定密度信息。

createFromStream

Drawable createFromStream (InputStream is, 
                String srcName)

从输入流创建一个drawable

createFromXml

Drawable createFromXml (Resources r, 
                XmlPullParser parser)

从XML文档创建一个drawable。 有关如何使用XML创建资源的更多信息，请参见Drawable Resources 。

createFromXml

Drawable createFromXml (Resources r, 
                XmlPullParser parser, 
                Resources.Theme theme)

使用可选的Resources.Theme从XML文档创建drawable。 有关如何使用XML创建资源的更多信息，请参见Drawable Resources 。

createFromXmlInner

Drawable createFromXmlInner (Resources r, 
                XmlPullParser parser, 
                AttributeSet attrs, 
                Resources.Theme theme)

使用可选的Resources.Theme从XML文档中创建drawable。 调用位于XML文档标签中的解析器，尝试从该标签创建Drawable。 如果标签不是有效的drawable，则返回null 。

createFromXmlInner

Drawable createFromXmlInner (Resources r, 
                XmlPullParser parser, 
                AttributeSet attrs)

从XML文档内部创建。 调用位于XML文档标签中的解析器，尝试从该标签创建Drawable。 如果标记不是有效的drawable，则返回null。

draw

void draw (Canvas canvas)

在其边界（通过setBounds设置）中绘制，考虑可选效果，如alpha（通过setAlpha设置）和color filter（通过setColorFilter设置）。

getAlpha

int getAlpha ()

获取drawable的当前alpha值。 0表示完全透明，255表示完全不透明。 该方法由Drawable子类实现，返回的值特定于该类如何处理alpha。 如果该类未覆盖此方法以返回特定于其使用alpha的值，则默认返回值为255。

getBounds

Rect getBounds ()

返回drawable的边界Rect。 注意：为了提高效率，返回的对象可能是存储在drawable中的相同对象（尽管这不能保证），所以如果需要持续的边界副本，请调用copyBounds（rect）。 你也不应该改变这个方法返回的对象，因为它可能是存储在drawable中的同一个对象。

getCallback

Drawable.Callback getCallback ()

返回附加到此Drawable的当前 Drawable.Callback实现。

getChangingConfigurations

int getChangingConfigurations ()

返回此drawable可能更改的配置参数的掩码，要求重新创建它。 缺省实现返回默认情况下通过setChangingConfigurations(int)或0提供的任何内容。 子类可以将其扩展到它们所拥有的任何其他drawable的变化配置中或其中。

getColorFilter

ColorFilter getColorFilter ()

返回当前的颜色过滤器，如果没有设置则返回 null 。

getConstantState

Drawable.ConstantState getConstantState ()

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

getCurrent

Drawable getCurrent ()

getDirtyBounds

Rect getDirtyBounds ()

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

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

getHotspotBounds

void getHotspotBounds (Rect outRect)

用热点边界填充 outRect 。

getIntrinsicHeight

int getIntrinsicHeight ()

返回drawable的内在高度。

固有高度是可拉伸的布局高度，包括任何固有的填充。 如果drawable没有固有的高度，例如纯色，则此方法返回-1。

getIntrinsicWidth

int getIntrinsicWidth ()

返回drawable的内部宽度。

固有宽度是可展开的布局的宽度，包括任何固有的填充。 如果drawable没有固有的宽度，例如纯色，则此方法返回-1。

getLayoutDirection

int getLayoutDirection ()

返回此Drawable的已解析布局方向。

getLevel

int getLevel ()

检索当前级别。

getMinimumHeight

int getMinimumHeight ()

返回此Drawable建议的最小高度。 如果一个View使用这个Drawable作为背景，那么建议View使用至少这个值来表示它的高度。 （在某些情况下这是不可能的。）这个值应该包含任何填充。

getMinimumWidth

int getMinimumWidth ()

返回此Drawable建议的最小宽度。 如果一个View使用这个Drawable作为背景，那么建议View至少使用这个值来表示它的宽度。 （在某些情况下这是不可能的。）这个值应该包含任何填充。

getOpacity

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) ，但总的行为是依赖于子类实现的。

getOutline

void getOutline (Outline outline)

调用drawable来填充定义其绘图区域的Outline。

此方法由默认的 ViewOutlineProvider以定义视图的轮廓。

默认行为将轮廓定义为0 alpha的边界矩形。 希望传达不同形状或阿尔法值的子类必须重写此方法。

getPadding

boolean getPadding (Rect padding)

返回填充此Drawable建议的插入内容以将内容放入drawable的边界内。 正值移向Drawable的中心（设置Rect.inset）。

getState

int[] getState ()

描述了当前的状态，如primitve国家的联盟，比如 state_focused ， state_selected等，有些可绘可以根据所选择的状态修改他们的影像。

getTransparentRegion

Region getTransparentRegion ()

返回表示完全透明的Drawable部分的区域。 这可用于执行绘图操作，确定绘制Drawable时目标的哪些部分不会更改。 默认实现返回null，表示没有透明区域; 如果子类想要提供这个优化信息，子类可以选择性地覆盖它以返回一个实际的区域，但并不要求它们这样做。

inflate

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

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

inflate

void inflate (Resources r, 
                XmlPullParser parser, 
                AttributeSet attrs)

从XML资源膨胀此Drawable。 不适用主题。

invalidateSelf

void invalidateSelf ()

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

isAutoMirrored

boolean isAutoMirrored ()

当它的布局方向是从右到左的RTL时，告诉它是否自动镜像。 见LayoutDirection 。

isFilterBitmap

boolean isFilterBitmap ()

isStateful

boolean isStateful ()

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

isVisible

boolean isVisible ()

jumpToCurrentState

void jumpToCurrentState ()

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

mutate

Drawable mutate ()

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

onLayoutDirectionChanged

boolean onLayoutDirectionChanged (int layoutDirection)

当drawable的解析布局方向改变时调用。

resolveOpacity

int resolveOpacity (int op1, 
                int op2)

为两个源不透明度返回适当的不透明度值。 如果其中任一个是未知的，则返回; 否则，如果两者都是TRANSLUCENT，则返回; 否则，如果是透明的，则返回; 否则，返回OPAQUE。

这是为了帮助实施 getOpacity() 。

scheduleSelf

void scheduleSelf (Runnable what, 
                long when)

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

setAlpha

void setAlpha (int alpha)

为drawable指定一个alpha值。 0表示完全透明，255表示完全不透明。

setAutoMirrored

void setAutoMirrored (boolean mirrored)

设置当其布局方向为RTL（从右到左）时，此Drawable是否自动镜像。 见LayoutDirection 。

setBounds

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

为Drawable指定一个边界矩形。 这是drawable在draw（）方法被调用时绘制的地方。

setBounds

void setBounds (Rect bounds)

为Drawable指定一个边界矩形。 这是drawable在draw（）方法被调用时绘制的地方。

setCallback

void setCallback (Drawable.Callback cb)

将Drawable.Callback对象绑定到此Drawable。 需要支持动画可绘制的客户端。

setChangingConfigurations

void setChangingConfigurations (int configs)

设置该drawable可能更改的配置参数的掩码，要求重新创建它。

setColorFilter

void setColorFilter (int color, 
                PorterDuff.Mode mode)

指定一个颜色和Porter-Duff模式作为该drawable的颜色过滤器。

方便 setColorFilter(ColorFilter) ，构成 PorterDuffColorFilter 。

注意：设置颜色过滤器将禁用 tint 。

setColorFilter

void setColorFilter (ColorFilter colorFilter)

为绘图指定一个可选的颜色过滤器。

如果Drawable具有ColorFilter，则Drawable的绘图内容的每个输出像素在混合到Canvas的渲染目标之前将被颜色过滤器修改。

通过 null删除任何现有的颜色过滤器。

注意：设置非 null颜色过滤器会禁用 tint 。

setDither

void setDither (boolean dither)

此方法在API级别23中已弃用。
该属性被忽略。

将其设置为true时，绘制到每个颜色分量少于8位的设备时，其可绘制的颜色呈现抖动。

setFilterBitmap

void setFilterBitmap (boolean filter)

设置为true时，在缩放或旋转时使可绘制滤镜具有双线性采样的位图。

This can improve appearance when bitmaps are rotated. If the drawable does not use bitmaps, this call is ignored.

setHotspot

void setHotspot (float x, 
                float y)

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

setHotspotBounds

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

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

setLayoutDirection

boolean setLayoutDirection (int layoutDirection)

设置该drawable的布局方向。 应该是已解决的布局方向，因为Drawable没有能力自行完成分辨率。

setLevel

boolean setLevel (int level)

指定drawable的级别。 这允许绘图基于连续控制器改变其图像，例如以显示进度或音量级别。

如果您提供的新级别导致Drawable的外观发生变化，那么它负责调用 invalidateSelf()以重绘本身， 并且将从此函数返回true。

setState

boolean setState (int[] stateSet)

为drawable指定一组状态。 这些是特定用例，请参阅相关文档。 作为一个例子，像按钮widget的背景理解以下状态：[ state_focused ， state_pressed 。

如果您提供的新状态导致Drawable的外观发生变化，那么它负责调用 invalidateSelf()以重绘本身， 并且将从此函数返回true。

注意：Drawable持有 stateSet的引用，直到给它一个新的状态数组，所以在这段时间内你不能修改这个数组。

setTint

void setTint (int tintColor)

指定该drawable的色调颜色。

Drawable的绘图内容在绘制到屏幕前将与它的色调混合在一起。 这与setColorFilter(int, PorterDuff.Mode)功能类似。

要清除色调， null setTintList(ColorStateList)传递到 setTintList(ColorStateList) 。

Note: Setting a color filter via setColorFilter(ColorFilter) or setColorFilter(int, PorterDuff.Mode) overrides tint.

setTintList

void setTintList (ColorStateList tint)

指定该drawable的色彩颜色作为颜色状态列表。

Drawable的绘图内容在绘制到屏幕前将与它的色调混合在一起。 这功能与setColorFilter(int, PorterDuff.Mode)类似。

注意：通过 setColorFilter(ColorFilter)或 setColorFilter(int, PorterDuff.Mode)设置颜色过滤器会覆盖色调。

setTintMode

void setTintMode (PorterDuff.Mode tintMode)

指定该drawable的色调混合模式。

定义在绘制屏幕之前，该绘制的色调应该如何混合到绘图中。 默认色调模式是SRC_IN 。

注意：通过 setColorFilter(ColorFilter)或 setColorFilter(int, PorterDuff.Mode)设置颜色过滤器会覆盖色调。

setVisible

boolean setVisible (boolean visible, 
                boolean restart)

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

unscheduleSelf

void unscheduleSelf (Runnable what)

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

onBoundsChange

void onBoundsChange (Rect bounds)

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

onLevelChange

boolean onLevelChange (int level)

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

onStateChange

boolean onStateChange (int[] state)

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