可绘制资源

可绘制资源是屏幕上可绘制图形的通用概念，您可以使用诸如 getDrawable(int) 之类的 API 检索它，或使用诸如 android:drawable 和 android:icon 之类的属性将其应用于其他 XML 资源。有几种类型的可绘制资源

位图文件
: 位图图形文件（PNG、WEBP、JPG 或 GIF）。创建 BitmapDrawable。
九宫格文件: 一个具有可拉伸区域的 PNG 文件，允许图像根据内容调整大小（.9.png）。创建 NinePatchDrawable。
图层列表: 管理其他可绘制资源数组的可绘制资源。这些可绘制资源按数组顺序绘制，因此索引最大的元素绘制在最上面。创建 LayerDrawable。
状态列表: 一个 XML 文件，它为不同的状态引用不同的位图图形——例如，在点击按钮时使用不同的图像。创建 StateListDrawable。
级别列表: 一个 XML 文件，它定义一个可绘制资源，该可绘制资源管理多个备用可绘制资源，每个可绘制资源都分配一个最大数值。创建 LevelListDrawable。
过渡可绘制资源: 一个 XML 文件，它定义一个可绘制资源，该可绘制资源可以在两个可绘制资源之间交叉淡入淡出。创建 TransitionDrawable。
内嵌可绘制资源: 一个 XML 文件，它定义一个可绘制资源，该可绘制资源通过指定距离将另一个可绘制资源内嵌。当视图需要一个比视图实际边界小的背景可绘制资源时，这很有用。
剪辑可绘制资源: 一个 XML 文件，它定义一个可绘制资源，该可绘制资源根据此可绘制资源的当前级别值剪辑另一个可绘制资源。创建 ClipDrawable。
缩放可绘制资源: 一个 XML 文件，它定义一个可绘制资源，该可绘制资源根据其当前级别值更改另一个可绘制资源的大小。创建 ScaleDrawable
形状可绘制资源.: 一个 XML 文件，它定义一个几何形状，包括颜色和渐变。创建 GradientDrawable。

有关如何创建 AnimationDrawable 的信息，请参阅动画资源文档。

注意：颜色资源也可用作 XML 中的可绘制资源。例如，在创建状态列表可绘制资源时，您可以为 android:drawable 属性引用颜色资源（android:drawable="@color/green"）。

位图

位图图像。Android 支持以下格式的位图文件：PNG（首选）、WEBP（首选，需要 API 级别 17 或更高版本）、JPG（可接受）、GIF（不推荐）。

您可以直接引用位图文件，使用文件名作为资源 ID，或在 XML 中创建别名资源 ID。

注意：在构建过程中，aapt 工具可能会使用无损图像压缩自动优化位图文件。例如，不需要超过 256 种颜色的真彩色 PNG 可能会转换为具有调色板的 8 位 PNG。这会导致质量相同的图像，但需要更少的内存。

因此，请注意，此目录中放置的图像二进制文件在构建过程中可能会发生更改。如果您计划将图像作为位流读取以将其转换为位图，请将您的图像放在 res/raw/ 文件夹中，因为它们不会被优化。

位图文件

位图文件是 PNG、WEBP、JPG 或 GIF 文件。当您将这些文件保存在 res/drawable/ 目录中时，Android 会为任何这些文件创建 Drawable 资源。

文件位置

res/drawable/filename.png (.png, .webp, .jpg 或 .gif)
文件名即资源 ID

编译后的资源数据类型

指向 BitmapDrawable 的资源指针

资源引用

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable/filename

示例

如果图像保存在 res/drawable/myimage.png 中，则此布局 XML 会将图像应用于视图

<ImageView
    android:layout_height="wrap_content"
    android:layout_width="wrap_content"
    android:src="@drawable/myimage" />

以下应用程序代码将图像检索为 Drawable

Kotlin

val drawable: Drawable? = ResourcesCompat.getDrawable(resources, R.drawable.myimage, null)

Java

Resources res = getResources();
Drawable drawable = ResourcesCompat.getDrawable(res, R.drawable.myimage, null);

另请参阅

XML 位图

XML 位图是在 XML 中定义的资源，它指向位图文件。其效果等同于原始位图文件的别名。XML 可以为位图指定其他属性，例如抖动和平铺。

注意：您可以使用 <bitmap> 元素作为 <item> 元素的子元素。例如，在创建状态列表或图层列表时，您可以从 <item> 元素中排除 android:drawable 属性，并在其中嵌套一个定义可绘制项的 <bitmap>。

文件位置

