ResourcesCompat

const val ID_NULL = 0: @AnyRes Int

The null resource ID. This denotes an invalid resource ID that is returned by the system when a resource is not found or the value is set to @null in XML.

java-static fun clearCachesForTheme(theme: Resources.Theme): Unit

Clears cached values associated with the specified Theme.

This method allows developers to work around issues related to stale cached resources that may occur on API level 32 and below following a call to applyStyle. If you are not explicitly calling applyStyle in your code, you probably do not need to call this method.

Starting in Android T, the Theme class correctly implements hashCode and cached values will be appropriately cleared when the contents of a Theme object change.

java-static fun getCachedFont(context: Context, id: @FontRes Int): Typeface?

Returns a cached font Typeface associated with a particular resource ID.

This method returns non-null Typeface if the requested font is already fetched. Otherwise immediately returns null without requesting to font provider.

Prior to API level 23, font resources with more than one font in a family will only load the font closest to a regular weight typeface.

java-static fun getColor(res: Resources, id: @ColorRes Int, theme: Resources.Theme?): @ColorInt Int

Returns a themed color integer associated with a particular resource ID. If the resource holds a complex ColorStateList, then the default color from the set is returned.

Prior to API level 23, the theme will not be applied and this method calls through to getColor.

java-static fun getColorStateList(res: Resources, id: @ColorRes Int, theme: Resources.Theme?): ColorStateList?

Returns a themed color state list associated with a particular resource ID. The resource may contain either a single raw color value or a complex ColorStateList holding multiple possible colors.

java-static fun getDrawable(res: Resources, id: @DrawableRes Int, theme: Resources.Theme?): Drawable?

Return a drawable object associated with a particular resource ID and styled for the specified theme. Various types of objects will be returned depending on the underlying resource -- for example, a solid color, PNG image, scalable image, etc.

Prior to API level 21, the theme will not be applied and this method simply calls through to getDrawable.

java-static fun getDrawableForDensity(
    res: Resources,
    id: @DrawableRes Int,
    density: Int,
    theme: Resources.Theme?
): Drawable?

Return a drawable object associated with a particular resource ID for the given screen density in DPI and styled for the specified theme.

Prior to API level 15, the theme and density will not be applied and this method simply calls through to getDrawable.

Prior to API level 21, the theme will not be applied and this method calls through to Resources#getDrawableForDensity(int, int).

java-static fun getFloat(res: Resources, id: @DimenRes Int): Float

Retrieve a floating-point value for a particular resource ID.

java-static fun getFont(context: Context, id: @FontRes Int): Typeface?

Returns a font Typeface associated with a particular resource ID.

This method will block the calling thread to retrieve the requested font, including if it is from a font provider. If you wish to not have this behavior, use getFont instead.

Prior to API level 23, font resources with more than one font in a family will only load the font closest to a regular weight typeface.

java-static fun getFont(
    context: Context,
    id: @FontRes Int,
    fontCallback: ResourcesCompat.FontCallback,
    handler: Handler?
): Unit

Returns a font Typeface associated with a particular resource ID asynchronously.

Prior to API level 23, font resources with more than one font in a family will only load the font closest to a regular weight typeface.