Shape Drawable Resources

1，示例

它们的代码如下：

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:endColor="#fa1621"
         android:gradientRadius="50"
         android:startColor="#f793ac"
         android:type="sweep"/>
     <size
         android:width="72dp"
         android:height="72dp"/>
     <!--<solid android:color="#e3e3e3"/>-->
 </shape>

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:endColor="#fa1621"
         android:gradientRadius="50"
         android:startColor="#f793ac"
         android:type="radial"/>
     <corners
         android:bottomLeftRadius="5dp"
         android:bottomRightRadius="5dp"
         android:topLeftRadius="5dp"
         android:topRightRadius="5dp"/>
     <size android:width="72dp" android:height="72dp" />
 </shape>

shape_ring.xml

 <?xml version="1.0" encoding="utf-8"?>
 <shape xmlns:android="http://schemas.android.com/apk/res/android"
        android:shape="ring"
        android:thickness="2dp"
        android:innerRadius="30dp"
        android:useLevel="false">
     <!--<gradient-->
         <!--android:endColor="#fa1621"-->
         <!--android:gradientRadius="50"-->
         <!--android:startColor="#f793ac"-->
         <!--android:type="radial"/>-->
     <!--<padding-->
         <!--android:left="10dp"-->
         <!--android:top="10dp"-->
         <!--android:right="10dp"-->
         <!--android:bottom="10dp" />-->
     <stroke
         android:width="1dp"
         android:color="color"
         android:dashWidth="1dp"
         android:dashGap="1dp" />
     <solid android:color="#f8a17e" />
     <size android:width="72dp" android:height="72dp"/>
 </shape>

shape_line.xml

 <?xml version="1.0" encoding="utf-8"?>
 <shape xmlns:android="http://schemas.android.com/apk/res/android"
        android:shape="line" >
     <!-- 显示一条虚线，破折线的宽度为 dashWith，破折线之间的空隙的宽度为 dashGap，当 dashGap=0dp 时，为实线 -->
     <stroke
         android:dashGap="3dp"
         android:dashWidth="2dp"
         android:width="1dp"
         android:color="#777777" />

     <!-- 虚线的高度 -->
     <size android:height="2dp" />
 </shape>

ring_circle.xml

 <?xml version="1.0" encoding="utf-8"?>
 <shape xmlns:android="http://schemas.android.com/apk/res/android"
     android:shape="ring"
     android:innerRadiusRatio="5555"
     android:thicknessRatio="2"
     android:useLevel="false">
     <!--android:innerRadiusRatio="5555"含义：按比值计算内圆半径，整个图形宽度／该值,就是36dp/5555=0.006480648dp-->
     <!--android:thicknessRatio="2"含义：按比值计算外环厚度。整个图形宽度／该值 就是36dp/2 = 18dp -->
     <solid android:color="#ff0000" />
     <size android:width="36dp" android:height="36dp"/>
 </shape>

如图：

oval_circle.xml

 <?xml version="1.0" encoding="utf-8"?>
 <shape xmlns:android="http://schemas.android.com/apk/res/android"
     android:shape="oval" >
     <size
         android:width="16dp"
         android:height="60dp"/>
     <solid android:color="#e3e3e3" />
 </shape>

注意，虽然shape="oval"，且width=16dp,height=60dp，但是在使用的时候将控件比如imageview或textview的高宽设置成一样就是正圆。

2，语法

　   其中android:shape有4个类型，rectangle 矩形，oval椭圆，line线条，ring环形。

　　<shape>有6个子元素。<corners>圆角,<gradient>渐变颜色,<padding>内边距,<size>大小,<solid>填充,<stoke>描边。

 <?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>

3，各元素属性详解

3.1<shape>形状

属性	含义	类型	取值	备注
android:shape	形状	枚举	rectagle矩形|正方形，oval椭圆|正圆， line水平直线，ring环形	画line时，用<stroke>定义线的高度
android:innerRadius	内半径	尺寸	内圆的半径。一个尺寸值（dip等等）或者一个尺寸资源。	只在android:shape="ring"有效 注意，android:innerRadiusRatio 和 android:thicknessRatio 指定的都是一个被除数，比值。
android:thickness	外环厚度	尺寸	外环的厚度，是一个尺寸值或尺寸的资源
android:innerRadiusRatio	内圆半径比值	float	按比值计算内圆半径，整个图形宽度／该值 例如,如果android:innerRadiusRatio="5", 则,内圆半径＝整个图形宽度的宽度／5。 这个值会被android:innerRadius重写。默认值是9 见上面 ring_circle.xml
android:thicknessRatio	外环厚度比值	float	按比值计算外环厚度。整个图形宽度／该值 例如,如果android:thicknessRatio="2", 则,外环厚度＝整个图形宽度／2。 这个值是被android:innerRadius重写，默认值是3。 见上面ring_circle.xml
android:useLevel	是否用作图层	bool	如果用在 LevelListDrawable里，那么就是true。 如果通常不出现则为false。

3.2<size>大小

属性	含义	类型	取值	备注
android:width	长度	尺寸
android:height	高度	尺寸

3.3<padding>内边距

属性	含义	类型	取值	备注
android:left	左边距	尺寸
android:top	上边距	尺寸
android:right	右边距	尺寸
android:bottom	下边距	尺寸

3.4<corners>圆角

属性	含义	类型	取值	备注
android:radius	四角的弧度	尺寸	设置0dp，无圆角 设置>1dp, 有圆角 值越大角越圆	只适用于rectagle
android:topRightRadius	右上角弧度	尺寸
android:bottomLeftRadius	右下角弧度	尺寸
android:topLeftRadius	左上角弧度	尺寸
android:bottomRightRadius	左下角弧度	尺寸

3.5<stroke> 描边

属性	含义	类型	取值	备注
android:width	描边的宽度	尺寸
android:color	描边的颜色	颜色
android:dashWidth	边框分段长度	尺寸		2属性要同时设置
android:dashGap	边框分段间隙	尺寸

3.6<solid>填充

属性	含义	类型	取值	备注
android:color	填充的颜色	颜色

3.7<gradient> 渐变颜色

属性	含义	类型	取值
android:startColor	渐变开始颜色	颜色
android:centerColor	渐变中间颜色	颜色
android:endColor	渐变结束颜色	颜色
android:angle	渐变角度	整字	0，默认值表示从左到右渐变90表示从下到上渐变， 取值必须是45的倍数
android:centerX	渐变中心相对于x轴位置	小数	0-1.0
android:centerY	渐变中心相对于y轴位置	小数	0-1.0
android:type	渐变的样式	枚举	linear线性渐变radial环形渐变sweep
android:gradientRadius	渐变半径	小数	android:type="radial"必填
android:useLevel	是否用作图层	布尔	true用于LevelListDrawable