Android Drawable Resources系列10:<shape>

定义：这是一个通用的，可以自定义形状的xml。

用法：

<?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>形状，默认矩形。

属性	说明
android:shape	值："rectangle"(默认)：矩形；"oval"：椭圆形；"line"：线性形状；"ring"：环形。PS，此表以下属性仅当android:shape="ring"时使用。
android:innerRadius	shape为ring时，内环半径
android:innerRadiusRatio	浮点型，以环的宽度比率来表示内环的半径 例如，如果android:innerRadiusRatio=“5”，表示内环半径等于环的宽度除以5，这个值是可以被覆盖的，默认为9.
android:thickness	shape为ring时，环的厚度
android:thicknessRatio	浮点型，以环的宽度比率来表示环的厚度 例如，如果android:thicknessRatio="2"，那么环的厚度就等于环的宽度除以2。这个值是可以被android:thickness覆盖的，默认值是3.
android:useLevel	boolean值，如果当做是LevelListDrawable使用时值为true，否则为false.

<corners>圆角

属性	说明
android:radius	整型 半径
android:topLeftRadius	整型 左上角半径
android:topRightRadius	整型 右上角半径
android:bottomLeftRadius	整型 左下角半径
android:bottomRightRadius	整型 右下角半径

<gradient>渐变

属性	说明
android:angle	整型   渐变角度(PS：当angle=0时，渐变色是从左向右。 然后逆时针方向转，当angle=90时为从下往上。angle必须为45的整数倍)
android:centerX	整型   渐变中心X点坐标的相对位置
android:centerY	整型   渐变中心Y点坐标的相对位置
android:centerColor	整型   渐变中间颜色，即开始颜色与结束颜色之间的颜色
android:endColor	颜色值 结束颜色
android:gradientRadius	整型 渐变色半径.当 android:type="radial" 时才使用。单独使用 android:type="radial"会报错。
android:startColor	颜色值 起始颜色
android:type	linear 线性渐变，这是默认设置 radial 放射性渐变，以开始色为中心。 sweep 扫描线式的渐变。
android:useLevel	["true" | "false"] 如果要使用LevelListDrawable对象，就要设置为true。设置为true无渐变。false有渐变色

<solid>内部填充

属性	说明
android:color	颜色值 填充颜色

<stroke>描边

属性	说明
android:width	整型 描边的宽度
android:color	颜色值 描边的颜色
android:dashGap	整型 表示描边为虚线时，虚线之间的间隔 即“ - - - - ”。
android:dashWidth	整型 表示描边的样式是虚线的宽度， 值为0时，表示为实线。值大于0则为虚线。

官方文档：

XML file saved at 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>
This layout XML applies the shape drawable to a View:

<TextView
    android:background="@drawable/gradient_box"
    android:layout_height="wrap_content"
    android:layout_width="wrap_content" />
This application code gets the shape drawable and applies it to a View:

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

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

效果：

resource_drawable_shape_rectangle.xml

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

</shape>

resource_drawable_shape_oval.xml

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="oval">
    <gradient
        android:angle="45"
        android:endColor="@color/yellow"
        android:startColor="@color/red" />

    <stroke android:color="@color/green"
        android:width="5dp"
        android:dashWidth="1dp"
        android:dashGap="1dp"/>
</shape>

resource_drawable_shape_line.xml

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="line">

    <stroke android:width="2dp" android:color="@color/blue"/>
    <size android:height="5dp" />
</shape>

resource_drawable_shape_ring.xml

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:innerRadius="50dp"
    android:shape="ring"
    android:thickness="10dp"
    android:useLevel="false">
    <solid android:color="@color/red" />
</shape>

效果：