res/drawable/filename.xml
文件名即资源 ID

编译后的资源数据类型

指向 BitmapDrawable 的资源指针

资源引用

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable/filename

语法

<?xml version="1.0" encoding="utf-8"?>
<bitmap
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@[package:]drawable/drawable_resource"
    android:antialias=["true" | "false"]
    android:dither=["true" | "false"]
    android:filter=["true" | "false"]
    android:gravity=["top" | "bottom" | "left" | "right" | "center_vertical" |
                      "fill_vertical" | "center_horizontal" | "fill_horizontal" |
                      "center" | "fill" | "clip_vertical" | "clip_horizontal"]
    android:mipMap=["true" | "false"]
    android:tileMode=["disabled" | "clamp" | "repeat" | "mirror"] />

元素

<bitmap>

必需。定义位图源及其属性。

属性

xmlns:android

字符串。定义 XML 命名空间，它必须为 "http://schemas.android.com/apk/res/android"。仅当 <bitmap> 是根元素时，此属性才必需。当 <bitmap> 嵌套在 <item> 中时，则不需要此属性。

android:src

可绘制资源。必需。可绘制资源的引用。

android:antialias

布尔值。启用或禁用抗锯齿。

android:dither

布尔值。如果位图与屏幕的像素配置不同（例如，在 RGB 565 屏幕上使用 ARGB 8888 位图），则启用或禁用位图的抖动。

android:filter

布尔值。启用或禁用位图过滤。当位图缩小或拉伸以使其外观平滑时，将使用过滤。

android:gravity

关键字。定义位图的重力。如果位图小于容器，则重力指示在容器中放置可绘制对象的位置。

必须是以下常量值之一或多个，以 | 分隔

值	描述
`top`	将对象置于其容器的顶部，而不更改其大小。
`bottom`	将对象置于其容器的底部，而不更改其大小。
`left`	将对象置于其容器的左边缘，而不更改其大小。
`right`	将对象置于其容器的右边缘，而不更改其大小。
`center_vertical`	将对象置于其容器的垂直中心，而不更改其大小。
`fill_vertical`	如果需要，增加对象的高度，使其完全填充其容器。
`center_horizontal`	将对象置于其容器的水平中心，而不更改其大小。
`fill_horizontal`	如果需要，增加对象的宽度，使其完全填充其容器。
`center`	将对象置于其容器的垂直和水平轴的中心，而不更改其大小。
`fill`	如果需要，增加对象的高度和宽度，使其完全填充其容器。这是默认值。
`clip_vertical`	可以设置的其他选项，用于使子元素的顶部和/或底部边缘裁剪到其容器的边界。裁剪基于垂直重力：顶部重力裁剪底部边缘，底部重力裁剪顶部边缘，两者都不裁剪两个边缘。
`clip_horizontal`	可以设置的其他选项，用于使子元素的左侧和/或右侧边缘裁剪到其容器的边界。裁剪基于水平重力：左侧重力裁剪右侧边缘，右侧重力裁剪左侧边缘，两者都不裁剪两个边缘。

android:mipMap

布尔值。启用或禁用 mipmap 提示。有关详细信息，请参阅 setHasMipMap()。默认值为 false。

android:tileMode

关键字。定义平铺模式。启用平铺模式时，位图将重复。启用平铺模式时，将忽略重力。

必须是以下常量值之一

值	描述
`disabled`	不平铺位图。这是默认值。
`clamp`	如果着色器绘制在其原始边界之外，则复制边缘颜色
`repeat`	水平和垂直重复着色器的图像。
`mirror`	水平和垂直重复着色器的图像，交替镜像，以便相邻图像始终接缝。

示例

<?xml version="1.0" encoding="utf-8"?>
<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@drawable/icon"
    android:tileMode="repeat" />

另请参阅

九宫格

NinePatch 是一种 PNG 图像，您可以在其中定义可伸缩区域，Android 会在视图中的内容超出正常图像边界时缩放这些区域。通常将此类型的图像分配给至少有一个维度设置为 "wrap_content" 的视图的背景。

当视图增长以适应内容时，九宫格图像也会缩放以匹配视图的大小。九宫格图像的一个示例用法是 Android 标准 Button 组件使用的背景，该背景必须伸展以适应按钮内的文本（或图像）。

与普通位图一样，您可以直接引用九宫格文件或从 XML 定义的资源中引用。

有关如何使用可伸缩区域创建九宫格文件的完整讨论，请参阅创建可调整大小的位图（9 宫格文件）。

九宫格文件

文件位置

