Most visited

Recently visited

Results for

Added in API level 1

BitmapDrawable

public class BitmapDrawable
extends Drawable

java.lang.Object
↳	android.graphics.drawable.Drawable
	↳	android.graphics.drawable.BitmapDrawable

一个可绘制的位图，可以平铺，拉伸或对齐。您可以从文件路径，输入流，XML膨胀或Bitmap对象创建一个Bitmap 。

它可以在具有<bitmap>元素的XML文件中定义。有关更多信息，请参阅Drawable Resources的指南。

另请参阅 Bitmap类，该类处理原始位图图形的管理和转换，并应在绘制到 Canvas 。

Summary

XML attributes
`android:antialias`	Enables or disables antialiasing.
`android:dither`	Enables or disables dithering of the bitmap if the bitmap does not have the same pixel configuration as the screen (for instance: a ARGB 8888 bitmap with an RGB 565 screen).
`android:filter`	Enables or disables bitmap filtering.
`android:gravity`	Defines the gravity for the bitmap.
`android:mipMap`	Enables or disables the mipmap hint.
`android:src`	Identifier of the bitmap file.
`android:tileMode`	Defines the tile mode.
`android:tileModeX`	Defines the horizontal tile mode.
`android:tileModeY`	Defines the vertical tile mode.

Public constructors
`BitmapDrawable()` 此构造函数在API级别4中已弃用。请改用`BitmapDrawable(android.content.res.Resources, android.graphics.Bitmap)`来指定要绘制的位图并确保设置了正确的密度。
`BitmapDrawable(Resources res)` 此构造函数在API级别18中已弃用。请使用`BitmapDrawable(android.content.res.Resources, android.graphics.Bitmap)`来指定要使用的位图。
`BitmapDrawable(Bitmap bitmap)` 此构造函数在API级别4中已弃用。使用`BitmapDrawable(Resources, Bitmap)`可确保drawable已正确设置其目标密度。
`BitmapDrawable(Resources res, Bitmap bitmap)` 根据位图创建drawable，根据资源的显示度量设置初始目标密度。
`BitmapDrawable(String filepath)` 此构造函数在API级别5中已弃用。使用`BitmapDrawable(Resources, String)`可确保绘图工具已正确设置其目标密度。
`BitmapDrawable(Resources res, String filepath)` 通过打开给定文件路径并解码位图来创建绘图。
`BitmapDrawable(InputStream is)` 此构造函数在API级别5中已弃用。使用`BitmapDrawable(Resources, java.io.InputStream)`可确保drawable已正确设置其目标密度。
`BitmapDrawable(Resources res, InputStream is)` 通过解码给定输入流中的位图来创建drawable。

