| java.lang.Object | ||
| ↳ | android.graphics.drawable.Drawable | |
| ↳ | android.graphics.drawable.LayerDrawable | |
 Known Direct Subclasses
|
A Drawable that manages an array of other Drawables. These are drawn in array order, so the element with the largest index will be drawn on top.
It can be defined in an XML file with the <layer-list> element.
Each Drawable in the layer is defined in a nested <item>.
For more information, see the guide to Drawable Resources.
| XML Attributes | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| android:bottom | setLayerInsetRelative(int,int,int,int,int) | Bottom inset to apply to the layer. | |||||||||
| android:drawable | setDrawable(int,Drawable) | Drawable used to render the layer. | |||||||||
| android:end | setLayerInsetRelative(int,int,int,int,int) | End inset to apply to the layer. | |||||||||
| android:gravity | setLayerGravity(int,int) | Gravity used to align the layer within its container. | |||||||||
| android:height | setLayerSize(int,int,int) | Height of the layer. | |||||||||
| android:id | setId(int,int) | Identifier of the layer. | |||||||||
| android:left | setLayerInsetLeft(int,int) | Left inset to apply to the layer. | |||||||||
| android:paddingBottom | setPaddingRelative(int,int,int,int) | Explicit bottom padding. | |||||||||
| android:paddingEnd | setPaddingRelative(int,int,int,int) | Explicit end padding. | |||||||||
| android:paddingLeft | setPadding(int,int,int,int) | Explicit left padding. | |||||||||
| android:paddingMode | setPaddingMode(int) | Indicates how layer padding should affect the bounds of subsequent layers. | |||||||||
| android:paddingRight | setPadding(int,int,int,int) | Explicit right padding. | |||||||||
| android:paddingStart | setPaddingRelative(int,int,int,int) | Explicit start padding. | |||||||||
| android:paddingTop | setPaddingRelative(int,int,int,int) | Explicit top padding. | |||||||||
| android:right | setLayerInsetRight(int,int) | Right inset to apply to the layer. | |||||||||
| android:start | setLayerInsetStart(int,int) | Start inset to apply to the layer. | |||||||||
| android:top | setLayerInsetTop(int,int) | Top inset to apply to the layer. | |||||||||
| android:width | setLayerWidth(int,int) | Width of the layer. | |||||||||
| Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| int | PADDING_MODE_NEST | Padding mode used to nest each layer inside the padding of the previous layer. | |||||||||
| int | PADDING_MODE_STACK | Padding mode used to stack each layer directly atop the previous layer. | |||||||||
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Creates a new layer drawable with the list of specified layers.
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Adds a new layer containing the specified
drawable to the end of
the layer list and returns its index.
| |||||||||||
Applies the specified theme to this Drawable and its children.
| |||||||||||
Draw in its bounds (set via setBounds) respecting optional effects such
as alpha (set via setAlpha) and color filter (set via setColorFilter).
| |||||||||||
Looks for a layer with the given ID and returns its
Drawable.
| |||||||||||
Returns the layer with the specified
id.
| |||||||||||
Gets the current alpha value for the drawable.
| |||||||||||
Returns the bottom padding in pixels.
| |||||||||||
Return a mask of the configuration parameters for which this drawable
may change, requiring that it be re-created.
| |||||||||||
Return a
Drawable.ConstantState instance that holds the shared state of this Drawable.
| |||||||||||
Returns the drawable for the layer at the specified index.
| |||||||||||
Returns the end padding in pixels.
| |||||||||||
Populates
outRect with the hotspot bounds.
| |||||||||||
Returns the ID of the specified layer.
| |||||||||||
Return the intrinsic height of the underlying drawable object.
| |||||||||||
Return the intrinsic width of the underlying drawable object.
| |||||||||||
Returns the left padding in pixels.
| |||||||||||
Returns the number of layers contained within this layer drawable.
| |||||||||||
Return the opacity/transparency of this Drawable.
| |||||||||||
Populates
outline with the first available (non-empty) layer outline.
| |||||||||||
Return in padding the insets suggested by this Drawable for placing
content inside the drawable's bounds.
| |||||||||||
Returns the right padding in pixels.
| |||||||||||
Returns the start padding in pixels.
| |||||||||||
Returns the top padding in pixels.
| |||||||||||
Inflate this Drawable from an XML resource optionally styled by a theme.
| |||||||||||
Called when the drawable needs to be redrawn.
| |||||||||||
Tells if this Drawable will be automatically mirrored when its layout direction is RTL
right-to-left.
| |||||||||||
Indicates whether this drawable will change its appearance based on
state.
| |||||||||||
Make this drawable mutable.
| |||||||||||
Called when the drawable's resolved layout direction changes.
| |||||||||||
A Drawable can call this to schedule the next frame of its
animation.
| |||||||||||
Specify an alpha value for the drawable.
| |||||||||||
Set whether this Drawable is automatically mirrored when its layout direction is RTL
(right-to left).
| |||||||||||
Specify an optional color filter for the drawable.
| |||||||||||
This method is deprecated.
This property is ignored.
| |||||||||||
Sets the drawable for the layer at the specified index.
| |||||||||||
Replaces the
Drawable for the layer with the given id.
| |||||||||||
Specifies the hotspot's location within the drawable.
| |||||||||||
Sets the bounds to which the hotspot is constrained, if they should be
different from the drawable bounds.
| |||||||||||
Sets the ID of a layer.
| |||||||||||
Sets the gravity used to position or stretch the specified layer within
its container.
| |||||||||||
Specifies the insets in pixels for the drawable at the specified index.
| |||||||||||
Specifies the relative insets in pixels for the drawable at the
specified index.
| |||||||||||
Sets an explicit size for the specified layer.
| |||||||||||
Sets the opacity of this drawable directly instead of collecting the
states from the layers.
| |||||||||||
Sets the absolute padding.
| |||||||||||
Specifies how layer padding should affect the bounds of subsequent
layers.
| |||||||||||
Sets the relative padding.
| |||||||||||
Specifies tint color for this drawable as a color state list.
| |||||||||||
Specifies a tint blending mode for this drawable.
| |||||||||||
Set whether this Drawable is visible.
| |||||||||||
A Drawable can call this to unschedule an action previously
scheduled with
scheduleDrawable(Drawable, Runnable, long).
| |||||||||||
| Protected Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Override this in your subclass to change appearance if you vary based on
the bounds.
| |||||||||||
Override this in your subclass to change appearance if you vary based
on level.
| |||||||||||
Override this in your subclass to change appearance if you recognize the
specified state.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
From class
android.graphics.drawable.Drawable
| |||||||||||
|
From class
java.lang.Object
| |||||||||||
|
From interface
android.graphics.drawable.Drawable.Callback
| |||||||||||
Bottom inset to apply to the layer.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol bottom.
Drawable used to render the layer.
Must be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
This corresponds to the global attribute
resource symbol drawable.
End inset to apply to the layer. Overrides left or
right depending on layout direction.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol end.
Gravity used to align the layer within its container. If no value
is specified, the default behavior depends on whether an explicit
width or height has been set, If no dimension is set, gravity in
that direction defaults to fill_horizontal or
fill_vertical; otherwise, it defaults to left or
top.
Must be one or more (separated by '|') of the following constant values.
| Constant | Value | Description |
|---|---|---|
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. |
This corresponds to the global attribute
resource symbol gravity.
Height of the layer. Defaults to the layer's intrinsic height
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol height.
Identifier of the layer. This can be used to retrieve the layer from a drawable container.
Must be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
This corresponds to the global attribute
resource symbol id.
Left inset to apply to the layer.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol left.
Explicit bottom padding. Overrides child padding.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol paddingBottom.
Explicit end padding. Overrides child padding. Takes precedence over absolute padding (e.g. right when layout direction is LTR).
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol paddingEnd.
Explicit left padding. Overrides child padding.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol paddingLeft.
Indicates how layer padding should affect the bounds of subsequent layers. The default padding mode value is nest.
Must be one of the following constant values.
| Constant | Value | Description |
|---|---|---|
nest | 0 | Nest each layer inside the padding of the previous layer. |
stack | 1 | Stack each layer directly atop the previous layer. |
This corresponds to the global attribute
resource symbol paddingMode.
Explicit right padding. Overrides child padding.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol paddingRight.
Explicit start padding. Overrides child padding. Takes precedence over absolute padding (e.g. left when layout direction is LTR).
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol paddingStart.
Explicit top padding. Overrides child padding.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol paddingTop.
Right inset to apply to the layer.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol right.
Start inset to apply to the layer. Overrides left or
right depending on layout direction.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol start.
Top inset to apply to the layer.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol top.
Width of the layer. Defaults to the layer's intrinsic width.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute
resource symbol width.
Padding mode used to nest each layer inside the padding of the previous layer.
Padding mode used to stack each layer directly atop the previous layer.
Creates a new layer drawable with the list of specified layers.
| layers | a list of drawables to use as layers in this new drawable, must be non-null |
|---|
Adds a new layer containing the specified drawable to the end of
the layer list and returns its index.
| dr | The drawable to add as a new layer. |
|---|
Applies the specified theme to this Drawable and its children.
Draw in its bounds (set via setBounds) respecting optional effects such as alpha (set via setAlpha) and color filter (set via setColorFilter).
| canvas | The canvas to draw into |
|---|
Looks for a layer with the given ID and returns its Drawable.
If multiple layers are found for the given ID, returns the
Drawable for the matching layer at the highest index.
| id | The layer ID to search for. |
|---|
Developers
Drawable for the highest-indexed layer that has the
given ID, or null if not found.
Returns the layer with the specified id.
If multiple layers have the same ID, returns the layer with the lowest index.
| id | The ID of the layer to return. |
|---|
Gets the current alpha value for the drawable. 0 means fully transparent, 255 means fully opaque. This method is implemented by Drawable subclasses and the value returned is specific to how that class treats alpha. The default return value is 255 if the class does not override this method to return a value specific to its use of alpha.
Returns the bottom padding in pixels.
A return value of -1 means there is no explicit padding set for
this dimension. As a result, the value for this dimension returned by
getPadding(Rect) will be computed from the child layers
according to the padding mode (see getPaddingMode().
Return a mask of the configuration parameters for which this drawable
may change, requiring that it be re-created. The default implementation
returns whatever was provided through
setChangingConfigurations(int) or 0 by default. Subclasses
may extend this to or in the changing configurations of any other
drawables they hold.
ActivityInfo.Return a Drawable.ConstantState instance that holds the shared state of this Drawable.
Returns the drawable for the layer at the specified index.
| index | The index of the layer, must be in the range
0...getNumberOfLayers()-1. |
|---|
Drawable at the specified layer index.Returns the end padding in pixels.
A return value of -1 means there is no explicit padding set for
this dimension. As a result, the value for this dimension returned by
getPadding(Rect) will be computed from the child layers
according to the padding mode (see getPaddingMode().
Populates outRect with the hotspot bounds.
| outRect | the rect to populate with the hotspot bounds |
|---|
Returns the ID of the specified layer.
| index | The index of the layer, must be in the range
0...getNumberOfLayers()-1. |
|---|
NO_ID if the
layer has no id.Return the intrinsic height of the underlying drawable object. Returns -1 if it has no intrinsic height, such as with a solid color.
Return the intrinsic width of the underlying drawable object. Returns -1 if it has no intrinsic width, such as with a solid color.
| index | the index of the layer |
|---|
| index | the index of the drawable to adjust |
|---|
| index | the index of the layer |
|---|
| index | the index of the layer |
|---|
| index | the index of the layer |
|---|
| index | the index of the layer |
|---|
| index | the index of the layer |
|---|
| index | the index of the layer |
|---|
| index | the index of the drawable to adjust |
|---|
Returns the left padding in pixels.
A return value of -1 means there is no explicit padding set for
this dimension. As a result, the value for this dimension returned by
getPadding(Rect) will be computed from the child layers
according to the padding mode (see getPaddingMode().
Returns the number of layers contained within this layer drawable.
Return the opacity/transparency of this Drawable. The returned value is
one of the abstract format constants in
PixelFormat:
UNKNOWN,
TRANSLUCENT,
TRANSPARENT, or
OPAQUE.
An OPAQUE drawable is one that draws all all content within its bounds, completely covering anything behind the drawable. A TRANSPARENT drawable is one that draws nothing within its bounds, allowing everything behind it to show through. A TRANSLUCENT drawable is a drawable in any other state, where the drawable will draw some, but not all, of the content within its bounds and at least some content behind the drawable will be visible. If the visibility of the drawable's contents cannot be determined, the safest/best return value is TRANSLUCENT.
Generally a Drawable should be as conservative as possible with the
value it returns. For example, if it contains multiple child drawables
and only shows one of them at a time, if only one of the children is
TRANSLUCENT and the others are OPAQUE then TRANSLUCENT should be
returned. You can use the method resolveOpacity(int, int) to perform a
standard reduction of two opacities to the appropriate single output.
Note that the returned value does not necessarily take into account a
custom alpha or color filter that has been applied by the client through
the setAlpha(int) or setColorFilter(ColorFilter) methods. Some subclasses,
such as BitmapDrawable, ColorDrawable, and GradientDrawable,
do account for the value of setAlpha(int), but the general behavior is dependent
upon the implementation of the subclass.
Populates outline with the first available (non-empty) layer outline.
| outline | Outline in which to place the first available layer outline |
|---|
Return in padding the insets suggested by this Drawable for placing content inside the drawable's bounds. Positive values move toward the center of the Drawable (set Rect.inset).
Returns the right padding in pixels.
A return value of -1 means there is no explicit padding set for
this dimension. As a result, the value for this dimension returned by
getPadding(Rect) will be computed from the child layers
according to the padding mode (see getPaddingMode().
Returns the start padding in pixels.
A return value of -1 means there is no explicit padding set for
this dimension. As a result, the value for this dimension returned by
getPadding(Rect) will be computed from the child layers
according to the padding mode (see getPaddingMode().
Returns the top padding in pixels.
A return value of -1 means there is no explicit padding set for
this dimension. As a result, the value for this dimension returned by
getPadding(Rect) will be computed from the child layers
according to the padding mode (see getPaddingMode().
Inflate this Drawable from an XML resource optionally styled by a theme.
| r | Resources used to resolve attribute values |
|---|---|
| parser | XML parser from which to inflate this Drawable |
| attrs | Base set of attribute values |
| theme | Theme to apply, may be null |
Called when the drawable needs to be redrawn. A view at this point should invalidate itself (or at least the part of itself where the drawable appears).
| who | The drawable that is requesting the update. |
|---|
Tells if this Drawable will be automatically mirrored when its layout direction is RTL
right-to-left. See LayoutDirection.
Indicates whether this drawable will change its appearance based on state. Clients can use this to determine whether it is necessary to calculate their state and call setState.
Make this drawable mutable. This operation cannot be reversed. A mutable drawable is guaranteed to not share its state with any other drawable. This is especially useful when you need to modify properties of drawables loaded from resources. By default, all drawables instances loaded from the same resource share a common state; if you modify the state of one instance, all the other instances will receive the same modification. Calling this method on a mutable Drawable will have no effect.
Called when the drawable's resolved layout direction changes.
| layoutDirection | the new resolved layout direction |
|---|
A Drawable can call this to schedule the next frame of its
animation. An implementation can generally simply call
postAtTime(Runnable, Object, long) with
the parameters (what, who, when) to perform the
scheduling.
| who | The drawable being scheduled. |
|---|---|
| what | The action to execute. |
| when | The time (in milliseconds) to run. The timebase is
uptimeMillis()
|
Specify an alpha value for the drawable. 0 means fully transparent, and 255 means fully opaque.
Set whether this Drawable is automatically mirrored when its layout direction is RTL
(right-to left). See LayoutDirection.
| mirrored | Set to true if the Drawable should be mirrored, false if not. |
|---|
Specify an optional color filter for the drawable.
If a Drawable has a ColorFilter, each output pixel of the Drawable's drawing contents will be modified by the color filter before it is blended onto the render target of a Canvas.
Pass null to remove any existing color filter.
Note: Setting a non-null color
filter disables tint.
| colorFilter | The color filter to apply, or null to remove the
existing color filter
|
|---|
This method is deprecated.
This property is ignored.
Set to true to have the drawable dither its colors when drawn to a device with fewer than 8-bits per color component.
Sets the drawable for the layer at the specified index.
| index | The index of the layer to modify, must be in the range
0...getNumberOfLayers()-1. |
|---|---|
| drawable | The drawable to set for the layer. |
Specifies the hotspot's location within the drawable.
| x | The X coordinate of the center of the hotspot |
|---|---|
| y | The Y coordinate of the center of the hotspot |
Sets the bounds to which the hotspot is constrained, if they should be different from the drawable bounds.
| left | position in pixels of the left bound |
|---|---|
| top | position in pixels of the top bound |
| right | position in pixels of the right bound |
| bottom | position in pixels of the bottom bound |
Sets the ID of a layer.
| index | The index of the layer to modify, must be in the range
0...getNumberOfLayers()-1. |
|---|---|
| id | The id to assign to the layer. |
Sets the gravity used to position or stretch the specified layer within
its container. Gravity is applied after any layer insets (see
setLayerInset(int, int, int, int, int)) or padding (see
setPaddingMode(int)).
If gravity is specified as NO_GRAVITY, the default
behavior depends on whether an explicit width or height has been set
(see setLayerSize(int, int, int)), If a dimension is not set,
gravity in that direction defaults to FILL_HORIZONTAL or
FILL_VERTICAL; otherwise, gravity in that direction
defaults to LEFT or TOP.
| index | the index of the drawable to adjust |
|---|---|
| gravity | the gravity to set for the layer |
| index | the index of the layer to adjust |
|---|---|
| h | height in pixels, or -1 to use the intrinsic height |
Specifies the insets in pixels for the drawable at the specified index.
| index | the index of the drawable to adjust |
|---|---|
| l | number of pixels to add to the left bound |
| t | number of pixels to add to the top bound |
| r | number of pixels to subtract from the right bound |
| b | number of pixels to subtract from the bottom bound |
| index | the index of the layer to adjust |
|---|---|
| b | number of pixels to inset from the bottom bound |
| index | the index of the layer to adjust |
|---|---|
| e | number of pixels to inset from the end bound |
| index | the index of the layer to adjust |
|---|---|
| l | number of pixels to inset from the left bound |
Specifies the relative insets in pixels for the drawable at the specified index.
| index | the index of the layer to adjust |
|---|---|
| s | number of pixels to inset from the start bound |
| t | number of pixels to inset from the top bound |
| e | number of pixels to inset from the end bound |
| b | number of pixels to inset from the bottom bound |
| index | the index of the layer to adjust |
|---|---|
| r | number of pixels to inset from the right bound |
| index | the index of the layer to adjust |
|---|---|
| s | number of pixels to inset from the start bound |
| index | the index of the layer to adjust |
|---|---|
| t | number of pixels to inset from the top bound |
Sets an explicit size for the specified layer.
Note: Setting an explicit layer size changes the
default layer gravity behavior. See setLayerGravity(int, int)
for more information.
| index | the index of the layer to adjust |
|---|---|
| w | width in pixels, or -1 to use the intrinsic width |
| h | height in pixels, or -1 to use the intrinsic height |
| index | the index of the layer to adjust |
|---|---|
| w | width in pixels, or -1 to use the intrinsic width |
Sets the opacity of this drawable directly instead of collecting the states from the layers.
| opacity | The opacity to use, or PixelFormat.UNKNOWN for the default behavior |
|---|
Sets the absolute padding.
If padding in a dimension is specified as -1, the resolved
padding will use the value computed according to the padding mode (see
setPaddingMode(int)).
Calling this method clears any relative padding values previously set
using setPaddingRelative(int, int, int, int).
| left | the left padding in pixels, or -1 to use computed padding |
|---|---|
| top | the top padding in pixels, or -1 to use computed padding |
| right | the right padding in pixels, or -1 to use computed padding |
| bottom | the bottom padding in pixels, or -1 to use computed padding |
Specifies how layer padding should affect the bounds of subsequent
layers. The default value is PADDING_MODE_NEST.
| mode | padding mode, one of:
|
|---|
Sets the relative padding.
If padding in a dimension is specified as -1, the resolved
padding will use the value computed according to the padding mode (see
setPaddingMode(int)).
Calling this method clears any absolute padding values previously set
using setPadding(int, int, int, int).
| start | the start padding in pixels, or -1 to use computed padding |
|---|---|
| top | the top padding in pixels, or -1 to use computed padding |
| end | the end padding in pixels, or -1 to use computed padding |
| bottom | the bottom padding in pixels, or -1 to use computed padding |
Specifies tint color for this drawable as a color state list.
A Drawable's drawing content will be blended together with its tint
before it is drawn to the screen. This functions similarly to
setColorFilter(int, PorterDuff.Mode).
Note: Setting a color filter via
setColorFilter(ColorFilter) or
setColorFilter(int, PorterDuff.Mode) overrides tint.
| tint | Color state list to use for tinting this drawable, or
null to clear the tint |
|---|
Specifies a tint blending mode for this drawable.
Defines how this drawable's tint color should be blended into the drawable
before it is drawn to screen. Default tint mode is SRC_IN.
Note: Setting a color filter via
setColorFilter(ColorFilter) or
setColorFilter(int, PorterDuff.Mode) overrides tint.
| tintMode | A Porter-Duff blending mode |
|---|
Set whether this Drawable is visible. This generally does not impact the Drawable's behavior, but is a hint that can be used by some Drawables, for example, to decide whether run animations.
| visible | Set to true if visible, false if not. |
|---|---|
| restart | 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. |
A Drawable can call this to unschedule an action previously
scheduled with scheduleDrawable(Drawable, Runnable, long). An implementation can
generally simply call
removeCallbacks(Runnable, Object) with
the parameters (what, who) to unschedule the drawable.
| who | The drawable being unscheduled. |
|---|---|
| what | The action being unscheduled. |
Override this in your subclass to change appearance if you vary based on the bounds.
Override this in your subclass to change appearance if you vary based on level.
Override this in your subclass to change appearance if you recognize the specified state.