res/drawable/filename.9.png
文件名即资源 ID

编译后的资源数据类型

指向 NinePatchDrawable 的资源指针

资源引用

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable/filename

示例

如果图像保存在 res/drawable/myninepatch.9.png 中，则此布局 XML 会将九宫格应用于视图

<Button
    android:layout_height="wrap_content"
    android:layout_width="wrap_content"
    android:background="@drawable/myninepatch" />

另请参阅

XML 九宫格

XML 九宫格是在 XML 中定义的资源，它指向九宫格文件。XML 可以为图像指定抖动。

文件位置

res/drawable/filename.xml
文件名即资源 ID

编译后的资源数据类型

指向 NinePatchDrawable 的资源指针

资源引用

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable/filename

语法

<?xml version="1.0" encoding="utf-8"?>
<nine-patch
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@[package:]drawable/drawable_resource"
    android:dither=["true" | "false"] />

元素

示例

<?xml version="1.0" encoding="utf-8"?>
<nine-patch xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@drawable/myninepatch"
    android:dither="false" />

图层列表

LayerDrawable 是一种可绘制对象，它管理其他可绘制对象的数组。列表中的每个可绘制对象都按列表的顺序绘制。列表中的最后一个可绘制对象绘制在最上面。

每个可绘制对象都由单个 <layer-list> 元素内的 <item> 元素表示。

文件位置

res/drawable/filename.xml
文件名即资源 ID

编译后的资源数据类型

指向 LayerDrawable 的资源指针

资源引用

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable/filename

语法

<?xml version="1.0" encoding="utf-8"?>
<layer-list
    xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:drawable="@[package:]drawable/drawable_resource"
        android:id="@[+][package:]id/resource_name"
        android:top="dimension"
        android:right="dimension"
        android:bottom="dimension"
        android:left="dimension" />
</layer-list>

元素

示例

保存在 res/drawable/layers.xml 中的 XML 文件

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item>
      <bitmap android:src="@drawable/android_red"
        android:gravity="center" />
    </item>
    <item android:top="10dp" android:left="10dp">
      <bitmap android:src="@drawable/android_green"
        android:gravity="center" />
    </item>
    <item android:top="20dp" android:left="20dp">
      <bitmap android:src="@drawable/android_blue"
        android:gravity="center" />
    </item>
</layer-list>

此示例使用嵌套的 <bitmap> 元素来定义每个项的可绘制资源，并使用 "center" 重力。这可确保由于偏移图像导致调整大小而不会缩放任何图像以适应容器的大小。

此布局 XML 会将可绘制对象应用于视图

<ImageView
    android:layout_height="wrap_content"
    android:layout_width="wrap_content"
    android:src="@drawable/layers" />

结果是一堆偏移量逐渐增大的图像

另请参阅

LayerDrawable

状态列表

StateListDrawable 是一种在 XML 中定义的可绘制对象，它使用多个图像来表示相同的图形，具体取决于对象的状态。例如，Button 组件的状态可以是已点击、已获得焦点或两者都不是；使用状态列表可绘制对象，您可以为每种状态提供不同的背景图像。

您可以在 XML 文件中描述状态列表。每个图形都由单个 <selector> 元素内的 <item> 元素表示。每个 <item> 使用各种属性来描述将其用作可绘制对象图形的状态。

在每次状态更改期间，都会从上到下遍历状态列表，并使用与当前状态匹配的第一个项目。选择**不是**基于“最佳匹配”，而是基于满足状态最小标准的第一个项目。

文件位置

res/drawable/filename.xml
文件名即资源 ID

编译后的资源数据类型

指向StateListDrawable的资源指针

资源引用

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable/filename

语法

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android"
    android:constantSize=["true" | "false"]
    android:dither=["true" | "false"]
    android:variablePadding=["true" | "false"] >
    <item
        android:drawable="@[package:]drawable/drawable_resource"
        android:state_pressed=["true" | "false"]
        android:state_focused=["true" | "false"]
        android:state_hovered=["true" | "false"]
        android:state_selected=["true" | "false"]
        android:state_checkable=["true" | "false"]
        android:state_checked=["true" | "false"]
        android:state_enabled=["true" | "false"]
        android:state_activated=["true" | "false"]
        android:state_window_focused=["true" | "false"] />
</selector>

元素

<selector>

必需。这必须是根元素。包含一个或多个 <item> 元素。

属性

