Drawable Resources Part III（Drawable 资源 第三部分）

Clip Drawable

一个定义在XML中的Drawable对象，根据当前的level值来得到一个Drawable的截取片段。你可以通过level值来控制控制得到的Drawable的宽和高，也可以指定Drawable在容器中的gravity属性。该类Drawable通常用于进度条的实现。

• 文件路径：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 > 定义了Clip Drawable，必须作为根节点存在。

属性：
- xmlns:android
String类型. 定义了 XML 的命名空间，必须为”http://schemas.android.com/apk/res/android“。

• android:drawable
  Drawable资源，必须，指向一个待裁剪的drawable。

• android:clipOrientation
  关键属性，指定了Drawable的裁剪方向。
  必须为下面的值之一：

值	属性
horizontal	横向裁剪Drawable
vertical	纵向裁剪Drawable

• android:gravity
  关键属性，指定了从哪里开始裁剪Drawable。
  必须为下面的一个或者多个（使用|分隔）属性：

值	属性
top	把对象置于容器顶部，不改变其大小。当clipOrientation值为”vertical”时，从底部开始裁剪
bottom	把对象置于容器底部，不改变其大小。当clipOrientation值为”vertical”时，从顶部开始裁剪
left	把对象置于容器左侧，不改变其大小。当clipOrientation值为”horizontal”时，从右侧开始裁剪，默认值。
right	把对象置于容器左侧，不改变其大小。当clipOrientation值为”horizontal”时，从左侧开始裁剪。
center_vertical	把对象置于容器垂直居中方向，不改变其大小。裁剪方式同 “center” 的相同
fill_vertical	如果有需要的话，充满容器的垂直方向，当clipOrientation值为”vertical”时，不会有裁剪发生，因为Drawable已经充满了垂直方向（除非level值为0，此时为不可见状态。）
center_horizontal	把对象置于容器水平居中方向，不改变其大小。裁剪方式同 “center” 的相同
fill_horizontal	如果有需要的话，充满容器的水平方向，当clipOrientation值为”horizontal”时，不会有裁剪发生，因为Drawable已经充满了水平方向（除非level值为0，此时为不可见状态。）
center	把对象置于容器的居中位置，不改变其大小，当clipOrientation值为”horizontal”时，从左至右裁剪，当clipOrientation值为”vertical”时，从上至下裁剪。
fill	如果有需要的话，充满整个容器。不会有裁剪发生，因为Drawable已经充满了整个容器（除非level值为0，此时为不可见状态。）
clip_vertical	附加选项，裁剪子元素的上边界和/或下边界到容器的边界。此时裁剪基于vertical gravity：顶部的gravity裁剪底部边界，底部的gravity裁剪顶部边界，两者都不存在的两侧同时裁剪。
clip_horizontal	附加选项，裁剪子元素的左边界和/或右边界到容器的边界。此时裁剪基于horizontal gravity：左侧的gravity裁剪右边界，右侧的gravity裁剪左边界，两者都不存在的两侧同时裁剪。

示例：
该文件保存在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" />

下面展示如何把定义的drawable用于一个View

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

下面的代码会增加图片的裁剪宽度：

ImageView imageview = (ImageView) findViewById(R.id.image);
ClipDrawable drawable = (ClipDrawable) imageview.getDrawable();
drawable.setLevel(drawable.getLevel() + 1000);

增加level的值会增加裁剪量而使得图片慢慢展示出来，下面是7000时的样子：

说明：默认level是0，这是完全裁剪，图像是不可见的。当level为10000时，图像不会被裁剪，完全可见。

也可以参考：

• ClipDrawable

---

Scale Drawable

一个定义在XML中的Drawable对象，根据当前的level值来得到一个改变大小的Drawable。

• 文件路径：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 > 定义了Scale Drawable，必须作为根节点存在。

属性：
- xmlns:android
String类型. 定义了 XML 的命名空间，必须为”http://schemas.android.com/apk/res/android“。

• android:drawable
  Drawable资源，必须，指向一个待裁剪的drawable。

• android:scaleGravity
  关键属性，指定了Drawable的缩放之后的位置。
  必须为下面的一个或者多个（使用|分隔）属性：

值	属性
top	把对象置于容器顶部，不改变其大小。
bottom	把对象置于容器底部，不改变其大小。
left	把对象置于容器左侧，不改变其大小。默认值。
right	把对象置于容器左侧，不改变其大小。
center_vertical	把对象置于容器垂直居中方向，不改变其大小
fill_vertical	如果有需要的话，充满容器的垂直方向。
center_horizontal	把对象置于容器水平居中方向，不改变其大小。
fill_horizontal	如果有需要的话，充满容器的水平方向。
center	把对象置于容器的居中位置，不改变其大小。
fill	如果有需要的话，充满整个容器。
clip_vertical	附加选项，裁剪子元素的上边界和/或下边界到容器的边界。此时裁剪基于vertical gravity：顶部的gravity裁剪底部边界，底部的gravity裁剪顶部边界，两者都不存在的两侧同时裁剪。
clip_horizontal	附加选项，裁剪子元素的左边界和/或右边界到容器的边界。此时裁剪基于horizontal gravity：左侧的gravity裁剪右边界，右侧的gravity裁剪左边界，两者都不存在的两侧同时裁剪。

