Skip to content

Most visited

Recently visited

navigation
Added in API level 1

Drawable.ConstantState

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.

Use getConstantState() to retrieve the ConstantState of a Drawable. Calling mutate() on a Drawable should typically create a new ConstantState for that Drawable.

Summary

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

Public constructors

Drawable.ConstantState

Added in API level 1
Drawable.ConstantState ()

Public methods

canApplyTheme

Added in API level 21
boolean canApplyTheme ()

Return whether this constant state can have a theme applied.

Returns
boolean

getChangingConfigurations

Added in API level 1
int getChangingConfigurations ()

Return a bit mask of configuration changes that will impact this drawable (and thus require completely reloading it).

Returns
int

newDrawable

Added in API level 5
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

newDrawable

Added in API level 1
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

See also:

newDrawable

Added in API level 21
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
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.