Public methods
`void`	`applyTheme(Resources.Theme t)` 将指定的主题应用于此Drawable及其子项。
`boolean`	`canApplyTheme()`
`void`	`draw(Canvas canvas)` 在其边界（通过setBounds设置）中绘制，考虑可选效果，如alpha（通过setAlpha设置）和color filter（通过setColorFilter设置）。
`int`	`getAlpha()` 获取drawable的当前alpha值。
`final Bitmap`	`getBitmap()` 返回此drawable用于渲染的位图。
`int`	`getChangingConfigurations()` 返回此drawable可能更改的配置参数的掩码，要求重新创建它。
`ColorFilter`	`getColorFilter()` 返回当前的颜色过滤器，如果没有设置，则返回 `null` 。
`final Drawable.ConstantState`	`getConstantState()` 返回保存此Drawable的共享状态的 `Drawable.ConstantState`实例。
`int`	`getGravity()` 获取用于在其边界内定位/拉伸位图的重力。
`int`	`getIntrinsicHeight()` 返回drawable的内在高度。
`int`	`getIntrinsicWidth()` 返回drawable的内部宽度。
`int`	`getOpacity()` 返回此Drawable的不透明度/透明度。
`void`	`getOutline(Outline outline)` 调用drawable来填充定义其绘图区域的Outline。
`final Paint`	`getPaint()` 返回用于呈现此drawable的paint。
`Shader.TileMode`	`getTileModeX()` 指示此可绘制在X轴上的重复行为。
`Shader.TileMode`	`getTileModeY()` 指示此可绘图在Y轴上的重复行为。
`boolean`	`hasAntiAlias()` 指示是否为此可绘制启用消除锯齿。
`boolean`	`hasMipMap()` 指示是否在此drawable的位图上启用mipmap提示。
`void`	`inflate(Resources r, XmlPullParser parser, AttributeSet attrs, Resources.Theme theme)` 从可选的由主题设计的XML资源中扩展此Drawable。
`final boolean`	`isAutoMirrored()` 当它的布局方向是从右到左的RTL时，告诉它是否自动镜像。
`boolean`	`isFilterBitmap()`
`boolean`	`isStateful()` 指示此drawable是否会根据状态更改其外观。
`Drawable`	`mutate()` 一个可变的BitmapDrawable仍然与来自同一资源的其他Drawable共享其位图。
`void`	`setAlpha(int alpha)` 为drawable指定一个alpha值。
`void`	`setAntiAlias(boolean aa)` 为该drawable启用或禁用消除锯齿。
`void`	`setAutoMirrored(boolean mirrored)` 设置当其布局方向为RTL（从右到左）时，此Drawable是否自动镜像。
`void`	`setColorFilter(ColorFilter colorFilter)` 为绘图指定一个可选的颜色过滤器。
`void`	`setDither(boolean dither)` 此方法已弃用。该属性被忽略。
`void`	`setFilterBitmap(boolean filter)` 设置为true时，在缩放或旋转时使可绘制滤镜具有双线性采样的位图。
`void`	`setGravity(int gravity)` 设置用于在其边界内放置/拉伸位图的重力。
`void`	`setMipMap(boolean mipMap)` 启用或禁用此可绘制位图的mipmap提示。
`void`	`setTargetDensity(DisplayMetrics metrics)` 设置将绘制该drawable的密度刻度。
`void`	`setTargetDensity(Canvas canvas)` 设置将绘制该drawable的密度刻度。
`void`	`setTargetDensity(int density)` 设置该drawable将被渲染的密度。
`void`	`setTileModeX(Shader.TileMode mode)` 设置此可绘制在X轴上的重复行为。
`void`	`setTileModeXY(Shader.TileMode xmode, Shader.TileMode ymode)` 在这两个轴上设置此drawable的重复行为。
`final void`	`setTileModeY(Shader.TileMode mode)` 在Y轴上设置此可绘制对象的重复行为。
`void`	`setTintList(ColorStateList tint)` 指定该drawable的色彩颜色作为颜色状态列表。
`void`	`setTintMode(PorterDuff.Mode tintMode)` 指定该drawable的色调混合模式。

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

Inherited methods

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

XML attributes

android:antialias

启用或禁用抗锯齿。旋转时，抗锯齿可用于平滑位图的边缘。默认值为false。

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

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

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

android:dither

如果位图不具有与屏幕相同的像素配置（例如：具有RGB 565屏幕的ARGB 8888位图），则启用或禁用位图抖动。默认值为true。

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

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

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

android:filter

启用或禁用位图过滤。当位图缩小或拉伸以平滑其外观时使用过滤。默认值为true。

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

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

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

android:gravity

定义位图的引力。如果位图小于容器，则重力表示绘图在其容器中的位置。

必须是以下常量值中的一个或多个（用'|'分隔）。

Constant	Value	描述
`top`	0x30	Push object to the top of its container, not changing its size.
`bottom`	0x50	Push object to the bottom of its container, not changing its size.
`left`	0x03	Push object to the left of its container, not changing its size.
`right`	0x05	Push object to the right of its container, not changing its size.
`center_vertical`	0x10	Place object in the vertical center of its container, not changing its size.
`fill_vertical`	0x70	Grow the vertical size of the object if needed so it completely fills its container.
`center_horizontal`	0x01	Place object in the horizontal center of its container, not changing its size.
`fill_horizontal`	0x07	Grow the horizontal size of the object if needed so it completely fills its container.
`center`	0x11	Place the object in the center of its container in both the vertical and horizontal axis, not changing its size.
`fill`	0x77	Grow the horizontal and vertical size of the object if needed so it completely fills its container.
`clip_vertical`	0x80	Additional option that can be set to have the top and/or bottom edges of the child clipped to its container's bounds. The clip will be based on the vertical gravity: a top gravity will clip the bottom edge, a bottom gravity will clip the top edge, and neither will clip both edges.
`clip_horizontal`	0x08	Additional option that can be set to have the left and/or right edges of the child clipped to its container's bounds. The clip will be based on the horizontal gravity: a left gravity will clip the right edge, a right gravity will clip the left edge, and neither will clip both edges.
`start`	0x00800003	Push object to the beginning of its container, not changing its size.
`end`	0x00800005	Push object to the end of its container, not changing its size.

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

