Drawable资源之shape drawable

最新推荐文章于 2021-05-28 22:06:38 发布

翻译最新推荐文章于 2021-05-28 22:06:38 发布 · 1.1k 阅读

文章标签：

#GradientDrawable #shape #stroke #solid

Android开发同时被 2 个专栏收录

24 篇文章

订阅专栏

Android API Guides

18 篇文章

订阅专栏

本文介绍如何在Android中使用XML文件定义Shape Drawable，包括rectangle、oval、line及ring等形状，以及如何设置渐变、圆角、填充色等属性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

用来在XML中定义shape。

文件位置：

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

字符串。必须指定。定义这个XML的namespace，必须是

“http://schemas.android.com/apk/res/android”

android:shape

关键字。定义了shape的类型。可用的值如下：

Value	Description
“rectangle”	将矩形填充到这个容器视图，默认值。
“oval”	将椭圆填充到这个容器中。
“line”	铺满这个容器视图的一条横线。这个外观需要<stroke>元素来定义线的宽度。
“ring”	环形。

只有当android:shape=”ring”时，下面属性才会被使用：

android:innerRadius

Dimension。内部环（中心点）的半径，dimension值或dimensionresource。

android:innerRadiusRatio

Float。内部环的半径，占环宽度的比例。例如，如果android:innerRadiusRatio=”5”，那么内部半径就等于环的宽度除以5。这个值由android:innerRadius重写，默认值是9。

android:thickness

Dimension。环的厚度，dimension值或dimensionresource。

android:thicknessRatio

Float。环的厚度，占环宽度的笔录。例如，如果android:thicknessRatio=”2”，那么这个厚度就等于环宽度除以2。值被android:innerRadius重写，默认为3。

android:useLevel

布尔值。如果这用作LevelListDrawable则为true。一般情况这项应该为”false”，否则你要的形状可能不会出现。

为这个shape创建圆角。只有当形状为矩形时才能使用。

属性：

android:radius

Dimension。所有角的半径，类型为dimension值或dimension resource。对于每个角可以通过下面的属性进行重写。

android:topLeftRadius

Dimension。左上角的半径，类型为dimension值或dimensionresource。

android:topRightRadius

Dimension。右上角的半径，类型为dimension值或dimensionresource。

android:bottomLeftRadius

Dimension。左下角的半径，类型为dimension值或dimensionresource。

android:bottomRightRadius

Dimension。右下角的半径，类型为dimension值或dimensionresource。

注意：每个角（最初）必须提供大于1的半径，否则不会出现圆角。如果你不想将角指定为圆角，应急预案是用android:radius将每个角的半径设为大于1，然后用你想要的真实值再重写每个角，并且在你不想要圆角时将它设为0（“0dp”）。

对这个形状指定渐变色。

属性：

android:angle

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

android:centerX

Float。X方向中心点的位置(0~1.0)。

android:centerY

Float。Y方向中心点的位置(0~1.0)。

android:centerColor

Color。来自开始和结束颜色之间的可选颜色，16进制数或color resource。

android:endColor

Color。结束时的颜色，16进制数或colorresource。

android:gradientRadius

Float。渐变半径。只有当android:type="radial"时才使用。

android:startColor

Color。开始时的颜色，16进制数或colorresource。

android:type

关键字。应用的渐变模式的类型，可用的值有：

Value	Description
“linear”	线性渐变，默认值。
“radial”	径向渐变。开始颜色为中心颜色。
“sweep”	扫线渐变。

android:useLevel

Boolean。如果这用作LevelListDrawable时此项为true。

填充应用的容器视图（这会填充视图的内容，而不是形状）。

android:left

Dimension。左边距。dimension值或dimensionresource。

android:top

Dimension。上边距。dimension值或dimensionresource。

android:right

Dimension。右边距。dimension值或dimensionresource。

android:bottom

Dimension。下边距。dimension值或dimensionresource。

<size>

形状的尺寸。

属性：

android:height

Dimension。形状的高度。dimension值或dimensionresource。

android:width

Dimension。形状的宽度。dimension值或dimensionresource。

注意：默认情况下，这个shape会等比例计算容器视图的尺寸来适应设置的尺寸。当你在ImageView中使用shape时，你能通过设置android:scaleType=”center”来限制计算类型。

<solid>

填充到shape的颜色。

属性：

android:color

Color。应用到shape的颜色。十六进制或colorresource。

这个shape的中线。

属性：

android:width

Dimension。线条的厚度，dimension值或dimensionresource。

android:color

Color。线条的颜色，十六进制或colorresource。

android:dashGap

Dimension。线条破折号之间的距离，dimension值或dimensionresource。只有当android:dashWidth设置后才可用。

android:dashWidth

Dimension。每条破折线的尺寸，dimension值或dimensionresource。只有设置了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中将这个shape drawable应用到视图上：

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

下方是通过代码获取shape drawable并将它应用到视图上：

Resources res = getResources();
Drawable shape = res.getDrawable(R.drawable.gradient_box);
 
TextView tv =(TextView)findViewByID(R.id.textview);
tv.setBackground(shape);