xmlns:android: 字符串。必需。定义 XML 命名空间，它必须为 "http://schemas.android.com/apk/res/android"。
android:constantSize: 布尔值。如果可绘制对象的报告内部大小在状态更改时保持不变（大小为所有状态的最大值），则为真；如果大小根据当前状态而变化，则为假。默认为 false。
android:dither: 布尔值。如果位图的像素配置与屏幕不同（例如，RGB 565 屏幕上的 ARGB 8888 位图），则为真以启用位图的抖动；为假以禁用抖动。默认为 true。
android:variablePadding: 布尔值。如果可绘制对象的填充根据所选的当前状态而变化，则为真；如果填充必须保持不变，则为假，基于所有状态的最大填充。启用此功能要求您处理状态更改时的执行布局，这通常不受支持。默认为 false。

<item>

根据其属性定义在某些状态下使用的可绘制对象。必须是<selector>元素的子元素。

属性

android:drawable: 可绘制资源。必需。可绘制资源的引用。
android:state_pressed: 布尔值。如果在点击对象时使用此项目，例如当触摸按钮时，则为真；如果在默认的非点击状态下使用此项目，则为假。
android:state_focused: 布尔值。如果在对象具有输入焦点时使用此项目，例如当用户选择文本输入时，则为真；如果在默认的非焦点状态下使用此项目，则为假。
android:state_hovered: 布尔值。如果在光标悬停在对象上时使用此项目，则为真；如果在默认的非悬停状态下使用此项目，则为假。通常，此可绘制对象可以与“focused”状态使用的可绘制对象相同。
在 API 级别 14 中引入。
android:state_selected: 布尔值。如果在对象是使用方向控制导航时的当前用户选择时使用此项目，例如当使用方向键导航列表时，则为真；如果在对象未被选中时使用此项目，则为假。
当android:state_focused不足时，例如当列表视图具有焦点并且其中的某个项目使用方向键被选中时，将使用选定状态。
android:state_checkable: 布尔值。如果在对象可选择时使用此项目，则为真；如果在对象不可选择时使用此项目，则为假。仅当对象可以在可选择和小部件之间转换时才有用。
android:state_checked: 布尔值。如果在对象被选中时使用此项目，则为真；如果在对象未被选中时使用此项目，则为假。
android:state_enabled: 布尔值。如果在对象启用时使用此项目，这意味着能够接收触摸或点击事件，则为真；如果在对象禁用时使用此项目，则为假。
android:state_activated: 布尔值。如果在对象被激活为持久选择时使用此项目，例如在持久导航视图中“突出显示”先前选择的列表项，则为真；如果在对象未被激活时使用此项目，则为假。
在 API 级别 11 中引入。
android:state_window_focused: 布尔值。如果在应用程序窗口具有焦点时使用此项目，这意味着应用程序位于前台，则为真；如果在应用程序窗口没有焦点时使用此项目，例如，如果下拉通知栏或出现对话框，则为假。

注意：Android 应用状态列表中与对象当前状态匹配的第一个项目。因此，如果列表中的第一个项目不包含任何前面的状态属性，则每次都会应用它。这就是为什么您希望始终将默认值放在最后，如下例所示。

示例

XML 文件保存在res/drawable/button.xml

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:state_pressed="true"
          android:drawable="@drawable/button_pressed" /> <!-- pressed -->
    <item android:state_focused="true"
          android:drawable="@drawable/button_focused" /> <!-- focused -->
    <item android:state_hovered="true"
          android:drawable="@drawable/button_focused" /> <!-- hovered -->
    <item android:drawable="@drawable/button_normal" /> <!-- default -->
</selector>

此布局 XML 将状态列表可绘制对象应用于按钮

<Button
    android:layout_height="wrap_content"
    android:layout_width="wrap_content"
    android:background="@drawable/button" />

另请参阅

StateListDrawable

级别列表

一个可绘制对象，它管理多个备用可绘制对象，每个对象都分配一个最大数值。使用setLevel()设置可绘制对象的级别值将加载级别列表中具有android:maxLevel值大于或等于传递给该方法的值的可绘制资源。

文件位置

res/drawable/filename.xml
文件名即资源 ID

编译后的资源数据类型

指向LevelListDrawable的资源指针

资源引用

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable/filename

语法

<?xml version="1.0" encoding="utf-8"?>
<level-list
    xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:drawable="@drawable/drawable_resource"
        android:maxLevel="integer"
        android:minLevel="integer" />
</level-list>

元素

示例

<?xml version="1.0" encoding="utf-8"?>
<level-list xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:drawable="@drawable/status_off"
        android:maxLevel="0" />
    <item
        android:drawable="@drawable/status_on"
        android:maxLevel="1" />