android:mipMap

启用或禁用mipmap提示。有关更多信息，请参阅setHasMipMap(boolean) 。默认值为false。

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

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

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

相关方法：

hasMipMap()

android:src

位图文件的标识符。该属性是强制性的。

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

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

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

android:tileMode

定义平铺模式。当启用平铺模式时，重复位图。启用平铺模式时会忽略重力。默认值是“禁用”。

必须是下列常数值之一。

Constant	Value	描述
`disabled`	-1	Do not tile the bitmap. This is the default value.
`clamp`	0	Replicates the edge color.
`repeat`	1	Repeats the bitmap in both direction.
`mirror`	2	Repeats the shader's image horizontally and vertically, alternating mirror images so that adjacent images always seam.

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

android:tileModeX

定义水平拼贴模式。当启用平铺模式时，重复位图。启用平铺模式时会忽略重力。默认值是“禁用”。

必须是下列常数值之一。

Constant	Value	描述
`disabled`	-1	Do not tile the bitmap. This is the default value.
`clamp`	0	Replicates the edge color.
`repeat`	1	Repeats the bitmap horizontally.
`mirror`	2	Repeats the shader's image horizontally, alternating mirror images so that adjacent images always seam.

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

相关方法：

setTileModeX(Shader.TileMode)

android:tileModeY

定义垂直拼贴模式。当启用平铺模式时，重复位图。启用平铺模式时会忽略重力。默认值是“禁用”。

必须是下列常数值之一。

Constant	Value	描述
`disabled`	-1	Do not tile the bitmap. This is the default value.
`clamp`	0	Replicates the edge color.
`repeat`	1	Repeats the bitmap vertically.
`mirror`	2	Repeats the shader's image vertically, alternating mirror images so that adjacent images always seam.

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

相关方法：

setTileModeY(Shader.TileMode)

Public constructors

BitmapDrawable

Added in API level 1

BitmapDrawable ()

此构造函数在API级别4中已被弃用。
改为使用BitmapDrawable(android.content.res.Resources, android.graphics.Bitmap)指定要绘制的位图并确保设置了正确的密度。

创建一个空的drawable，而不是处理密度。

BitmapDrawable

Added in API level 4

BitmapDrawable (Resources res)

此构造函数在API级别18中已被弃用。
改为使用BitmapDrawable(android.content.res.Resources, android.graphics.Bitmap)指定要使用的位图。

创建一个空的绘图，根据资源的显示度量设置初始目标密度。

Parameters
`res`	`Resources`

BitmapDrawable

Added in API level 1

BitmapDrawable (Bitmap bitmap)

此构造函数在API级别4中已被弃用。
使用BitmapDrawable(Resources, Bitmap)以确保绘图已正确设置其目标密度。

从位图创建drawable，而不是处理密度。

Parameters
`bitmap`	`Bitmap`

BitmapDrawable

Added in API level 4

BitmapDrawable (Resources res, 
                Bitmap bitmap)

根据位图创建drawable，根据资源的显示度量设置初始目标密度。

Parameters
`res`	`Resources`
`bitmap`	`Bitmap`

BitmapDrawable

Added in API level 1

BitmapDrawable (String filepath)

此构造函数在API级别5中已被弃用。
使用BitmapDrawable(Resources, String)确保drawable已正确设置其目标密度。

通过打开给定文件路径并解码位图来创建绘图。

Parameters
`filepath`	`String`

BitmapDrawable

Added in API level 5

BitmapDrawable (Resources res, 
                String filepath)

通过打开给定文件路径并解码位图来创建绘图。

Parameters
`res`	`Resources`
`filepath`	`String`

BitmapDrawable

