public class LayerDrawable
extends Drawable
implements Drawable.Callback
java.lang.Object | ||
↳ | android.graphics.drawable.Drawable | |
↳ | android.graphics.drawable.LayerDrawable |
Known Direct Subclasses |
管理一系列其他Drawable的Drawable。 这些按照数组顺序绘制,因此具有最大索引的元素将被绘制在最上面。
它可以使用<layer-list>
元素在XML文件中定义。 图层中的每个Drawable都在嵌套的<item>
定义。
有关更多信息,请参阅指南 Drawable Resources 。
XML attributes |
|
---|---|
android:bottom |
Bottom inset to apply to the layer. |
android:drawable |
Drawable used to render the layer. |
android:end |
End inset to apply to the layer. |
android:gravity |
Gravity used to align the layer within its container. |
android:height |
Height of the layer. |
android:id |
Identifier of the layer. |
android:left |
Left inset to apply to the layer. |
android:paddingBottom |
Explicit bottom padding. |
android:paddingEnd |
Explicit end padding. |
android:paddingLeft |
Explicit left padding. |
android:paddingMode |
Indicates how layer padding should affect the bounds of subsequent layers. |
android:paddingRight |
Explicit right padding. |
android:paddingStart |
Explicit start padding. |
android:paddingTop |
Explicit top padding. |
android:right |
Right inset to apply to the layer. |
android:start |
Start inset to apply to the layer. |
android:top |
Top inset to apply to the layer. |
android:width |
Width of the layer. |
Constants |
|
---|---|
int |
INSET_UNDEFINED 用于未定义的开始和结束插入的值。 |
int |
PADDING_MODE_NEST 填充模式用于将每个图层嵌套在前一图层的填充内。 |
int |
PADDING_MODE_STACK 填充模式用于将每个图层直接堆叠在上一图层的顶部。 |
Public constructors |
|
---|---|
LayerDrawable(Drawable[] layers) 用指定图层列表创建一个可绘制的新图层。 |
Public methods |
|
---|---|
int |
addLayer(Drawable dr) 将包含指定的 |
void |
applyTheme(Resources.Theme t) 将指定的主题应用于此Drawable及其子项。 |
boolean |
canApplyTheme() |
void |
draw(Canvas canvas) 在其边界(通过setBounds设置)中绘制,考虑可选效果,如alpha(通过setAlpha设置)和color filter(通过setColorFilter设置)。 |
Drawable |
findDrawableByLayerId(int id) 查找具有给定ID的图层并返回其 |
int |
findIndexByLayerId(int id) 返回指定为 |
int |
getAlpha() 获取drawable的当前alpha值。 |
int |
getBottomPadding() 以像素为单位返回底部填充。 |
int |
getChangingConfigurations() 返回此drawable可能更改的配置参数的掩码,要求重新创建它。 |
Drawable.ConstantState |
getConstantState() 返回一个包含此Drawable的共享状态的 |
Drawable |
getDrawable(int index) 返回指定索引处图层的drawable。 |
int |
getEndPadding() 以像素为单位返回结尾填充。 |
void |
getHotspotBounds(Rect 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) 用第一个可用(非空)图层轮廓填充 |
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可变。 |
boolean |
onLayoutDirectionChanged(int layoutDirection) 当drawable的解析布局方向改变时调用。 |
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替换 |
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可以调用此 |
Protected methods |
|
---|---|
void |
onBoundsChange(Rect bounds) 如果您根据边界而变化,请在您的子类中覆盖此内容以更改外观。 |
boolean |
onLevelChange(int level) 如果您根据级别而变化,请在您的子类中覆盖此内容以更改外观。 |
boolean |
onStateChange(int[] state) 如果您认识到指定的状态,请在您的子类中覆盖此内容以更改外观。 |
Inherited methods |
|
---|---|
From class android.graphics.drawable.Drawable
|
|
From class java.lang.Object
|
|
From interface android.graphics.drawable.Drawable.Callback
|
底部插入应用于图层。
必须是一个维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 bottom
。
相关方法:
可绘制用于渲染图层。
必须是另一个资源的引用,其形式为“ @[+][package:]type:name
”,或者其形式为“一个主题属性 ?[package:][type:]name
”。
这对应于全局属性资源符号 drawable
。
相关方法:
结束插入以应用于图层。 根据布局方向重写left
或right
。
必须是尺寸值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 end
。
相关方法:
重力用于对齐其容器内的图层。 如果未指定值,则默认行为取决于是否设置了明确的宽度或高度。如果未设置维度,则该方向的重力默认为fill_horizontal
或fill_vertical
; 否则,它默认为left
或top
。
必须是以下常量值中的一个或多个(用'|'分隔)。
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
。
相关方法:
层的高度。 默认为图层的内在高度
必须是维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 height
。
相关方法:
图层的标识符。 这可用于从可绘制容器中检索图层。
必须是另一个资源的引用,其形式为“ @[+][package:]type:name
”,或者其形式为“一个主题属性 ?[package:][type:]name
”。
这对应于全局属性资源符号 id
。
相关方法:
左插入应用于图层。
必须是尺寸值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 left
。
相关方法:
显式底部填充。 覆盖子填充。
必须是尺寸值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 paddingBottom
。
相关方法:
显式结束填充。 覆盖子填充。 优先于绝对填充(例如,当布局方向为LTR时为右)。
必须是维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 paddingEnd
。
相关方法:
显式左侧填充。 覆盖子填充。
必须是维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可以是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 paddingLeft
。
相关方法:
指示图层填充应该如何影响后续图层的边界。 默认填充模式值是嵌套。
必须是下列常数值之一。
Constant | Value | 描述 |
---|---|---|
nest |
0 | Nest each layer inside the padding of the previous layer. |
stack |
1 | Stack each layer directly atop the previous layer. |
这对应于全局属性资源符号 paddingMode
。
相关方法:
显式右键填充。 覆盖子填充。
必须是尺寸值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 paddingRight
。
相关方法:
显式开始填充。 覆盖子填充。 优先于绝对填充(例如,在布局方向为LTR时保留)。
必须是尺寸值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 paddingStart
。
相关方法:
显式顶部填充。 覆盖子填充。
必须是一个维度值,该维度值是一个浮点数,后面跟着诸如“ 14.5sp
”之类的单位。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 paddingTop
。
相关方法:
右插入适用于图层。
必须是维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 right
。
相关方法:
开始插入以应用于图层。 根据布局方向重写left
或right
。
必须是尺寸值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 start
。
相关方法:
顶部插入适用于图层。
必须是维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 top
。
相关方法:
层的宽度。 默认为图层的内在宽度。
必须是维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 width
。
相关方法:
int INSET_UNDEFINED
用于未定义的开始和结束插入的值。
常量值:-2147483648(0x80000000)
int PADDING_MODE_NEST
填充模式用于将每个图层嵌套在前一图层的填充内。
也可以看看:
常量值:0(0x00000000)
int PADDING_MODE_STACK
填充模式用于将每个图层直接堆叠在上一图层的顶部。
也可以看看:
常数值:1(0x00000001)
LayerDrawable (Drawable[] layers)
用指定图层列表创建一个可绘制的新图层。
Parameters | |
---|---|
layers |
Drawable : a list of drawables to use as layers in this new drawable, must be non-null |
int addLayer (Drawable dr)
将包含指定的 drawable
的新图层添加到图层列表的末尾并返回其索引。
Parameters | |
---|---|
dr |
Drawable : The drawable to add as a new layer. |
Returns | |
---|---|
int |
The index of the new layer. |
void applyTheme (Resources.Theme t)
将指定的主题应用于此Drawable及其子项。
Parameters | |
---|---|
t |
Resources.Theme : the theme to apply |
void draw (Canvas canvas)
在其边界(通过setBounds设置)中绘制,考虑可选效果,如alpha(通过setAlpha设置)和color filter(通过setColorFilter设置)。
Parameters | |
---|---|
canvas |
Canvas : The canvas to draw into |
Drawable findDrawableByLayerId (int id)
查找具有给定ID的图层并返回其 Drawable
。
如果为给定的ID找到多个图层,则返回 Drawable
以匹配最高索引处的图层。
Parameters | |
---|---|
id |
int : The layer ID to search for. |
Returns | |
---|---|
Drawable |
The Drawable for the highest-indexed layer that has the given ID, or null if not found. |
int findIndexByLayerId (int id)
返回指定 id
。
如果多个图层具有相同的ID,则返回索引最低的图层。
Parameters | |
---|---|
id |
int : The ID of the layer to return. |
Returns | |
---|---|
int |
The index of the layer with the specified ID. |
int getAlpha ()
获取drawable的当前alpha值。 0表示完全透明,255表示完全不透明。 该方法由Drawable子类实现,返回的值特定于该类如何处理alpha。 如果该类未覆盖此方法以返回特定于其使用alpha的值,则默认返回值为255。
Returns | |
---|---|
int |
int getBottomPadding ()
以像素为单位返回底部填充。
返回值-1
表示没有为此维度设置明确的填充。 因此,将根据填充模式从子层计算返回getPadding(Rect)
此维的值(请参阅getPaddingMode()
。
Returns | |
---|---|
int |
the bottom padding in pixels, or -1 if not explicitly specified |
int getChangingConfigurations ()
返回此drawable可能更改的配置参数的掩码,要求重新创建它。 缺省实现返回默认情况下通过setChangingConfigurations(int)
或0提供的值。 子类可以将其扩展到它们所拥有的任何其他drawable的变化配置中或其中。
Returns | |
---|---|
int |
Returns a mask of the changing configuration parameters, as defined by ActivityInfo . |
Drawable.ConstantState getConstantState ()
返回保存此Drawable的共享状态的 Drawable.ConstantState
实例。
Returns | |
---|---|
Drawable.ConstantState |
The ConstantState associated to that Drawable. |
Drawable getDrawable (int index)
返回指定索引处图层的drawable。
相关XML属性:
Parameters | |
---|---|
index |
int : The index of the layer, must be in the range 0...getNumberOfLayers()-1 . |
Returns | |
---|---|
Drawable |
The Drawable at the specified layer index. |
也可以看看:
int getEndPadding ()
以像素为单位返回结尾填充。
返回值-1
表示没有为此维度设置明确的填充。 因此,根据填充模式将从子层计算此维返回的值getPadding(Rect)
(请参见getPaddingMode()
。
Returns | |
---|---|
int |
the end padding in pixels, or -1 if not explicitly specified |
void getHotspotBounds (Rect outRect)
用热点边界填充 outRect
。
Parameters | |
---|---|
outRect |
Rect : the rect to populate with the hotspot bounds |
int getId (int index)
返回指定图层的ID。
相关XML属性:
Parameters | |
---|---|
index |
int : The index of the layer, must be in the range 0...getNumberOfLayers()-1 . |
Returns | |
---|---|
int |
The id of the layer or NO_ID if the layer has no id. |
也可以看看:
int getIntrinsicHeight ()
返回drawable的内在高度。
固有高度是可拉伸的布局高度,包括任何固有的填充。 如果drawable没有固有的高度,例如纯色,则此方法返回-1。
Returns | |
---|---|
int |
the intrinsic height, or -1 if no intrinsic height |
int getIntrinsicWidth ()
返回drawable的内部宽度。
固有宽度是可展开的布局的宽度,包括任何固有的填充。 如果drawable没有固有的宽度,例如纯色,则此方法返回-1。
Returns | |
---|---|
int |
the intrinsic width, or -1 if no intrinsic width |
int getLayerGravity (int index)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer |
Returns | |
---|---|
int |
the gravity used to position or stretch the specified layer within its container |
也可以看看:
int getLayerHeight (int index)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the drawable to adjust |
Returns | |
---|---|
int |
the explicit height of the layer, or -1 if not specified |
也可以看看:
int getLayerInsetBottom (int index)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer |
Returns | |
---|---|
int |
number of pixels to inset from the bottom bound |
int getLayerInsetEnd (int index)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer |
Returns | |
---|---|
int |
number of pixels to inset from the end bound |
int getLayerInsetLeft (int index)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer |
Returns | |
---|---|
int |
number of pixels to inset from the left bound |
int getLayerInsetRight (int index)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer |
Returns | |
---|---|
int |
number of pixels to inset from the right bound |
int getLayerInsetStart (int index)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer |
Returns | |
---|---|
int |
the number of pixels to inset from the start bound, or INSET_UNDEFINED if not specified |
int getLayerInsetTop (int index)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer |
Returns | |
---|---|
int |
number of pixels to inset from the top bound |
int getLayerWidth (int index)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the drawable to adjust |
Returns | |
---|---|
int |
the explicit width of the layer, or -1 if not specified |
也可以看看:
int getLeftPadding ()
以像素为单位返回左侧填充。
返回值-1
表示没有为此维度设置明确的填充。 因此,将根据填充模式从子层计算此维返回的值getPadding(Rect)
(请参见getPaddingMode()
。
Returns | |
---|---|
int |
the left padding in pixels, or -1 if not explicitly specified |
int getNumberOfLayers ()
返回此图层可绘制中包含的图层数量。
Returns | |
---|---|
int |
The number of layers. |
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. |
void getOutline (Outline outline)
用第一个可用(非空)图层轮廓填充 outline
。
Parameters | |
---|---|
outline |
Outline : Outline in which to place the first available layer outline |
boolean getPadding (Rect padding)
返回填充此Drawable建议的插入内容以将内容放入drawable的边界内。 正值移向Drawable的中心(设置Rect.inset)。
Parameters | |
---|---|
padding |
Rect
|
Returns | |
---|---|
boolean |
true if this drawable actually has a padding, else false. When false is returned, the padding is always set to 0. |
int getPaddingMode ()
相关XML属性:
Returns | |
---|---|
int |
the current padding mode |
也可以看看:
int getRightPadding ()
以像素为单位返回正确的填充。
返回值-1
表示没有为此维度设置明确的填充。 因此, getPadding(Rect)
返回的此维度的值将根据填充模式从子层计算出来(请参阅getPaddingMode()
。
Returns | |
---|---|
int |
the right padding in pixels, or -1 if not explicitly specified |
int getStartPadding ()
以像素为单位返回开始填充。
返回值-1
表示没有为此维度设置明确的填充。 因此,将根据填充模式从子层计算此维返回的值getPadding(Rect)
(请参阅getPaddingMode()
。
Returns | |
---|---|
int |
the start padding in pixels, or -1 if not explicitly specified |
int getTopPadding ()
返回顶部填充像素。
-1
的返回值表示没有为此维度设置明确的填充。 因此,将根据填充模式从子层计算由getPadding(Rect)
返回的此维的值(请参阅getPaddingMode()
。
Returns | |
---|---|
int |
the top padding in pixels, or -1 if not explicitly specified |
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 |
void invalidateDrawable (Drawable who)
当drawable需要重绘时调用。 在这一点上的观点应该使自己失效(或者至少是可绘制出现的部分)。
Parameters | |
---|---|
who |
Drawable : The drawable that is requesting the update. |
boolean isAutoMirrored ()
当它的布局方向是从右到左的RTL时,告诉它是否自动镜像。 见LayoutDirection
。
Returns | |
---|---|
boolean |
boolean Returns true if this Drawable will be automatically mirrored. |
boolean isStateful ()
指示此drawable是否会根据状态更改其外观。 客户可以使用它来确定是否有必要计算它们的状态并调用setState。
Returns | |
---|---|
boolean |
True if this drawable changes its appearance based on state, false otherwise. |
void jumpToCurrentState ()
如果此Drawable确实在状态之间转换动画,请求它立即跳转到当前状态并跳过任何活动动画。
Drawable mutate ()
使这个drawable可变。 这个操作不能逆转。 一个可变的drawable保证不与其他drawable共享它的状态。 当你需要修改从资源加载的drawable的属性时,这是特别有用的。 默认情况下,从同一资源加载的所有可绘制实例共享一个公共状态; 如果修改一个实例的状态,则所有其他实例都将收到相同的修改。 在可变Drawable上调用此方法将不起作用。
Returns | |
---|---|
Drawable |
This drawable. |
boolean onLayoutDirectionChanged (int layoutDirection)
当drawable的解析布局方向改变时调用。
Parameters | |
---|---|
layoutDirection |
int : the new resolved layout direction |
Returns | |
---|---|
boolean |
true if the layout direction change has caused the appearance of the drawable to change such that it needs to be re-drawn, false otherwise |
void scheduleDrawable (Drawable who, Runnable what, long when)
Drawable可以调用它来安排动画的下一帧。 实现通常可以简单地使用参数(什么,谁,何时)来调用postAtTime(Runnable, Object, long)
来执行调度。
Parameters | |
---|---|
who |
Drawable : The drawable being scheduled. |
what |
Runnable : The action to execute. |
when |
long : The time (in milliseconds) to run. The timebase is uptimeMillis() |
void setAlpha (int alpha)
为drawable指定一个alpha值。 0表示完全透明,255表示完全不透明。
Parameters | |
---|---|
alpha |
int
|
void setAutoMirrored (boolean mirrored)
设置当其布局方向为RTL(从右到左)时,此Drawable是否自动镜像。 见LayoutDirection
。
Parameters | |
---|---|
mirrored |
boolean : Set to true if the Drawable should be mirrored, false if not. |
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 |
void setDither (boolean dither)
此方法已弃用。
该属性被忽略。
将其设置为true时,绘制到每个颜色分量少于8位的设备时,其可绘制的颜色呈现抖动。
Parameters | |
---|---|
dither |
boolean
|
void setDrawable (int index, Drawable drawable)
设置指定索引处图层的绘图。
相关XML属性:
Parameters | |
---|---|
index |
int : The index of the layer to modify, must be in the range 0...getNumberOfLayers()-1 . |
drawable |
Drawable : The drawable to set for the layer. |
也可以看看:
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). |
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 |
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 |
void setId (int index, int id)
设置图层的ID。
相关XML属性:
Parameters | |
---|---|
index |
int : The index of the layer to modify, must be in the range 0...getNumberOfLayers()-1 . |
id |
int : The id to assign to the layer. |
也可以看看:
void setLayerGravity (int index, int gravity)
设置用于放置或拉伸容器内指定图层的重力。 重力应用于任何图层setLayerInset(int, int, int, int, int)
(请参阅setLayerInset(int, int, int, int, int)
)或填充(请参阅setPaddingMode(int)
)之后。
如果重力指定为NO_GRAVITY
,则默认行为取决于是否设置了明确的宽度或高度(请参阅setLayerSize(int, int, int)
)。如果未设置尺寸,则该方向的重力默认为FILL_HORIZONTAL
或FILL_VERTICAL
; 否则,该方向的重力默认为LEFT
或TOP
。
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the drawable to adjust |
gravity |
int : the gravity to set for the layer |
也可以看看:
void setLayerHeight (int index, int h)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer to adjust |
h |
int : height in pixels, or -1 to use the intrinsic height |
void setLayerInset (int index, int l, int t, int r, int b)
指定指定索引处drawable的插图像素数。
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the drawable to adjust |
l |
int : number of pixels to add to the left bound |
t |
int : number of pixels to add to the top bound |
r |
int : number of pixels to subtract from the right bound |
b |
int : number of pixels to subtract from the bottom bound |
void setLayerInsetBottom (int index, int b)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer to adjust |
b |
int : number of pixels to inset from the bottom bound |
void setLayerInsetEnd (int index, int e)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer to adjust |
e |
int : number of pixels to inset from the end bound, or INSET_UNDEFINED if not specified |
void setLayerInsetLeft (int index, int l)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer to adjust |
l |
int : number of pixels to inset from the left bound |
void setLayerInsetRelative (int index, int s, int t, int e, int b)
指定指定索引处drawable的相对插图像素数。
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer to adjust |
s |
int : number of pixels to inset from the start bound |
t |
int : number of pixels to inset from the top bound |
e |
int : number of pixels to inset from the end bound |
b |
int : number of pixels to inset from the bottom bound |
void setLayerInsetRight (int index, int r)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer to adjust |
r |
int : number of pixels to inset from the right bound |
void setLayerInsetStart (int index, int s)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer to adjust |
s |
int : number of pixels to inset from the start bound |
void setLayerInsetTop (int index, int t)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer to adjust |
t |
int : number of pixels to inset from the top bound |
void setLayerSize (int index, int w, int h)
为指定图层设置显式大小。
注意:设置显式图层大小会更改默认图层重力行为。 有关更多信息,请参阅setLayerGravity(int, int)
。
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer to adjust |
w |
int : width in pixels, or -1 to use the intrinsic width |
h |
int : height in pixels, or -1 to use the intrinsic height |
void setLayerWidth (int index, int w)
相关XML属性:
Parameters | |
---|---|
index |
int : the index of the layer to adjust |
w |
int : width in pixels, or -1 to use the intrinsic width |
void setOpacity (int opacity)
直接设置该drawable的不透明度,而不是从图层中收集状态。
Parameters | |
---|---|
opacity |
int : The opacity to use, or PixelFormat.UNKNOWN for the default behavior |
也可以看看:
void setPadding (int left, int top, int right, int bottom)
设置绝对填充。
如果将维度中的填充指定为 -1
,则解析的填充将使用根据填充模式计算的值(请参阅 setPaddingMode(int)
)。
调用此方法将清除先前使用 setPaddingRelative(int, int, int, int)
设置的所有相对填充值。
相关XML属性:
Parameters | |
---|---|
left |
int : the left padding in pixels, or -1 to use computed padding |
top |
int : the top padding in pixels, or -1 to use computed padding |
right |
int : the right padding in pixels, or -1 to use computed padding |
bottom |
int : the bottom padding in pixels, or -1 to use computed padding |
void setPaddingMode (int mode)
指定图层填充应该如何影响后续图层的边界。 默认值是PADDING_MODE_NEST
。
相关XML属性:
Parameters | |
---|---|
mode |
int : padding mode, one of:
|
也可以看看:
void setPaddingRelative (int start, int top, int end, int bottom)
设置相对填充。
如果将维度中的填充指定为 -1
,则解析的填充将使用根据填充模式计算的值(请参阅 setPaddingMode(int)
)。
调用此方法将清除先前使用 setPadding(int, int, int, int)
设置的所有绝对填充值。
相关XML属性:
Parameters | |
---|---|
start |
int : the start padding in pixels, or -1 to use computed padding |
top |
int : the top padding in pixels, or -1 to use computed padding |
end |
int : the end padding in pixels, or -1 to use computed padding |
bottom |
int : the bottom padding in pixels, or -1 to use computed padding |
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 |
void setTintMode (PorterDuff.Mode tintMode)
指定该drawable的色调混合模式。
定义在绘制屏幕之前,该绘制的色调应该如何混合到绘图中。 默认色调模式是SRC_IN
。
注意:通过 setColorFilter(ColorFilter)
或 setColorFilter(int, PorterDuff.Mode)
设置颜色过滤器会覆盖色调。
Parameters | |
---|---|
tintMode |
PorterDuff.Mode : A Porter-Duff blending mode |
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. |
void unscheduleDrawable (Drawable who, Runnable what)
Drawable可以调用此scheduleDrawable(Drawable, Runnable, long)
调度先前预定的行为scheduleDrawable(Drawable, Runnable, long)
。 一个实现通常可以简单地调用removeCallbacks(Runnable, Object)
的参数(什么,谁)来removeCallbacks(Runnable, Object)
drawable。
Parameters | |
---|---|
who |
Drawable : The drawable being unscheduled. |
what |
Runnable : The action being unscheduled. |
void onBoundsChange (Rect bounds)
如果您根据边界而变化,请在您的子类中覆盖此内容以更改外观。
Parameters | |
---|---|
bounds |
Rect
|
boolean onLevelChange (int level)
如果您根据级别而变化,请在您的子类中覆盖此内容以更改外观。
Parameters | |
---|---|
level |
int
|
Returns | |
---|---|
boolean |
Returns true if the level 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 level. |
boolean onStateChange (int[] state)
如果您认识到指定的状态,请在您的子类中覆盖此内容以更改外观。
Parameters | |
---|---|
state |
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. |