</level-list>

一旦将其应用于View，可以使用setLevel()或setImageLevel()更改级别。

另请参阅

LevelListDrawable

过渡可绘制资源

一个TransitionDrawable是一个可绘制对象，可以在两个其他可绘制资源之间交叉淡入淡出。

每个可绘制对象都由<item>元素在一个<transition>元素中表示。最多支持两个项目。要向前过渡，请调用startTransition()。要向后过渡，请调用reverseTransition()。

文件位置

res/drawable/filename.xml
文件名即资源 ID

编译后的资源数据类型

指向TransitionDrawable的资源指针

资源引用

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable/filename

语法

<?xml version="1.0" encoding="utf-8"?>
<transition
xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:drawable="@[package:]drawable/drawable_resource"
        android:id="@[+][package:]id/resource_name"
        android:top="dimension"
        android:right="dimension"
        android:bottom="dimension"
        android:left="dimension" />
</transition>

元素

示例

XML 文件保存在res/drawable/transition.xml

<?xml version="1.0" encoding="utf-8"?>
<transition xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:drawable="@drawable/on" />
    <item android:drawable="@drawable/off" />
</transition>

此布局 XML 会将可绘制对象应用于视图

<ImageButton
    android:id="@+id/button"
    android:layout_height="wrap_content"
    android:layout_width="wrap_content"
    android:src="@drawable/transition" />

以下代码执行从第一项到第二项的 500 毫秒过渡

Kotlin

val button: ImageButton = findViewById(R.id.button)
val drawable: Drawable = button.drawable
if (drawable is TransitionDrawable) {
    drawable.startTransition(500)
}

Java

ImageButton button = (ImageButton) findViewById(R.id.button);
Drawable drawable = button.getDrawable();
if (drawable instanceof TransitionDrawable) {
    ((TransitionDrawable) drawable).startTransition(500);
}

另请参阅

TransitionDrawable

内嵌可绘制资源

在 XML 中定义的可绘制对象，通过指定的距离内嵌另一个可绘制对象。当视图需要一个比视图实际边界小的背景时，这很有用。

文件位置

res/drawable/filename.xml
文件名即资源 ID

编译后的资源数据类型

指向InsetDrawable的资源指针

资源引用

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable/filename

语法

<?xml version="1.0" encoding="utf-8"?>
<inset
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/drawable_resource"
    android:insetTop="dimension"
    android:insetRight="dimension"
    android:insetBottom="dimension"
    android:insetLeft="dimension" />

元素

示例

<?xml version="1.0" encoding="utf-8"?>
<inset xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/background"
    android:insetTop="10dp"
    android:insetLeft="10dp" />

另请参阅

InsetDrawable

剪辑可绘制资源

在 XML 中定义的可绘制对象，根据此可绘制对象的当前级别裁剪另一个可绘制对象。您可以根据级别控制子可绘制对象在宽度和高度上裁剪的程度，以及控制它在其整体容器中放置位置的重力。最常用于实现进度条等内容。

文件位置

res/drawable/filename.xml
文件名即资源 ID

编译后的资源数据类型

指向ClipDrawable的资源指针

资源引用

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable/filename

语法

<?xml version="1.0" encoding="utf-8"?>
<clip
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/drawable_resource"
    android:clipOrientation=["horizontal" | "vertical"]
    android:gravity=["top" | "bottom" | "left" | "right" | "center_vertical" |
                     "fill_vertical" | "center_horizontal" | "fill_horizontal" |
                     "center" | "fill" | "clip_vertical" | "clip_horizontal"] />

元素

<clip>

**必需**。定义裁剪的可绘制对象。这必须是根元素。

属性

xmlns:android

字符串。必需。定义 XML 命名空间，它必须为 "http://schemas.android.com/apk/res/android"。

android:drawable

可绘制资源。**必需**。要裁剪的可绘制资源的引用。

android:clipOrientation

关键字。裁剪的方向。

必须是以下常量值之一

值	描述
`horizontal`	水平裁剪可绘制对象。
`vertical`	垂直裁剪可绘制对象。

android:gravity

关键字。指定在可绘制对象内裁剪的位置。

必须是以下常量值之一或多个，以 | 分隔

