Most visited

Recently visited

Results for

Added in API level 1

ScaleDrawable

public class ScaleDrawable
extends DrawableWrapper

java.lang.Object
↳	android.graphics.drawable.Drawable
	↳	android.graphics.drawable.DrawableWrapper
		↳	android.graphics.drawable.ScaleDrawable

Drawable，根据当前级别值更改另一个Drawable的大小。您可以控制Drawable子对象在宽度和高度上的变化程度以及重力，以控制放置在整个容器中的位置。最常用来实现诸如进度条之类的东西。

使用android:level属性可以从XML中指定默认级别。未指定此属性时，默认级别为0，对应于零高度和/或宽度，取决于为android.R.styleable#ScaleDrawable_scaleWidth scaleWidth和android.R.styleable#ScaleDrawable_scaleHeight scaleHeight指定的值。在运行时，可以通过setLevel(int)设置setLevel(int) 。

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

Summary

XML attributes
`android:drawable`	Reference to a drawable resource to draw with the specified scale.
`android:level`	Specifies the initial drawable level in the range 0 to 10000.
`android:scaleGravity`	Specifies where the drawable is positioned after scaling.
`android:scaleHeight`	Scale height, expressed as a percentage of the drawable's bound.
`android:scaleWidth`	Scale width, expressed as a percentage of the drawable's bound.

Public constructors
`ScaleDrawable(Drawable drawable, int gravity, float scaleWidth, float scaleHeight)` 用指定的重力和比例属性创建可绘制的新比例。

Public methods
`void`	`applyTheme(Resources.Theme t)` 将指定的主题应用于此Drawable及其子项。
`void`	`draw(Canvas canvas)` 在其边界（通过setBounds设置）中绘制，考虑可选效果，如alpha（通过setAlpha设置）和color filter（通过setColorFilter设置）。
`int`	`getOpacity()` 返回此Drawable的不透明度/透明度。
`void`	`inflate(Resources r, XmlPullParser parser, AttributeSet attrs, Resources.Theme theme)` 从可选的由主题设计的XML资源中扩展此Drawable。

Protected methods
`void`	`onBoundsChange(Rect bounds)` 如果您根据边界而变化，请在您的子类中覆盖此内容以更改外观。
`boolean`	`onLevelChange(int level)` 如果您根据级别而变化，请在您的子类中覆盖此内容以更改外观。

Inherited methods

From class android.graphics.drawable.DrawableWrapper

`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可能更改的配置参数的掩码，要求重新创建它。
`Drawable.ConstantState`	`getConstantState()` 返回保存此Drawable的共享状态的 `Drawable.ConstantState`实例。
`Drawable`	`getDrawable()`
`void`	`getHotspotBounds(Rect outRect)` 用热点边界填充 `outRect` 。
`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。
`void`	`invalidateDrawable(Drawable who)` 当drawable需要重绘时调用。
`boolean`	`isStateful()` 指示此drawable是否会根据状态更改其外观。
`Drawable`	`mutate()` 使这个drawable可变。
`void`	`onBoundsChange(Rect bounds)` 如果您根据边界而变化，请在您的子类中覆盖此内容以更改外观。
`boolean`	`onLayoutDirectionChanged(int layoutDirection)` 当drawable的解析布局方向改变时调用。
`boolean`	`onLevelChange(int level)` 如果您根据级别而变化，请在您的子类中覆盖此内容以更改外观。
`boolean`	`onStateChange(int[] state)` 如果您认识到指定的状态，请在您的子类中覆盖此内容以更改外观。
`void`	`scheduleDrawable(Drawable who, Runnable what, long when)` Drawable可以调用它来安排动画的下一帧。
`void`	`setAlpha(int alpha)` 为drawable指定一个alpha值。
`void`	`setColorFilter(ColorFilter colorFilter)` 为绘图指定一个可选的颜色过滤器。
`void`	`setDrawable(Drawable dr)` 设置包装的绘图。
`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可以调用此方法来 `scheduleDrawable(Drawable, Runnable, long)`调度先前预定的行为 `scheduleDrawable(Drawable, Runnable, long)` 。

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文档中创建一个drawable。
`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`实现来使这个可绘制的计划。
`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

From interface android.graphics.drawable.Drawable.Callback

XML attributes

android:drawable

引用可绘制资源以指定的比例绘制。

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

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

android:level

指定在0到10000范围内的初始可绘制级别。

必须是整数值，例如“ 100 ”。

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

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

android:scaleGravity

指定缩放后绘制位置的位置。缺省值为左侧。

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

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.

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

android:scaleHeight

比例高度，表示为可绘制边界的百分比。该值的格式为XX％。例如：100％，12.5％等

必须是字符串值，使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

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

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

android:scaleWidth

刻度宽度，以可绘制边界的百分比表示。该值的格式为XX％。例如：100％，12.5％等

必须是字符串值，使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

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

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

Public constructors

ScaleDrawable

Added in API level 1

ScaleDrawable (Drawable drawable, 
                int gravity, 
                float scaleWidth, 
                float scaleHeight)

用指定的重力和比例属性创建可绘制的新比例。

Parameters
`drawable`	`Drawable`: the drawable to scale
`gravity`	`int`: gravity constant (see `Gravity` used to position the scaled drawable within the parent container
`scaleWidth`	`float`: width scaling factor [0...1] to use then the level is at the maximum value, or -1 to not scale width
`scaleHeight`	`float`: height scaling factor [0...1] to use then the level is at the maximum value, or -1 to not scale height

Public methods

applyTheme

Added in API level 21

void applyTheme (Resources.Theme t)

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

Parameters
`t`	`Resources.Theme`: the theme to apply

draw

Added in API level 1

void draw (Canvas canvas)

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

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

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.

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`

Protected methods

onBoundsChange

Added in API level 1

void onBoundsChange (Rect bounds)

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

Parameters
`bounds`	`Rect`

onLevelChange

Added in API level 1

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.

Interfaces

Classes

Enums

Most visited

Recently visited

Results for

ScaleDrawable

Summary

XML attributes

Public constructors

Public methods

Protected methods

Inherited methods

XML attributes

android:drawable

android:level

android:scaleGravity

android:scaleHeight

android:scaleWidth

Public constructors

ScaleDrawable

Public methods

applyTheme

draw

getOpacity

inflate

Protected methods

onBoundsChange

onLevelChange