Added in API level 1

BitmapDrawable (InputStream is)

此构造函数在API级别5中已被弃用。
使用BitmapDrawable(Resources, java.io.InputStream)确保绘图已正确设置其目标密度。

通过解码给定输入流中的位图来创建drawable。

Parameters
`is`	`InputStream`

BitmapDrawable

Added in API level 5

BitmapDrawable (Resources res, 
                InputStream is)

通过解码给定输入流中的位图来创建drawable。

Parameters
`res`	`Resources`
`is`	`InputStream`

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 1

void draw (Canvas canvas)

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

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

getAlpha

Added in API level 19

int getAlpha ()

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

Returns
`int`

getBitmap

Added in API level 1

Bitmap getBitmap ()

返回此drawable用于渲染的位图。可能为null。

Returns
`Bitmap`

getChangingConfigurations

Added in API level 1

int getChangingConfigurations ()

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

Returns
`int`	Returns a mask of the changing configuration parameters, as defined by `ActivityInfo`.

getColorFilter

Added in API level 21

ColorFilter getColorFilter ()

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

Returns
`ColorFilter`	the current color filter, or `null` if none set

getConstantState

Added in API level 1

Drawable.ConstantState getConstantState ()

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

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

getGravity

Added in API level 1

int getGravity ()

获取用于在其边界内定位/拉伸位图的重力。请参阅android.view.Gravity

Returns
`int`	the gravity applied to the bitmap

getIntrinsicHeight

Added in API level 1

int getIntrinsicHeight ()

返回drawable的内在高度。

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

Returns
`int`	the intrinsic height, or -1 if no intrinsic height

getIntrinsicWidth

Added in API level 1

int getIntrinsicWidth ()

返回drawable的内部宽度。

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

Returns
`int`	the intrinsic width, or -1 if no intrinsic width

getOpacity

Added in API level 1

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)

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

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

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

Parameters
`outline`	`Outline`

getPaint

Added in API level 1

Paint getPaint ()

返回用于呈现此drawable的paint。

Returns
`Paint`

getTileModeX

Added in API level 1

Shader.TileMode getTileModeX ()

指示此可绘制在X轴上的重复行为。

Returns
`Shader.TileMode`	`CLAMP` if the bitmap does not repeat, `REPEAT` or `MIRROR` otherwise.

getTileModeY

Added in API level 1

Shader.TileMode getTileModeY ()

指示此可绘图在Y轴上的重复行为。

Returns
`Shader.TileMode`	`CLAMP` if the bitmap does not repeat, `REPEAT` or `MIRROR` otherwise.

hasAntiAlias

Added in API level 18

boolean hasAntiAlias ()

指示是否为此可绘制启用消除锯齿。

Returns
`boolean`	True if anti-aliasing is enabled, false otherwise.

也可以看看：

setAntiAlias(boolean)

hasMipMap

Added in API level 18

boolean hasMipMap ()

指示是否在此drawable的位图上启用mipmap提示。

相关XML属性：

android:mipMap

Returns
`boolean`	True if the mipmap hint is set, false otherwise. If the bitmap is null, this method always returns false.

也可以看看：