值	描述
`top`	将对象放在其容器的顶部，不改变其大小。当`clipOrientation`为`"vertical"`时，在可绘制对象的底部进行裁剪。
`bottom`	将对象放在其容器的底部，不改变其大小。当`clipOrientation`为`"vertical"`时，在可绘制对象的顶部进行裁剪。
`left`	将对象放在其容器的左边缘，不改变其大小。这是默认值。当`clipOrientation`为`"horizontal"`时，在可绘制对象的右侧进行裁剪。
`right`	将对象放在其容器的右边缘，不改变其大小。当`clipOrientation`为`"horizontal"`时，在可绘制对象的左侧进行裁剪。
`center_vertical`	将对象放在其容器的垂直中心，不改变其大小。裁剪行为与重力为`"center"`时相同。
`fill_vertical`	根据需要增加对象的高度，使其完全填充其容器。当`clipOrientation`为`"vertical"`时，不会发生裁剪，因为可绘制对象填充了垂直空间（除非可绘制对象的级别为 0，在这种情况下它不可见）。
`center_horizontal`	将对象放在其容器的水平中心，不改变其大小。裁剪行为与重力为`"center"`时相同。
`fill_horizontal`	根据需要增加对象的宽度，使其完全填充其容器。当`clipOrientation`为`"horizontal"`时，不会发生裁剪，因为可绘制对象填充了水平空间（除非可绘制对象的级别为 0，在这种情况下它不可见）。
`center`	将对象放在其容器的垂直和水平轴的中心，不改变其大小。当`clipOrientation`为`"horizontal"`时，在左侧和右侧进行裁剪。当`clipOrientation`为`"vertical"`时，在顶部和底部进行裁剪。
`fill`	根据需要增加对象的高度和宽度，使其完全填充其容器。不会发生裁剪，因为可绘制对象填充了水平和垂直空间（除非可绘制对象的级别为 0，在这种情况下它不可见）。
`clip_vertical`	可以设置的其他选项，用于使子元素的顶部和/或底部边缘裁剪到其容器的边界。裁剪基于垂直重力：顶部重力裁剪底部边缘，底部重力裁剪顶部边缘，两者都不裁剪两个边缘。
`clip_horizontal`	可以设置的其他选项，用于使子元素的左侧和/或右侧边缘裁剪到其容器的边界。裁剪基于水平重力：左侧重力裁剪右侧边缘，右侧重力裁剪左侧边缘，两者都不裁剪两个边缘。

示例

XML 文件保存在res/drawable/clip.xml

<?xml version="1.0" encoding="utf-8"?>
<clip xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/android"
    android:clipOrientation="horizontal"
    android:gravity="left" />

以下布局 XML 将裁剪的可绘制对象应用于视图

<ImageView
    android:id="@+id/image"
    android:src="@drawable/clip"
    android:layout_height="wrap_content"
    android:layout_width="wrap_content" />

以下代码获取可绘制对象并增加裁剪量以逐步显示图像

Kotlin

val imageview: ImageView = findViewById(R.id.image)
val drawable: Drawable = imageview.background
if (drawable is ClipDrawable) {
    drawable.level = drawable.level + 1000
}

Java

ImageView imageview = (ImageView) findViewById(R.id.image);
Drawable drawable = imageview.getBackground();
if (drawable instanceof ClipDrawable) {
    ((ClipDrawable)drawable).setLevel(drawable.getLevel() + 1000);
}

增加级别会减少裁剪量并缓慢显示图像。这里它的级别为 7000

注意：默认级别为 0，此时图像完全被裁剪，不可见。当级别为 10,000 时，图像不会被裁剪，完全可见。

另请参阅

ClipDrawable

缩放可绘制资源

在 XML 中定义的可绘制对象，它根据当前级别更改另一个可绘制对象的尺寸。

文件位置

res/drawable/filename.xml
文件名即资源 ID

编译后的资源数据类型

指向 ScaleDrawable 的资源指针

资源引用

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable/filename

语法

<?xml version="1.0" encoding="utf-8"?>
<scale
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/drawable_resource"
    android:scaleGravity=["top" | "bottom" | "left" | "right" | "center_vertical" |
                          "fill_vertical" | "center_horizontal" | "fill_horizontal" |
                          "center" | "fill" | "clip_vertical" | "clip_horizontal"]
    android:scaleHeight="percentage"
    android:scaleWidth="percentage" />

元素

<scale>

必需。定义缩放可绘制对象。这必须是根元素。

属性

xmlns:android

字符串。必需。定义 XML 命名空间，它必须为 "http://schemas.android.com/apk/res/android"。

android:drawable

可绘制资源。必需。可绘制资源的引用。

android:scaleGravity

关键字。指定缩放后的重力位置。

必须是以下常量值之一或多个，以 | 分隔