• 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

---

Shape Drawable

一个定义在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="integer"
        android:centerY="integer"
        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 > 定义了Shape Drawable，必须作为根节点存在。

属性：

• xmlns:android
  String类型. 定义了 XML 的命名空间，必须为”http://schemas.android.com/apk/res/android“。

• android:shape
  关键属性。定义了形状的类型，可以使用的属性有：

值	属性
rectangle	充满View的矩形。这是默认的形状。
oval	同View尺寸相适应的椭圆。
line	同容器水平方向相同的线，需要通过< stroke >元素来指定线的宽度
ring	圆形。

下面的属性只用于 android:shape=”ring”时：

• android:innerRadius
  Dimension类型。 内圆的半径大小。

• android:innerRadiusRatio
  Float类型。 内圆半径大小比。例如, 如果android:innerRadiusRatio=”5”, 那么内圆半径等于外圆的宽度除以5。该属性被android:innerRadius重写。 默认值是9。

• android:thickness
  Dimension类型. 圆的线宽。

• android:thicknessRatio
  Float类型。 圆的线宽比。例如，如果android:thicknessRatio=”2”, 那么线宽等于外圆的宽度除以2. 该属性被android:innerRadius重写。默认值是3。

• android:useLevel
  Boolean类型。 “true”表示作为一个LevelListDrawable来使用。该值通常为flase，否则你的形状可能无法显示。

< corners >

添加圆角边，只适用于长方形。

属性：

• android:radius
  Dimension类型。所有方向的边角的半径，重写了以下4个角的属性。

• android:topLeftRadius
  Dimension类型。左上方角的半径。

• android:topRightRadius
  Dimension类型。右上方角的半径。

• android:bottomLeftRadius
  Dimension类型。左下方角的半径。

• android:bottomRightRadius
  Dimension类型。右下方角的半径。

备注：每个角的半径（最初）应大于1，或者不指定该属性。如果你想指定不规则的圆角形状，一个解决方法是指定一个默认角的半径大于1，然后为每一个你想指定的角指定半径，对于不想要圆角的边，指定为0（0dp）。

< gradient >

对形状指定一个色值梯度。

属性：

• android:angle
  Integer类型。色彩渐变的角度，0表示从左至右, 90表示从下至上。必须为45的倍数。默认值为0。

• android:centerX
  Float类型。相对中点的渐变点x坐标(0 - 1.0)。

• android:centerY
  Float类型。相对中点的渐变点y坐标(0 - 1.0)。

• android:centerColor
  Color类型。开始和结束之间的可选颜色，一个十六进制的值或颜色的资源。

• android:endColor
  Color类型。结束颜色,一个十六进制的值或颜色的资源。

• android:gradientRadius
  Float类型.。颜色梯度的半径，只适用于android:type=”radial”。

• android:startColor
  Color类型。开始颜色,一个十六进制的值或颜色的资源。

• android:type
  关键属性。 梯度模式应用的类型。有效值为：

值	属性
linear	线性梯度。默认值。
radial	径向梯度。开始颜色为中心颜色。
sweep	扫线梯度。

• android:useLevel
  Boolean类型。”true”表示作为一个LevelListDrawable来使用。

< padding >

属性：

指定容器内的padding值（在容器内的padding值，而非Shape Drawable本身的）。

• android:left
  Dimension类型。 左padding，dimension值或者dimension资源。

• android:top
  Dimension类型。 上padding，dimension值或者dimension资源。

• android:right
  Dimension类型。 右padding，dimension值或者dimension资源。

• android:bottom
  Dimension类型。 下padding，dimension值或者dimension资源。

< size >

形状的大小。

属性：

• android:height
  Dimension类型。 形状的高度，dimension值或者dimension资源。

• android:width
  Dimension类型。 形状的宽度，dimension值或者dimension资源。

说明：默认情况下，会按照定义的数值来缩放自身以同容器大小相适配。当你在ImageView中使用shape时，可以通过指定android:scaleType为”center”来限制缩放。

< solid >

形状的填充色

属性：

• android:color
  Color类型。用于形状的填充颜色，一个十六进制的值或颜色的资源。

< stroke >

形状的边缘线

属性：

• android:width
  Dimension类型。线的宽度，dimension值或者dimension资源。

• android:color
  Color类型。线的颜色，一个十六进制的值或颜色的资源。

• android:dashGap
  Dimension类型。虚线之间的距离，只有当设置了android:dashWidth时有效，dimension值或者dimension资源。

• android:dashWidth
  Dimension类型。虚线的长度，只有当设置了android:dashGap时有效，dimension值或者dimension资源。

示例：
该文件保存在res/drawable/gradient_box.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>

下面展示如何把定义的drawable用于一个View

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

下面的系统代码得到了一个shape drawable并将其用于一个view

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

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

也可以参考：

• ShapeDrawable