public class InsetDrawable
extends DrawableWrapper
java.lang.Object | |||
↳ | android.graphics.drawable.Drawable | ||
↳ | android.graphics.drawable.DrawableWrapper | ||
↳ | android.graphics.drawable.InsetDrawable |
Drawable将另一个Drawable插入指定的距离。 当View需要比View的实际边界小的背景时使用。
它可以使用<inset>
元素在XML文件中定义。 有关更多信息,请参阅Drawable Resources的指南。
XML attributes |
|
---|---|
android:drawable |
Reference to a drawable resource to use for the frame. |
android:insetBottom |
|
android:insetLeft |
|
android:insetRight |
|
android:insetTop |
|
android:visible |
Provides initial visibility state of the drawable; the default value is false. |
Public constructors |
|
---|---|
InsetDrawable(Drawable drawable, int inset) 用指定的插入创建一个新的插入drawable。 |
|
InsetDrawable(Drawable drawable, int insetLeft, int insetTop, int insetRight, int insetBottom) 用指定的插入符创建一个新的插入drawable。 |
Public methods |
|
---|---|
void |
applyTheme(Resources.Theme t) 将指定的主题应用于此Drawable及其子项。 |
int |
getIntrinsicHeight() 返回drawable的内在高度。 |
int |
getIntrinsicWidth() 返回drawable的内部宽度。 |
int |
getOpacity() 返回此Drawable的不透明度/透明度。 |
void |
getOutline(Outline outline) 调用drawable来填充定义其绘图区域的Outline。 |
boolean |
getPadding(Rect padding) 返回填充此Drawable建议的插入内容以将内容放入drawable的边界内。 |
void |
inflate(Resources r, XmlPullParser parser, AttributeSet attrs, Resources.Theme theme) 从可选的由主题设计的XML资源中扩展此Drawable。 |
Protected methods |
|
---|---|
void |
onBoundsChange(Rect bounds) 如果您根据边界而变化,请在您的子类中覆盖此内容以更改外观。 |
Inherited methods |
|
---|---|
From class android.graphics.drawable.DrawableWrapper
|
|
From class android.graphics.drawable.Drawable
|
|
From class java.lang.Object
|
|
From interface android.graphics.drawable.Drawable.Callback
|
引用可用于该帧的可绘制资源。 如果没有给出,drawable必须由第一个子标签定义。
必须是另一个资源的引用,其形式为“ @[+][package:]type:name
”,或者其形式为“一个主题属性 ?[package:][type:]name
”。
这对应于全局属性资源符号 drawable
。
提供drawable的初始可见性状态; 默认值是false。 见setVisible(boolean, boolean)
。
必须是布尔值,可以是“ true
”或“ false
”。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的 ?[package:][type:]name
。
这对应于全局属性资源符号 visible
。
InsetDrawable (Drawable drawable, int inset)
用指定的插入创建一个新的插入drawable。
Parameters | |
---|---|
drawable |
Drawable : The drawable to inset. |
inset |
int : Inset in pixels around the drawable. |
InsetDrawable (Drawable drawable, int insetLeft, int insetTop, int insetRight, int insetBottom)
用指定的插入符创建一个新的插入drawable。
Parameters | |
---|---|
drawable |
Drawable : The drawable to inset. |
insetLeft |
int : Left inset in pixels. |
insetTop |
int : Top inset in pixels. |
insetRight |
int : Right inset in pixels. |
insetBottom |
int : Bottom inset in pixels. |
void applyTheme (Resources.Theme t)
将指定的主题应用于此Drawable及其子项。
Parameters | |
---|---|
t |
Resources.Theme : the theme to apply |
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 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 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 onBoundsChange (Rect bounds)
如果您根据边界而变化,请在您的子类中覆盖此内容以更改外观。
Parameters | |
---|---|
bounds |
Rect
|