值	描述
`top`	将对象置于其容器的顶部，而不更改其大小。
`bottom`	将对象置于其容器的底部，而不更改其大小。
`left`	将对象置于其容器的左边缘，不改变其大小。这是默认值。
`right`	将对象置于其容器的右边缘，而不更改其大小。
`center_vertical`	将对象置于其容器的垂直中心，而不更改其大小。
`fill_vertical`	如果需要，增加对象的高度，使其完全填充其容器。
`center_horizontal`	将对象置于其容器的水平中心，不改变其大小。
`fill_horizontal`	如果需要，增加对象的宽度，使其完全填充其容器。
`center`	将对象置于其容器的垂直和水平轴的中心，而不更改其大小。
`fill`	根据需要增加对象的水平和垂直尺寸，使其完全填充其容器。
`clip_vertical`	可以设置的其他选项，用于使子元素的顶部和/或底部边缘裁剪到其容器的边界。裁剪基于垂直重力：顶部重力裁剪底部边缘，底部重力裁剪顶部边缘，两者都不裁剪两个边缘。
`clip_horizontal`	可以设置的其他选项，用于使子元素的左侧和/或右侧边缘裁剪到其容器的边界。裁剪基于水平重力：左侧重力裁剪右侧边缘，右侧重力裁剪左侧边缘，两者都不裁剪两个边缘。

android:scaleHeight

百分比。缩放高度，表示为可绘制对象边界的百分比。值的格式为 XX%，例如 100% 或 12.5%。

android:scaleWidth

百分比。缩放宽度，表示为可绘制对象边界的百分比。值的格式为 XX%，例如 100% 或 12.5%。

示例

<?xml version="1.0" encoding="utf-8"?>
<scale xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/logo"
    android:scaleGravity="center_vertical|center_horizontal"
    android:scaleHeight="80%"
    android:scaleWidth="80%" />

另请参阅

ScaleDrawable

形状可绘制资源

这是在 XML 中定义的通用形状。

文件位置

res/drawable/filename.xml
文件名即资源 ID

编译后的资源数据类型

指向 GradientDrawable 的资源指针

资源引用

在 Java 中：R.drawable.filename
在 XML 中：@[package:]drawable/filename

语法

<?xml version="1.0" encoding="utf-8"?>
<shape
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape=["rectangle" | "oval" | "line" | "ring"] >
    <corners
        android:radius="integer"
        android:topLeftRadius="integer"
        android:topRightRadius="integer"
        android:bottomLeftRadius="integer"
        android:bottomRightRadius="integer" />
    <gradient
        android:angle="integer"
        android:centerX="float"
        android:centerY="float"
        android:centerColor="integer"
        android:endColor="color"
        android:gradientRadius="integer"
        android:startColor="color"
        android:type=["linear" | "radial" | "sweep"]
        android:useLevel=["true" | "false"] />
    <padding
        android:left="integer"
        android:top="integer"
        android:right="integer"
        android:bottom="integer" />
    <size
        android:width="integer"
        android:height="integer" />
    <solid
        android:color="color" />
    <stroke
        android:width="integer"
        android:color="color"
        android:dashWidth="integer"
        android:dashGap="integer" />
</shape>

元素

<shape>

必需。形状可绘制对象。这必须是根元素。

属性

xmlns:android

字符串。必需。定义 XML 命名空间，它必须为 "http://schemas.android.com/apk/res/android"。

android:shape

关键字。定义形状的类型。有效值为

值	描述
`"rectangle"`	填充包含视图的矩形。这是默认形状。
`"oval"`	适合包含视图尺寸的椭圆形。
`"line"`	跨越包含视图宽度的水平线。此形状需要 `<stroke>` 元素来定义线的宽度。
`"ring"`	环形。

仅当 android:shape="ring" 时才使用以下属性

android:innerRadius: 尺寸。环形内侧半径（中间的孔），作为尺寸值或尺寸资源。
android:innerRadiusRatio: 浮点数。环形内侧半径，表示为环形宽度的比率。例如，如果 android:innerRadiusRatio="5"，则内侧半径等于环形宽度除以 5。此值会被 android:innerRadius 覆盖。默认值为 9。
android:thickness: 尺寸。环形的厚度，作为尺寸值或尺寸资源。
android:thicknessRatio: 浮点数。环形的厚度，表示为环形宽度的比率。例如，如果 android:thicknessRatio="2"，则厚度等于环形宽度除以 2。此值会被 android:innerRadius 覆盖。默认值为 3。
android:useLevel: 布尔值。如果用作 LevelListDrawable，则为 true。通常为 false，否则您的形状可能不会显示。

