Most visited

Recently visited

Added in API level 1

ColorDrawable

public class ColorDrawable
extends Drawable

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


一个专门的Drawable,用指定的颜色填充Canvas。 请注意,ColorDrawable会忽略ColorFilter。

它可以使用 <color>元素在XML文件中定义。

Summary

XML attributes

android:color The color to use. 

Public constructors

ColorDrawable()

创建一个新的黑色ColorDrawable。

ColorDrawable(int color)

用指定的颜色创建一个新的ColorDrawable。

Public methods

void applyTheme(Resources.Theme t)

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

boolean canApplyTheme()
void draw(Canvas canvas)

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

int getAlpha()

返回此drawable的颜色的alpha值。

int getChangingConfigurations()

返回此drawable可能更改的配置参数的掩码,要求重新创建它。

int getColor()

获取drawable的颜色值。

Drawable.ConstantState getConstantState()

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

int getOpacity()

返回此Drawable的不透明度/透明度。

void getOutline(Outline outline)

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

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

从可选的由主题设计的XML资源中扩展此Drawable。

boolean isStateful()

指示此drawable是否会根据状态更改其外观。

Drawable mutate()

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

void setAlpha(int alpha)

设置颜色的alpha值。

void setColor(int color)

设置绘图的颜色值。

void setColorFilter(ColorFilter colorFilter)

设置应用于此颜色的颜色过滤器。

void setTintList(ColorStateList tint)

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

void setTintMode(PorterDuff.Mode tintMode)

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

Protected methods

boolean onStateChange(int[] stateSet)

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

Inherited methods

From class android.graphics.drawable.Drawable
From class java.lang.Object

XML attributes

android:color

要使用的颜色。

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

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

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

Public constructors

ColorDrawable

Added in API level 1
ColorDrawable ()

创建一个新的黑色ColorDrawable。

ColorDrawable

Added in API level 1
ColorDrawable (int color)

用指定的颜色创建一个新的ColorDrawable。

Parameters
color int: The color to draw.

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 1
int getAlpha ()

返回此drawable的颜色的alpha值。

Returns
int A value between 0 and 255.

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.

getColor

Added in API level 11
int getColor ()

获取drawable的颜色值。

Returns
int int The color to draw.

getConstantState

Added in API level 1
Drawable.ConstantState getConstantState ()

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

Returns
Drawable.ConstantState The ConstantState associated to that Drawable.

getOpacity

Added in API level 1
int getOpacity ()

返回此Drawable的不透明度/透明度。 返回的值是在抽象格式常数之一PixelFormatUNKNOWNTRANSLUCENTTRANSPARENT ,或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或颜色过滤器。 一些子类,比如BitmapDrawableColorDrawable ,并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

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

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)

设置颜色的alpha值。

Parameters
alpha int: The alpha value to set, between 0 and 255.

setColor

Added in API level 11
void setColor (int color)

设置绘图的颜色值。 此操作会将此对象先前致电setAlpha(int)的结果setAlpha(int) ,这会影响底层颜色。

Parameters
color int: The color to draw.

setColorFilter

Added in API level 1
void setColorFilter (ColorFilter colorFilter)

设置应用于此颜色的颜色过滤器。

仅在版本LOLLIPOP及以上版本支持。 调用此方法对早期版本没有影响。

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

也可以看看:

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

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.

Hooray!