public class DrawableContainer
extends Drawable
implements Drawable.Callback
java.lang.Object | ||
↳ | android.graphics.drawable.Drawable | |
↳ | android.graphics.drawable.DrawableContainer |
Known Direct Subclasses |
Known Indirect Subclasses |
一个包含几个Drawable
的辅助类,并选择使用哪一个。 您可以将其子类化以创建您自己的DrawableContainers,或直接使用其子类。
Nested classes |
|
---|---|
class |
DrawableContainer.DrawableContainerState 一个可包含几个 |
Public constructors |
|
---|---|
DrawableContainer() |
Public methods |
|
---|---|
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 |
getCurrent() |
void |
getHotspotBounds(Rect 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可变。 |
boolean |
onLayoutDirectionChanged(int layoutDirection) 当drawable的解析布局方向改变时调用。 |
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 |
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可以调用此 |
Protected methods |
|
---|---|
void |
onBoundsChange(Rect bounds) 如果您根据边界而变化,请在您的子类中覆盖此内容以更改外观。 |
boolean |
onLevelChange(int level) 如果您根据级别而变化,请在您的子类中覆盖此内容以更改外观。 |
boolean |
onStateChange(int[] state) 如果您认识到指定的状态,请在您的子类中覆盖此内容以更改外观。 |
void |
setConstantState(DrawableContainer.DrawableContainerState state) |
Inherited methods |
|
---|---|
From class android.graphics.drawable.Drawable
|
|
From class java.lang.Object
|
|
From interface android.graphics.drawable.Drawable.Callback
|
void applyTheme (Resources.Theme theme)
将指定的主题应用于此Drawable及其子项。
Parameters | |
---|---|
theme |
Resources.Theme : the theme to apply |
void draw (Canvas canvas)
在其边界(通过setBounds设置)中绘制,考虑可选效果,如alpha(通过setAlpha设置)和color filter(通过setColorFilter设置)。
Parameters | |
---|---|
canvas |
Canvas : The canvas to draw into |
int getAlpha ()
获取drawable的当前alpha值。 0表示完全透明,255表示完全不透明。 该方法由Drawable子类实现,返回的值特定于该类如何处理alpha。 如果该类未覆盖此方法以返回特定于其使用alpha的值,则默认返回值为255。
Returns | |
---|---|
int |
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 getCurrent ()
Returns | |
---|---|
Drawable |
The current drawable that will be used by this drawable. For simple drawables, this is just the drawable itself. For drawables that change state like StateListDrawable and LevelListDrawable this will be the child drawable currently in use. |
void getHotspotBounds (Rect outRect)
用热点边界填充 outRect
。
Parameters | |
---|---|
outRect |
Rect : the rect to populate with the hotspot bounds |
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 getMinimumHeight ()
返回此Drawable建议的最小高度。 如果一个View使用这个Drawable作为背景,那么建议View使用至少这个值来表示它的高度。 (在某些情况下这是不可能的。)这个值应该包含任何填充。
Returns | |
---|---|
int |
The minimum height suggested by this Drawable. If this Drawable doesn't have a suggested minimum height, 0 is returned. |
int getMinimumWidth ()
返回此Drawable建议的最小宽度。 如果一个View使用这个Drawable作为背景,那么建议View至少使用这个值来表示它的宽度。 (在某些情况下这是不可能的。)这个值应该包含任何填充。
Returns | |
---|---|
int |
The minimum width suggested by this Drawable. If this Drawable doesn't have a suggested minimum width, 0 is returned. |
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)
调用drawable来填充定义其绘图区域的Outline。
此方法由默认的 ViewOutlineProvider
以定义视图的轮廓。
默认行为将轮廓定义为0 alpha的边界矩形。 希望传达不同形状或阿尔法值的子类必须重写此方法。
Parameters | |
---|---|
outline |
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. |
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() |
boolean selectDrawable (int index)
按索引设置当前显示的绘图。
如果指定了无效索引,则当前可绘制将设置为 null
,索引将设置为 -1
。
Parameters | |
---|---|
index |
int : the index of the drawable to display |
Returns | |
---|---|
boolean |
true if the drawable changed, false otherwise |
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 setEnterFadeDuration (int ms)
当一个新的drawable进入场景时,改变全局淡入持续时间。
Parameters | |
---|---|
ms |
int : The amount of time to fade in milliseconds. |
void setExitFadeDuration (int ms)
当一个新的drawable离开场景时,改变全局渐变持续时间。
Parameters | |
---|---|
ms |
int : The amount of time to fade in milliseconds. |
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 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. |
void setConstantState (DrawableContainer.DrawableContainerState state)
Parameters | |
---|---|
state |
DrawableContainer.DrawableContainerState
|