<corners>

为形状创建圆角。仅当形状为矩形时才适用。

属性

android:radius: 尺寸。所有角的半径，作为尺寸值或尺寸资源。以下属性会覆盖每个角的半径。
android:topLeftRadius: 尺寸。左上角的半径，作为尺寸值或尺寸资源。
android:topRightRadius: 尺寸。右上角的半径，作为尺寸值或尺寸资源。
android:bottomLeftRadius: 尺寸。左下角的半径，作为尺寸值或尺寸资源。
android:bottomRightRadius: 尺寸。右下角的半径，作为尺寸值或尺寸资源。

注意：每个角最初都必须提供大于 1 的角半径，否则不会圆角。如果您希望特定角不圆角，则可以使用 android:radius 设置大于 1 的默认角半径，然后使用您真正需要的数值覆盖每个角，在您不希望圆角的地方提供 0 (“0dp”)。

<gradient>

指定形状的渐变颜色。

属性

android:angle

整数。渐变的角度，以度为单位。0 为从左到右，90 为从下到上。它必须是 45 的倍数。默认值为 0。

android:centerX

浮点数。渐变中心的相对 X 位置 (0 - 1.0)。

android:centerY

浮点数。渐变中心的相对 Y 位置 (0 - 1.0)。

android:centerColor

颜色。可选颜色，位于起始颜色和结束颜色之间，作为十六进制值或颜色资源。

android:endColor

颜色。结束颜色，作为十六进制值或颜色资源。

android:gradientRadius

浮点数。渐变的半径。仅当 android:type="radial" 时才应用。

android:startColor

颜色。起始颜色，作为十六进制值或颜色资源。

android:type

关键字。要应用的渐变模式类型。有效值为

值	描述
`"linear"`	线性渐变。这是默认值。
`"radial"`	径向渐变。起始颜色是中心颜色。
`"sweep"`	扫描线渐变。

android:useLevel

布尔值。如果用作 LevelListDrawable，则为 true。

<padding>

要应用于包含视图元素的填充。这会填充视图内容的位置，而不是形状。

属性

android:left: 尺寸。左侧填充，作为尺寸值或尺寸资源。
android:top: 尺寸。顶部填充，作为尺寸值或尺寸资源。
android:right: 尺寸。右侧填充，作为尺寸值或尺寸资源。
android:bottom: 尺寸。底部填充，作为尺寸值或尺寸资源。

<size>

形状的大小。

属性

android:height: 尺寸。形状的高度，作为尺寸值或尺寸资源。
android:width: 尺寸。形状的宽度，作为尺寸值或尺寸资源。

注意：默认情况下，形状会根据此处定义的尺寸按比例缩放以适应容器视图的大小。当您在 ImageView 中使用形状时，可以通过将 android:scaleType 设置为 "center" 来限制缩放。

<solid>

填充形状的纯色。

属性

android:color: 颜色。要应用于形状的颜色，作为十六进制值或颜色资源。

<stroke>

形状的描边线。

属性

android:width: 尺寸。线的厚度，作为尺寸值或尺寸资源。
android:color: 颜色。线的颜色，作为十六进制值或颜色资源。
android:dashGap: 尺寸。线虚线之间的距离，作为尺寸值或尺寸资源。仅当设置了 android:dashWidth 时才有效。
android:dashWidth: 尺寸。每个虚线的尺寸，作为尺寸值或尺寸资源。仅当设置了 android:dashGap 时才有效。

示例

保存在 res/drawable/gradient_box.xml 中的 XML 文件

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <gradient
        android:startColor="#FFFF0000"
        android:endColor="#80FF00FF"
        android:angle="45"/>
    <padding android:left="7dp"
        android:top="7dp"
        android:right="7dp"
        android:bottom="7dp" />
    <corners android:radius="8dp" />
</shape>

此布局 XML 将形状可绘制对象应用于视图

<TextView
    android:background="@drawable/gradient_box"
    android:layout_height="wrap_content"
    android:layout_width="wrap_content" />

此应用程序代码获取形状可绘制对象并将其应用于视图

Kotlin

val shape: Drawable? = getDrawable(resources, R.drawable.gradient_box, getTheme())

val tv: TextView = findViewById(R.id.textview)
tv.background = shape

Java

Resources res = getResources();
Drawable shape = ResourcesCompat.getDrawable(res, R.drawable.gradient_box, getTheme());

TextView tv = (TextView)findViewById(R.id.textview);
tv.setBackground(shape);

另请参阅

ShapeDrawable

颜色状态列表

布局