public
static
abstract
class
Drawable.ConstantState
extends Object
| java.lang.Object | |
| ↳ | android.graphics.drawable.Drawable.ConstantState |
 Known Direct Subclasses
|
This abstract class is used by Drawables to store shared constant state and data
between Drawables. BitmapDrawables created from the same resource will for instance
share a unique bitmap stored in their ConstantState.
newDrawable(Resources) can be used as a factory to create new Drawable instances
from this ConstantState.
Developers
getConstantState() to retrieve the ConstantState of a Drawable. Calling
mutate() on a Drawable should typically create a new ConstantState for that
Drawable.
Public constructors | |
|---|---|
Drawable.ConstantState()
|
|
Public methods | |
|---|---|
boolean
|
canApplyTheme()
Return whether this constant state can have a theme applied. |
abstract
int
|
getChangingConfigurations()
Return a bit mask of configuration changes that will impact this drawable (and thus require completely reloading it). |
Drawable
|
newDrawable(Resources res)
Creates a new Drawable instance from its constant state using the specified resources. |
abstract
Drawable
|
newDrawable()
Creates a new Drawable instance from its constant state. |
Drawable
|
newDrawable(Resources res, Resources.Theme theme)
Creates a new Drawable instance from its constant state using the specified resources and theme. |
Inherited methods | |
|---|---|
From
class
java.lang.Object
| |
boolean canApplyTheme ()
Return whether this constant state can have a theme applied.
| Returns | |
|---|---|
boolean |
|
int getChangingConfigurations ()
Return a bit mask of configuration changes that will impact this drawable (and thus require completely reloading it).
| Returns | |
|---|---|
int |
|
Drawable newDrawable (Resources res)
Creates a new Drawable instance from its constant state using the specified resources. This method should be implemented for drawables that have density-dependent properties.
The default implementation for this method calls through to
newDrawable().
| Parameters | |
|---|---|
res |
Resources:
the resources of the context in which the drawable will
be displayed |
| Returns | |
|---|---|
Drawable |
a new drawable object based on this constant state |
Drawable newDrawable ()
Creates a new Drawable instance from its constant state.
Note: Using this method means density-dependent
properties, such as pixel dimensions or bitmap images, will not be
updated to match the density of the target display. To ensure
correct scaling, use newDrawable(Resources) instead to
provide an appropriate Resources object.
| Returns | |
|---|---|
Drawable |
a new drawable object based on this constant state |
Drawable newDrawable (Resources res, Resources.Theme theme)
Creates a new Drawable instance from its constant state using the specified resources and theme. This method should be implemented for drawables that have theme-dependent properties.
The default implementation for this method calls through to
newDrawable(Resources).
| Parameters | |
|---|---|
res |
Resources:
the resources of the context in which the drawable will
be displayed |
theme |
Resources.Theme:
the theme of the context in which the drawable will be
displayed |
| Returns | |
|---|---|
Drawable |
a new drawable object based on this constant state |