setMipMap(boolean)

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`

isAutoMirrored

Added in API level 19

boolean isAutoMirrored ()

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

Returns
`boolean`	boolean Returns true if this Drawable will be automatically mirrored.

isFilterBitmap

Added in API level 23

boolean isFilterBitmap ()

Returns
`boolean`	whether this drawable filters its bitmaps

isStateful

Added in API level 1

boolean isStateful ()

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

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

mutate

Added in API level 3

Drawable mutate ()

一个可变的BitmapDrawable仍然与来自同一资源的其他Drawable共享其位图。

Returns
`Drawable`	This drawable.

setAlpha

Added in API level 1

void setAlpha (int alpha)

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

Parameters
`alpha`	`int`

setAntiAlias

Added in API level 1

void setAntiAlias (boolean aa)

为该drawable启用或禁用消除锯齿。消除锯齿仅影响位图的边缘，所以仅在绘制旋转时才适用。

Parameters
`aa`	`boolean`: True if the bitmap should be anti-aliased, false otherwise.

也可以看看：

hasAntiAlias()

setAutoMirrored

Added in API level 19

void setAutoMirrored (boolean mirrored)

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

Parameters
`mirrored`	`boolean`: Set to true if the Drawable should be mirrored, false if not.

setColorFilter

Added in API level 1

void setColorFilter (ColorFilter colorFilter)

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

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

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

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

Parameters
`colorFilter`	`ColorFilter`: The color filter to apply, or `null` to remove the existing color filter

setDither

Added in API level 1

void setDither (boolean dither)

此方法已弃用。
该属性被忽略。

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

Parameters
`dither`	`boolean`

setFilterBitmap

Added in API level 1

void setFilterBitmap (boolean filter)

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

当位图旋转时，这可以改善外观。如果drawable不使用位图，则该调用将被忽略。

Parameters
`filter`	`boolean`

setGravity

Added in API level 1

void setGravity (int gravity)

设置用于在其边界内放置/拉伸位图的重力。请参阅android.view.Gravity

Parameters
`gravity`	`int`: the gravity

setMipMap

Added in API level 18

void setMipMap (boolean mipMap)

启用或禁用此可绘制位图的mipmap提示。有关更多信息，请参阅setHasMipMap(boolean) 。如果位图为null，则调用此方法不起作用。

Parameters
`mipMap`	`boolean`: True if the bitmap should use mipmaps, false otherwise.

也可以看看：

hasMipMap()

setTargetDensity

Added in API level 4

void setTargetDensity (DisplayMetrics metrics)

设置将绘制该drawable的密度刻度。

Parameters
`metrics`	`DisplayMetrics`: The DisplayMetrics indicating the density scale for this drawable.

也可以看看：

setDensity(int)
getDensity()

setTargetDensity

Added in API level 4

void setTargetDensity (Canvas canvas)

设置将绘制该drawable的密度刻度。该方法假定drawable将以与指定画布相同的密度呈现。

Parameters
`canvas`	`Canvas`: The Canvas from which the density scale must be obtained.

也可以看看：

setDensity(int)
getDensity()

setTargetDensity

Added in API level 4

void setTargetDensity (int density)

设置该drawable将被渲染的密度。

Parameters
`density`	`int`: The density scale for this drawable.

也可以看看：

setDensity(int)
getDensity()

setTileModeX

Added in API level 1

void setTileModeX (Shader.TileMode mode)

设置此可绘制在X轴上的重复行为。默认情况下，drawable不会重复其位图。使用REPEAT或MIRROR如果位图小于该可绘制位图，则位图可以重复（或平铺）。

相关XML属性：

android:tileModeX

Parameters
`mode`	`Shader.TileMode`: The repeat mode for this drawable.

也可以看看：

setTileModeXY

Added in API level 1

void setTileModeXY (Shader.TileMode xmode, 
                Shader.TileMode ymode)

在这两个轴上设置此drawable的重复行为。默认情况下，drawable不会重复其位图。使用REPEAT或MIRROR ，如果位图小于此可绘制位图，则位图可以重复（或平铺）。

Parameters
`xmode`	`Shader.TileMode`: The X repeat mode for this drawable.
`ymode`	`Shader.TileMode`: The Y repeat mode for this drawable.

也可以看看：

setTileModeY

Added in API level 1

void setTileModeY (Shader.TileMode mode)

在Y轴上设置此可绘制对象的重复行为。默认情况下，drawable不会重复其位图。使用REPEAT或MIRROR位图可以重复（或平铺）如果位图小于此可绘制。

相关XML属性：

android:tileModeY

Parameters
`mode`	`Shader.TileMode`: The repeat mode for this drawable.

也可以看看：

setTintList

Added in API level 21

void setTintList (ColorStateList tint)

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

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

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

Parameters
`tint`	`ColorStateList`: Color state list to use for tinting this drawable, or `null` to clear the tint

setTintMode

Added in API level 21

void setTintMode (PorterDuff.Mode tintMode)

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

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

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

Parameters
`tintMode`	`PorterDuff.Mode`: A Porter-Duff blending mode

Protected methods

onBoundsChange

Added in API level 1

void onBoundsChange (Rect bounds)

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

Parameters
`bounds`	`Rect`

onStateChange

Added in API level 1

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.