第三部分：Android 应用程序接口指南---第三节：应用程序资源---第五章资源类型

第5章资源类型

这一大章节的每个部分描述了一类应用资源的用法，格式和语法。你可以把这些资源放在你的资源目录下（即res/)。下面是对每个资源类型的简介：

◆动画资源(Animation Resources)

定义预设的动画。

补间动画被保存在res/anim目录下且可通过R.anim这个类访问它。

帧动画保存在res/drawable/目录下，可通过R.drawable这个类访问它。
◆颜色状态列表资源(Color State List Resource)

定义了一个根据视图状态改变的颜色资源。

保存在res/color，通过R.color这个类访问。

◆可绘制的资源(Drawable Resources)

用位图或XML定义各种各样的图像。

保存在res/drawable/目录下，通过R.drawable这个类访问。

◆布局资源(Layout Resource)

定义你应用程序用户界面的布局。

保存在res/layout/目录下，通过R.layout这个类访问。

◆菜单资源(Menu Resource)

定义你的应用程序的菜单内容。

保存在res/menu目录下，通过R.menu这个类访问。

◆字符串资源(String Resources)

定义字符串，字符串数组和复数（字符串的格式和风格）。

保存在res/values目录下，通过R.string、R.array和R.plurals这几个类访问。

◆风格资源(Style Resource)

定义用户界面的元素的格式和外观。

保存在res/values目录下，通过R.style这个类访问

◆更多的资源类型(More Resource Types)

定义各种各样的值，如布尔值，整数值，数量值，颜色值，和其他数组。

保存在res/values下，且每个都用特有的R的子类访问（如R.bool,R.integer,R.dimen等等）。

5.1 动画

Android框架提供了两种动画系统：

property animation（属性动画,在Android 3.0中引入）

view animation（视图动画）。

这两种动画系统是可行的方案，但属性动画系统，在一般情况下，是首选的方法使用，因为它更灵活，并提供更多的功能。除了这两个，我们还可以利用Drawable animation（帧动画），它允许你加载绘制的资源，并逐帧显示。

视图的动画系统提供的功能，只针对动画Vuew对象，所以如果你想动画非View对象，你要实现自己的代码来实现。视图动画系统事实上只能暴露一个视图对象几个方面的动画,如缩放和旋转视图，但没有背景颜色。

View动画系统的另一个缺点是，只有修改，而不是实际的视图本身。例如，如果你的动画在屏幕上移动一个按钮，按钮绘制正确，当你按下按钮，但按钮实际的位置不会改变，所以你要实现自己的逻辑来处理这个问题。

相比属性动画系统，这些限制完全消除，你可以动画任何对象的任何属性（View和非View）和对象本身实际也是可以被修改。属性动画系统也更强大的方式进行了动画。在一个较高的水平，你分配动画要动画的属性，如颜色，位置或大小，可以定义方面，如插补和同步多个动画的动画。

然而，View动画系统，花费更少的时间设置，需要更少的代码。如果View动画完成了你需要做的，或者你现有的代码已经完成了工作，那就没有必要使用属性动画系统。

5.1.1属性动画

在XML中定义的一个动画,在设定的时间内修改目标对象的属性,例如背景颜色或alpha值。

文件路径:

res/animator/filename.xml
文件名将被作为资源ID使用

编译资源数据类型:

ValueAnimator, ObjectAnimator,或AnimatorSet

资源引用:

Java: R.animator.filename
XML: @[package:]animator/filename

语法，如代码清单5-1所示:

<set

  android:ordering=["together" | "sequentially"]>


    <objectAnimator

        android:propertyName="string"

        android:duration="int"

        android:valueFrom="float | int | color"

        android:valueTo="float | int | color"

        android:startOffset="int"

        android:repeatCount="int"

        android:repeatMode=["repeat" | "reverse"]

        android:valueType=["intType" | "floatType"]/>



    <animator

        android:duration="int"

        android:valueFrom="float | int | color"

        android:valueTo="float | int | color"

        android:startOffset="int"

        android:repeatCount="int"

        android:repeatMode=["repeat" | "reverse"]

        android:valueType=["intType" | "floatType"]/>


    <set>

        ...

    </set>

</set>

代码清单5-1

这个文件必须有一个单一的根节点：<set>。你可以组合各种动画元素到一起。

元素:

<set>

一个支撑其他动画元素的容器(<objectAnimator>,<valueAnimator>,<set>)。

你能制定<set>标签嵌套到深一层的组合。每一个<set>能定义它自己的ordering属性。

属性:

android:ordering

指定动画播放的顺序

值	描述
sequentially	循序的播放动画
together (默认)	同一时刻一起播放动画

下面让我们看一个实例:

XML文件保存在res/animator/property_animator.xml，如代码清单5-2所示:

<set android:ordering="sequentially">

    <set>

        <objectAnimator

            android:propertyName="x"

            android:duration="500"

            android:valueTo="400"

            android:valueType="intType"/>

        <objectAnimator

            android:propertyName="y"

            android:duration="500"

            android:valueTo="300"

            android:valueType="intType"/>

    </set>

    <objectAnimator

        android:propertyName="alpha"

        android:duration="500"

        android:valueTo="1f"/>

</set>

代码清单5-2

为了执行这个动画，你必须inflate这个XML资源到你的代码中，然后设置目标对象，如代码清单5-3所示：

AnimatorSet set = (AnimatorSet) AnimatorInflater.loadAnimator(myContext,

    R.anim.property_animator);

set.setTarget(myObject);

set.start();

代码清单5-3

更详细的内容，可以参考simples中的例子，后面将图形与动画章节时，我们会在提到属性动画。

5.1.2 View动画

View动画分为渐变动画和帧动画。网络上有非常多的例子，很多人也用过，这里不再赘述，说一下几个细节。位移动画除了直接使用数字坐标外，还可以使用%p这样的格式，如android:fromYDelta=5%p

%表示相对于自己,%p表示现对于父类。还有一个android:interpolator属性，默认这个属性不是匀速的，所以有些人遇到一直播放的旋转动画，总是不连贯，在某处停顿一下。这是因为加速器没有设置为匀速。请参考一下表格

Interpolator类	Resource ID
AccelerateDecelerateInterpolator	@android:anim/accelerate_decelerate_interpolator
AccelerateInterpolator	@android:anim/accelerate_interpolator
AnticipateInterpolator	@android:anim/anticipate_interpolator
AnticipateOvershootInterpolator	@android:anim/anticipate_overshoot_interpolator
BounceInterpolator	@android:anim/bounce_interpolator
CycleInterpolator	@android:anim/cycle_interpolator
DecelerateInterpolator	@android:anim/decelerate_interpolator
LinearInterpolator	@android:anim/linear_interpolator
OvershootInterpolator	@android:anim/overshoot_interpolator

关于帧动画，一个需要注意的地方就是AnimationDrawable.stop()方法，当你的帧动画只播放一次时，如果需要再次播放，请先调用stop()方法，在调用start()方法，不然你一直调用start()方法是无效的，它不会播放。

5.2 颜色状态列表

一个ColorStateList你可以在XML中定义并且作一个color来使用的对象，但实际上它会根据所使用它的View对象的状态改变颜色。例如，一个Button控件可以存在几种不同的状态（press压，focused获得焦点，或niether常态），此时使用ColorStateList，就可以跟据每个状态提供不同的颜色值来显示。您可以在一个XML文件中，把每种颜色被定义在一个单独的<selector> 标签内的<item> 标记里面。每个<item> 可使用各种属性来描述其对应的状态。在每个状态变化时，状态列表将从上到下，找到第一个符合当前的状态将就会被用上。也就是说，并不是基于用“最佳匹配”的算法来选择的，而仅仅遇到第一个符合最低标准的就会被使用。

注：如果你想提供一个静态的色彩资源，就用一个简单的Color值。即color.xml中。下面让我们看一下代码清单5-4的语法:

<?xml version="1.0" encoding="utf-8"?>

<selector xmlns:android="http://schemas.android.com/apk/res/android" >

    <item

        android:color="hex_color"

        android:state_pressed=["true" | "false"]

        android:state_focused=["true" | "false"]

        android:state_selected=["true" | "false"]

        android:state_checkable=["true" | "false"]

        android:state_checked=["true" | "false"]

        android:state_enabled=["true" | "false"]

        android:state_window_focused=["true" | "false"] />

</selector>

代码清单5-4

标签：

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

属性：

xmlns:android

String类型。必需的。用于定义xml的命名空间。其值为：

"http://schemas.android.com/apk/res/android" 。

<item>

定义颜色的，就是根据你想处理的状态使用不同的属性值来显示对应的颜色。必须是<selector>的子元素。

属性：

android:color

十六进制颜色值。必需的。Color用指定RGB值和可选的alpha通道。

其value以“#”号开头，后面跟Alpha-Red-Green-Blue 信息，如下所示：

RGB

ARGB

RRGGBB

AARRGGBB

android:state_pressed

Boolean控件被压(触摸touched/点击clicked)的时候返回true。默认为false。

android:state_focused

Boolean控件获得焦点的时候返回true。默认为false。这里解释一下使用场景，<模拟器容易看到>比如使用滑轮或键盘的方向导航键导航到某一个控件上，则此控件就得到了焦点。当然其它的点击，选择，光标等也都有焦点跟随的。

android:state_selected

Boolean控件被选中的时候返回true。默认为false。比如一个tab被打开。

android:state_checkable

Boolean控件处于可选状态的时候返回true。默认为false。说明，这个属性和下面的checked属性仅仅用于那些在可选和不可选两种状态当中过渡的控件。

android:state_checked

Boolean控件被选中的时候返回true。默认为false。

android:state_enabled

Boolean控件可用的时候返回true。默认为false。

android:state_window_focused

Boolean当应用的窗口处于聚焦状态时返回true，当窗口失去焦点时返回false（就是说应用窗口处于前台时返回true，处于后台返回false。比如通知罩（即通知栏被拉下后的半透时界面）被打开时或者一个对话框（dialog）出现的时候。后面的窗口就处于失焦状态。

注意：请记住，在状态列表的第一项的会被直接应用到当前状态。因此如果第一项没有包含上述状态中对应的状态，才会从上到下进行匹配。每次都是如此，这也就是为什么default默认状态要写在最末尾的原因。下面让我们看一个实例，如代码清单5-5所示:

XML文件保存在res/color/button_text.xml:

<?xml version="1.0" encoding="utf-8"?>

<selector xmlns:android="http://schemas.android.com/apk/res/android">

    <item android:state_pressed="true"

          android:color="#ffff0000"/> <!-- pressed -->

    <item android:state_focused="true"

          android:color="#ff0000ff"/> <!-- focused -->

    <item android:color="#ff000000"/> <!-- default -->

</selector>

代码清单5-5

作用于下面的这个button，如代码清单5-6所示:

<Button

    android:layout_width="fill_parent"

    android:layout_height="wrap_content"

    android:text="@string/button_text"

    android:textColor="@color/button_text" />

代码清单5-6

5.3 Drawable资源

一个drawable资源,就是能被画到屏幕的一个一般的图形概念，它可以用getDrawable(int)这个API或者将其应用到xml文件资源中,使用android:drawable和android:icon这两个属性

有如下多种图形概态.

Bitmap File

一个位图文件(.png,.jpg,或.gif), 生成一个BitmapDrawable对象.

Nine-Patch File

就是一张可以基于自动适应内容大小而伸缩区域的png图片(.9.png), 生成一个NinePatchDrawable对象

Layer List

这个Drawable用来管理一个其它多个drawable的数组.既然是一个数组,所以就不难理解索引值最大的元素将画在最高部. 生成一个LayerDrawable对象.

State List

这是一个xml文件用于不同的状态来引用不同的位图图形(比如,当一个Button控件按下状态要显示不同的图像)。生成一个StateListDrawable对象.

Level List

一个xml文件,定义了一个drawable可用于管理几个可以替换的drawable.每一个都会分配一个最大的数值.生成一个LevelListDrawable。

Transition Drawable

一个xml文件,定义了一个drawable可用于两张图片形成一个渐变的过渡效果生成一个TransitionDrawable对象

Inset Drawable

一个xml文件,定义了一个drawable,跟据指定的距离插入到另一个drawable.当一个View对象需要一张比其实际边框要小的背景图时,就可以用到这个了.

Clip Drawable

一个xml文件,定义了一个drawable, 根据当前对准值作相应的拉伸处理,生成 ClipDrawable对象.

Scale Drawable

一个xml文件,定义了一个drawable, 根据当前对准值作相应的平铺处理,生成 ScaleDrawable对象.

Shape Drawable

就是通过一个xml文件来定义一个包含颜色和渐变的几何图形, 生成一个 ShapeDrawable对象

注：在xml中一个color resource<颜色资源>也可以作为一个drawable. 例如,创建一个state list drawable时,你可以为android:drawable属性引用一个颜色资源(android:drawable="@color/green").

5.3.1 Bitmap

Android 支持三种格式的位图文件.png(推荐 ), .jpg(可以接受), .gif(不建议使用). 可以直接用文件名来引用一个位图文件,或在xml中为其创建一个资源id的别名.

注意：在编译过程中Bitmap文件可能使用aapt工具优化为无损压缩图像，例如，一个不需要256色的真彩PNG图片可能转化为附有调色板的8-bitPNG图片。这会产生同等质量的图片，但只需要较少的内存。所以需要明白在此路径下的图片在编译中会改变。如果打算按bit流读取图片以转换成位图，把图片放在res/raw/文件夹，这将不会被优化。

1.Bitmap File(位图文件)

一个位图文件就是一个.png, .jpg, 或 .gif文件. 当你把这些文件放在res/drawable/ 中,Android就会为其创建一个 Drawable (可绘制的)资源.

文件位置:

res/drawable/filename.png (.png, .jpg, or .gif)

文件名被用作资源id.

编译后的资源数据类型:

资源将生成一个BitmapDrawable对象.

资源引用:

java: R.drawable.filename

xml: @[package:]drawable/filename

例如:

当一个图片保存在res/drawable/myimage.png ,下面就是xml来使用此图到一个View上，如代码清单5-7所示:

<ImageView

    android:layout_height="wrap_content"

    android:layout_width="wrap_content"

    android:src="@drawable/myimage" />

代码清单5-7

下面的应用代码是将一个图片恢复为一个Drawable对象，如代码清单5-8所示:

Resources res = getResources();

Drawable drawable = res.getDrawable(R.drawable.myimage);

代码清单5-8

2.XML Bitmap

XML Bitmap是定义在xml文件中，指向一个位图的资源文件.这种作用对于原始的位图文件尤其有效。此XML可以设定抖动，拼接等位图的附加属性。

注意：可以使用<bitmap>成员作为<item>成员的子成员，例如：当创建一个statelist(状态列表)或者layerlist(图层列表),可以从<item>元素中去除android:drawable属性，而在<item>中构建一个<bitmap>来定义此绘制项(drawable item).

文件位置：

res/drawable/filename.xml以此文件名作为标识资源的ID

编译过后的资源数据类型：

一个指向BitmapDrawable的资源指针

资源引用：

Java: R.drawable.filename

XML: @[package:]drawable/filename

语法，如代码清单5-9所示：

<?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:tileMode=["disabled" | "clamp" | "repeat" | "mirror"] />

代码清单5-9

元素：

定义位图资源和特性。

属性：

xmlns:android:

String. 定义XML的命名空间，必须是："http://schemas.android.com/apk/res/android",只有当此<bitmap>是一个根元素时才要求，当此<bitmap>是构建在一个<item>中此要求是不必要的。

android:src

可绘制资源，必需项，引用一个可绘制资源。

android:antialias

布尔型，是否允许平滑效果。

android:dither

布尔型，如果位图与屏幕的像素配置不同时，是否允许抖动。（例如：一个位图的像素设置是 ARGB 8888，但屏幕的设置是RGB 565）

android:filter

布尔型。是否允许对位图进行滤波。对位图进行收缩或者延展使用滤波可以获得平滑的外观效果。

android:gravity

关键字。定义位图的gravity，如果位图小于其容器，使用gravity指明在何处绘制。

取值必须是如下常量值中的一个或多个（以分隔‘|’）

android:tileMode（平铺模式）

关键字。定义平铺模式，当允许平铺模式时，重复位图，忽略gravity设置。取值必须是如下常量值中的一个:

取值	描述
desable	不给位图添加标题，默认值。
clamp	复制边缘的颜色，如果着色超出原来的界限。
repeat	垂直和水平重复着色的图片。
mirror	垂直和水平重复着色的图片,交替镜像图片使得临近的一直衔接。

实例，如代码清单5-10所示:

<?xml version="1.0" encoding="utf-8"?>

<bitmap xmlns:android="http://schemas.android.com/apk/res/android"

    android:src="@drawable/icon"

    android:tileMode="repeat" />

代码清单5-10

5.3.2 Nine-Patch

一个可拉伸图片是一个PNG图片，当View中的图片内容超过了其正常的图片边界时，可以在其中定义供Android缩放的拉伸区域。此类图片常被用于至少有一个维度设置为“wrap_content”的View的背景,View需要扩展自己来适应其内容，而Nine-Patch也会缩放以匹配View的大小。Nine-Patch的一个使用示例就是Android标准Button控件的背景，必须伸缩以适应Button的文字或图片。同正常的位图一样，你可以直接引用一个Nine-Patch文件也可以通过XML定义资源引用。

1.Nine-Patch文件

文件位置:

res/drawable/filename.9.png

使用文件名来标示资源。

编译过的资源数据类型：

资源指针指向一个NinePatchDrawable文件。

资源引用:

Java: R.drawable.filename

XML: @[package:]drawable/filename

举例: 有一个图片保存在res/drawable/myninepatch.9.png, 此布局XML应用到一个View, 如代码清单5-11所示:

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

代码清单5-11

2. XML Nine-Patch

一个XML Nine-Patch 是一个定义在XML中，指向一个Nine-Patch文件的资源，此XML能够设置图片的抖动。

文件位置:

res/drawable/filename.xml

使用文件名来标示资源。

编译过的资源数据类型：

资源指针指向一个NinePatchDrawable文件。

资源引用:

Java: R.drawable.filename

XML: @[package:]drawable/filename

语法，如代码清单5-12所示:

<?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"] />

代码清单5-12

元素:

<nine-patch>

定义Nine-Patch和其特性

属性:

xmlns:android

字符型，必要的. 定义XML的命名空间，必须是

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

android:src

可绘制资源，必要的，指向一个Nine-Patch文件。

android:dither

布尔型，如果位图与屏幕的像素配置不同时，是否允许抖动.（例如：一个位图的像素设置是 ARGB 8888，但屏幕的设置是RGB 565）。

举例，如代码清单5-13所示：

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

代码清单5-13

5.3.3 Layer list

一个图层是一个管理一系列其他绘图的绘制对象。在列表中的每个可绘制物有序地绘制在列表内，最后一个绘图在最上面。

每个绘图作为一个<item>元素单独地呈现在<layer-list>元素内。

文件位置:

res/drawable/filename.xml

使用文件名来标示资源。

编译过的资源数据类型：

资源指针指向一个LayerDrawable文件。

资源引用:

Java: R.drawable.filename

XML: @[package:]drawable/filename

语法，如代码清单5-14所示:

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

代码清单5-14

元素：

<layer-list>

必要的，这个必须是一个根元素，包含了一个或多个<item>元素。

属性:

xmlns:android

字符型，必要的，定义XML的命名空间，必须是

"http://schemas.android.com/apk/res/android"

<item>

定义一个绘图放在图层里，位置由其属性确定。必须是<selector>的子元素。可接受<bitmap>最为子元素。

属性：

android:drawable

可绘制资源，必须的，引用一个可绘制资源。

android:id

资源ID，此绘图资源唯一的资源ID。为新项创建一个新的资源ID："@+id/name"。"+"表示新增一个ID。可以使用ID号通过View.findViewById()或者Activity.findViewById()来检索和修改此绘图资源。

android:top

整型，顶上像素偏移。

android:right

整型，右方像素偏移。

android:bottom

整型，底部像素偏移。

android:left

整型，左方像素偏移。

默认情况下所有绘制项目缩放，以适应包含视图的大小。因此，放置图像在图层列表的不同位置，可能会增加View的大小和一些图像需要扩展到合适的大小。为了避免列表中的扩展项，在<item>元素内使用<bitmap>元素，指定可绘制性和定义gravity为不会扩展的属性，诸如“居中”。例如，下面的<item>定义了一个项，扩展到适应其容器View的大小，如代码清单5-15所示：

<item android:drawable="@drawable/image" />

代码清单5-15

为避免扩展，如下的例子使用一个<bitmap> 元素，gravity属性为居中，如代码清单5-16所示：

<item>

  <bitmap android:src="@drawable/image"

          android:gravity="center" />

</item>

代码清单5-16

实例：

XML文件保存于res/drawable/layers.xml，如代码清单5-17所示:

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

代码清单5-17

注意这个例子使用gravity属性居中的内嵌<bitmap>元素，来定义每个列表项的绘图资源。由于，图片偏移量引起的尺寸调整，这确保了没有图片需要缩放来适应容器的大小。把这个XML布局应用到一个View，如代码清单5-18所示:

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

代码清单5-18

结果是偏移量不断增加的一系列图片的堆叠：

5.3.4 State list

StateListDrawable是一个定义在XML中的可绘制对象，使用几个不同的图像，根据对象的状态来呈现同一个图形。例如，一个Button控件，可以处于几种状态中的一种（按下，聚焦，或都不是）使用状态列表可绘制，可以为每个状态提供不同的背景图像。

可以在XML文件中描述列表，每个图形由一个<item>元素内部有一个单一<selector>元素呈现。每个<item>拥有多个属性来描述应用到可绘制对象的图形的状态。

在每个状态改变期间，状态列表是横跨从顶到底，使用第一个项匹配当前状态，这种选择不是基于最佳匹配，而仅仅是第一个项符合状态的最小标准。

文件位置：

res/drawable/filename.xml

以文件名作为标示资源的ID。

编译后资源数据类型：

资源指针指向一个StateListDrawable。

资源引用：

Java: R.drawable.filename

XML: @[package:]drawable/filename

语法，如代码清单5-19：

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

代码清单5-19

元素：

必要的，这个必须是根元素，包含了一个或多个<item>元素。

属性：

xmlns:android

字符型，必要的，定义XML的命名空间，必须等于

"http://schemas.android.com/apk/res/android"。

android:constantSize

布尔型。当状态变化时，绘制对象的内部大小保持不变（所有状态的最大值）为"true"；如果绘制对象的大小根据当前状态而改变为"false",默认设置为"false"。

android:dither

布尔型，"true"，当位图的像素配置与屏幕的不一致时，允许位图抖动（例如，一个ARGB 8888 的位图和一个RGB 565 的屏幕）；"false"，不允许抖动，默认设置为"false"。

android:variablePadding

布尔型，为"true"时，根据所选择的当前状态，可绘制对象的填充需要改变；为"false"时，填充保持不变（所有状态的填充最大值）。使用此特性要求当状态改变时处理好布局，它会常常不支持。默认设置为"false"。

<item>

定义一个可应用在一定状态的绘制对象，属性由其描述所定，必须是<selector>的子元素。

属性：

android:drawable

可绘制资源，必要的，引用一个可绘制资源。

android:state_pressed

布尔型，为"true"时，当对象被按下（诸如触摸/单机一个按钮）使用此选项；为"false"时，默认设置应当使用此选项，处于没有按下状态。

android:state_focused

布尔型，为"true"时，当对象拥有输入焦点时应使用此选项（诸如当用户选择一个文本输入）；为"false"时，默认设置使用此选项，处于没有焦点状态。

android:state_hovered

布尔型，为"true"时，当对象处于游标徘徊在附近时，使用此选项；"false"时，默认使用此选项，处于没有游标徘徊状态。通常，这种绘制对象与聚焦状态的绘制对象相同。

API 14 中有介绍。

android:state_selected

布尔型，为'true"时，当对象是当前用户通过方向控制键导航选择选项（诸如通过一个十字键列表导航），使用此选项；为"false"时,当对象没有被选中时，使用此选项。

当聚焦不够用时使用此选择状态（诸如当列表视图拥有聚焦而使用十字键选择一个选项时）。

android:state_checkable

布尔型，为"true"时，对象是是可核对的；为"false"时，对象不可核对的。（只当对象可以在可核对与不可核对控件间变换时使用）

android:state_enabled

布尔型，为 "true"时，对象许可（能够接受到触摸或单击事件）；为"false"时，对象不许可。

android:state_activated

布尔型，为"true"时，由于持久的选择使对象处于激活状态，（诸如在一种持久的导航视图中高亮标示列表选项）；为"false"时，对象没有处于激活状态。

详细介绍在API11

android:state_window_focused

布尔型，为"true"时，焦点在应用的窗口（此应用处于前台），此应用的窗口没有获得焦点（例如当有通知栏拉下或对话出现）

注意：记住Adroid在状态列表中使用第一个选项以匹配对象的当前状态。所以，如果列表中第一个选项不包含任一个的状态属性，此时它就会每次都使用第一个选项，这也是为什么要把默认属性放在最后面的原因。（如下面的示例所示）

例子: XML 文件保存于res/drawable/button.xml，如代码清单5-20所示:

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

代码清单5-20

把此布局应用到一个按钮的可绘制状态列中，如代码清单5-21所示：

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

代码清单5-21

5.3.5 Level list

一个可绘制对象管理许多可相互替换的可绘制对象，每个都标示了最大数值。使用setLevel()设置可绘制资源的级别,在级别列表中装载可绘制资源，此列表有个android:maxLevel 值，此值大于或等于方法传递给setLevel()方法的值。

文件位置:

res/drawable/filename.xml

文件名作为资源ID。

编译后的资源数据类型：

指向一个LevelListDrawable的资源。

资源引用：

Java: R.drawable.filename

XML: @[package:]drawable/filename

语法，如代码清单5-22所示:

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

代码清单5-22

元素:

<level-list>

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

xmlns:android

字符型，必要的，定义XML的命名空间，必须是

"http://schemas.android.com/apk/res/android".

<item>

在某级别上定义一个可绘制的对象。

属性:

android:drawable

可绘制资源，必要的，引用一个可绘制资源来插入。

android:maxLevel

整型，允许的级别最大值

android:minLevel

整型，允许的级别最小值

举例，如代码清单5-23所示:

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

代码清单5-23

一旦把此应用到一个视图上，此等级值可以通过setLevel() 或 setImageLevel()修改

5.3.6 Transition Drawable

一个变换Drawable是一个可绘制对象，在两个可绘制资源间能够同时淡入淡出。每个可绘制对象由在单独的<transition>元素中的<item>元素表示。至多支持两个选项。前向过渡使用startTransition()，后向使用 reverseTransition()。

文件位置:

res/drawable/filename.xml

文件名作为资源ID。

编译后的资源数据类型：

指向一个变换Drawable的资源。

资源引用：

Java: R.drawable.filename

XML: @[package:]drawable/filename

语法，如代码清单5-24所示:

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

代码清单5-24

元素:

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

属性:

xmlns:android

字符型，必要的，定义XML的命名空间，必须是

"http://schemas.android.com/apk/res/android"。

<item>

定义一个可绘制对象作为此可绘制过度，必须是<transition>元素的子元素。接受<bitmap>子元素。

属性：

android:drawable

可绘制资源，必要的，引用一个可绘制资源。

android:id

必要的ID，此可绘制对象的唯一资源ID。若为此项创建一个新的资源ID，使用 "@+id/name"。加号表示应当创建一个新的ID。可以使用此符号通过View.findViewById()或者Activity.findViewById()来显示和修改此绘制对象。

android:top

整型，像素的上方偏移量。

android:right

整型，像素的右边偏移量。

android:bottom

整型，像素的下方偏移量。

android:left

整型，像素的左边偏移量。

举例：

XML文件保存于res/drawable/transition.xml，如代码清单5-25所示:

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

代码清单5-25

把此XML布局应用到试图，如代码清单5-26所示：

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

代码清单5-26

下面的代码实现了从第一项到第二项变换需要500ms，如代码清单5-27所示。

ImageButton button = (ImageButton) findViewById(R.id.button);

TransitionDrawable drawable = (TransitionDrawable) button.getDrawable();

drawable.startTransition(500);

代码清单5-27

5.3.7 Inset Drawable

一个定义在XML中的可绘制对象，在指定的距离内插入另外一个可绘制对象。当一个视图的背景小于视图的实际大小时，会用到此。

文件位置：

res/drawable/filename.xml

文件名作为资源ID。

编译后资源数据类型：

资源InsetDrawable指针

资源引用：

Java: R.drawable.filename

XML: @[package:]drawable/filename

语法，如代码清单5-28所示：

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

代码清单5-28

元素:

<inset>

定义一个插入drawable。必须是根元素。

属性:

xmlns:android

字符型，必要的，定义XML的命名空间，必须是

"http://schemas.android.com/apk/res/android"

android:drawable

可绘制资源，必要的，引用一个可绘制资源以插入。

android:insetTop

尺寸，上端插入，作为一个尺寸值或尺寸资源。

android:insetRight

尺寸，右端插入，作为一个尺寸值或尺寸资源。

android:insetBottom

尺寸，底端插入，作为一个尺寸度值或尺寸资源。

android:insetLeft

尺寸，左边插入，作为一个尺寸值或尺寸资源。

举例，如代码清单5-29所示:

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

代码清单5-29

5.3.8 Clip Drawable

根据可绘制对象的当前级别，定义在XML中可绘制对象，可以剪贴另一个可绘制对象。

可以根据当前级别决定以什么样的宽高比裁剪子对象，还有gravity来控制在容器内部的摆放位置。

常用来实现例如进度条的东西。

文件位置:

res/drawable/filename.xml

文件名作为资源ID。

编译后资源数据类型:

资源ClipDrawable指针

资源引用：

Java: R.drawable.filename

XML: @[package:]drawable/filename

语法, 如代码清单5-30所示:

<?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"] />

代码清单5-30

元素:

<clip>

定义剪贴绘制对象，必须是根元素。

属性:

xmlns:android

字符型，必要的，定义XML的命名空间，必须是"http://schemas.android.com/apk/res/android"。

android:drawable

可绘制资源，必要的，引用一个要剪贴的可绘制资源。

android:clipOrientation

关键字，对剪贴进行定位。

android:gravity

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

取值必须是如下常量之一或多个（以“|”分隔）：

举例: XML文件保存于 res/drawable/clip.xml，如代码清单5-31所示:

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

代码清单5-31

下面的XML布局应用到一个试图的剪贴可绘制资源，如代码清单5-32所示：

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

代码清单5-32

如下的代码取得可绘制对象，为了渐进地显示图像增加了剪贴数，如代码清单5-33所示：

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

代码清单5-33

增加级别减少了剪贴数，减慢了显示图像的速度，如下是级别数为7000：

注意：默认级别为0，全部剪贴，图像不可见，当级别是10000，图片没有剪贴，全部可见。

5.3.9 Scale Drawable

一个定义在XML中的可绘制对象，能够依据当前级别改变另一个可绘制对象的大小。

文件位置:

res/drawable/filename.xml

文件名作为资源ID。

编译后数据类型：

指向尺寸Drawable的资源指针。

资源引用：

Java: R.drawable.filename

XML: @[package:]drawable/filename

语法，如代码清单5-34所示:

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

代码清单5-34

元素:

<scale>

定义尺寸drawable.，必须是根元素。

属性:

xmlns:android

字符型，必要的，定义XML的命名空间，必须是"http://schemas.android.com/apk/res/android"

android:drawable

可绘制资源，必要的，引用一个可绘制资源。

android:scaleGravity

关键字，指定缩放后的gravity位置

取值必须是如下常量中一个或多个（以“|”分隔）：

android:scaleHeight

百分比，高度尺寸，表示可绘制对象的边界百分比，取值以百分比形式，例如：100%,12.5%,等。

android:scaleWidth

百分比，高度尺寸，表示可绘制对象的边界百分比，取值以百分比形式，例如：100%,12.5%,等。

举例，如代码清单5-35所示:

<?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%" />

代码清单5-35

5.3.10 Shape Drawable

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

文件位置:

res/drawable/filename.xml

文件名作为资源ID。

编译后的资源数据类型：

指向一个渐变Drawable的资源指针。

资源引用：

Java: R.drawable.filename

XML: @[package:]drawable/filename

语法，如代码清单5-36所示:

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

代码清单5-36

元素:

<shape>

形状drawable，必须是根元素。

属性:

xmlns:android

字符型，必要的，定义XML的命名空间，必须是

"http://schemas.android.com/apk/res/android"。

android:shape

关键字，定义形状的类型，取值是：

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

如下属性只有当android:shape="ring"时才使用。

android:innerRadius

尺寸，内环半径（中间的孔），作为一个尺寸值或尺寸资源。

android:thickness

尺寸，环的厚度，作为一个尺寸值或尺寸资源。

android:thicknessRatio

浮点型，环的厚度比上环的宽度，例如，如果android:thicknessRatio="2"，厚度等于环的宽度的1/2，此值被android:innerRadius重写，默认为3.

android:useLevel

布尔型，为"true"时，用于LevelListDrawable，正常情况设为"false",或者形状不出现。

为形状创建圆角，只有当形状为矩形时才应用。

属性：

android:radius

尺寸数，所有的角的半径，作为一个尺寸值或尺寸资源，对于每个角会重写如下的属性：

android:topLeftRadius

尺寸数，左上角的半径，作为一个尺寸度值或尺寸资源。

android:topRightRadius

尺寸数，右上角的半径，作为一个尺寸度值或尺寸资源。

android:bottomLeftRadius

尺寸数，左下角的半径，作为一个尺寸值或尺寸度资源。

android:bottomRightRadius

尺寸数，右下角的半径，作为一个尺寸值或尺寸度资源。

注意：每个角的角半径必须大于1，不然没有圆角。如果想指定所有的角都不是圆角，使用android:radius

来设定默认的角半径大于1,然后重写每个角，并指定每个角的半径值为所需要的值，如果不需要圆角，值为0（0dp）。

为形状指定渐变颜色。

属性：

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

布尔型，为"true"时，作为一个 LevelListDrawable。

填充以适用于视图元素（填充视图内容的位置而不是形状。

属性：

android:left

尺寸，左边填充，作为一个尺寸值或者尺寸资源。

android:top

尺寸，顶上填充，作为一个尺寸值或者尺寸资源。

android:right

尺寸，右边填充，作为一个尺寸值或者尺寸资源。

android:bottom

尺寸，底边填充，作为一个尺寸值或者尺寸资源。

<size>

形状的大小。

属性：

android:height

尺寸，形状的高，作为一个尺寸值或者尺寸资源。

android:width

尺寸，形状的宽，作为一个尺寸值或者尺寸资源。

注意：形状缩放大小以适应视图，与定义的尺寸相称，默认，当在一个图像视图使用形状时，可以限制缩放，通过设置 android:scaleType to "center"。

<solid>

固定颜色填充形状。

属性：

android:color

颜色，用到形状上的颜色，作为一个十六进制值或颜色资源。

形状的笔触。

属性：

android:width

尺寸，线的宽度，作为一个尺寸值或尺寸资源。

android:color

颜色，线的颜色，作为一个十六进制值或者颜色资源。

android:dashGap

尺寸，虚线间隔，作为一个尺寸值或尺寸资源，只有当设置android:dashWidth才有效。

android:dashWidth

尺寸，每个虚线的大小，作为一个尺寸值或尺寸资源，只有当设置android:dashGap才有效。

例子：

XML文件存于res/drawable/gradient_box.xml,如代码清单5-37所示:

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

代码清单5-37

把此XML布局应用到一个视图的形状drawable，如代码清单5-38所示：

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

代码清单5-38

应用程序代码获得形状drawable，应用到视图，如代码清单5-39所示：

Resources res = getResources();

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

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

代码清单5-39

5.4 菜单资源

一个菜单资源定义了一个应用程序菜单（选项菜单，上下文菜单或子菜单），可以与MenuInflater配合使用。
文件的位置：

res/menu/filename.xml

文件名将被用作资源ID。

编译的资源数据类型：

资源指针到菜单（或子类）的资源。

资源参考：

Java: R.menu.filename In XML:@[package:]menu.filename

XML: @[package:]menu.filename

语法，如代码清单5-40所示：

<?xml version="1.0" encoding="utf-8"?>

<menu xmlns:android="http://schemas.android.com/apk/res/android">

    <item android:id="@[+][package:]id/resource_name"

          android:title="string"

          android:titleCondensed="string"

          android:icon="@[package:]drawable/drawable_resource_name"

          android:onClick="method name"

          android:showAsAction=["ifRoom" | "never" | "withText" | "always" | "collapseActionView"]

          android:actionLayout="@[package:]layout/layout_resource_name"

          android:actionViewClass="class name"

          android:actionProviderClass="class name"

          android:alphabeticShortcut="string"

          android:numericShortcut="string"

          android:checkable=["true" | "false"]

          android:visible=["true" | "false"]

          android:enabled=["true" | "false"]

          android:menuCategory=["container" | "system" | "secondary" | "alternative"]

          android:orderInCategory="integer" />

    <group android:id="@[+][package:]id/resource name"

           android:checkableBehavior=["none" | "all" | "single"]

           android:visible=["true" | "false"]

           android:enabled=["true" | "false"]

           android:menuCategory=["container" | "system" | "secondary" | "alternative"]

           android:orderInCategory="integer" >

        <item />

    </group>

    <item >

        <menu>

          <item />

        </menu>

    </item>

</menu>

代码清单5-40

元素：

<menu>

需要。这必须是根节点。包含的<item> /或 <group>的元素。

属性：

xmlns:android

XML命名空间。必需的。定义XML命名空间，它必须

是"http://schemas.android.com/apk/res/android"。

<item>

一个菜单项。可能包含<menu>的元素（子菜单）。必须有一个<menu>或<group>元素。

属性：

android:id

资源ID。独特的资源ID。此项目创建一个新的资源ID，使用的形式："@+id/ name "。

加符号表示,这应该被视为一个新的ID创建的。

android:title

字符串资源。作为一个字符串资源或原始字符串的菜单标题。

android:titleCondensed

字符串资源。一个简明标题作为一个字符串资源或原始字符串。

是用于正常的标题过长的情况下，这个称号。

android:icon

绘制的资源。菜单项图标的图像。

android:onClick

方法的名称。这个菜单项被点击时要调用的方法。该方法必须声明为公共Activity和接受的MenuItem作为其唯一的参数，这表明该项目点击。这种方法比标准的回调到，优先onOptionsItemSelected()。看到在底部的例子。

注意：如果您使用ProGuard（或类似的工具）混淆您的代码，可以肯定你指定的类名肯定被重命名了，它可以破坏这个功能。

android:showAsAction

关键字。何时以及如何一个动作项显示在动作栏。当一个Activity界面包含ActionBar(API等级11引入)，一个菜单项能作为动作项出现。有效值：

值	描述
ifRoom	如果有足够的空间，这个值会使菜单项显示在Action Bar上。
withText	分开
never	这个值使菜单项永远都不出现在Action Bar上
always	在操作栏中，始终显示这个项目。避免使用，除非该项目总是出现在操作栏中，它的关键。设置多个项目总是出现行动项目可能会导致他们与其他UI在操作栏重叠。
collapseActionView	认为这个行动项目（如宣布相关的android:actionLayout或android:actionViewClass）的行动是可折叠的。API等级14介绍。

android:actionLayout

布局资源。使用动作视图布局。API等级11引入

android:actionViewClass

类的名称。为完全合格的类名作为行动视图查看使用。例如，

"android.widget.SearchView" 使用搜索查看作为一个动作视图。

注意：如果您使用ProGuard（或类似的工具）混淆您的代码，可以肯定你指定的类名肯定被重命名了，它可以破坏这个功能。API等级11引入

android:actionProviderClass

类的名称。例如，"android.widget.ShareActionProvider"使用ShareActionProvider

注意：如果您使用ProGuard（或类似的工具）混淆您的代码，可以肯定你指定的类名肯定被重命名了，它可以破坏这个功能。API等级14引入

android:alphabeticShortcut

字符。一个字符为字母快捷键。

android:numericShortcut

整数。一些数字快捷键。

android:checkable

布尔。“真”，如果该项目是检验的。

android:checked

布尔。“真”，如果该项目被默认选中。

android:visible

布尔。“真”，如果该项目是默认可见。

android:enabled

布尔。“真”，如果该项目是默认启用的。

android:menuCategory

关键字。相应的菜单 CATEGORY_ * 常量，它定义了该项目的优先级值。有效值：

值	描述
container	项目是容器的一部分
system	对于系统提供的项目
secondary	对于项目的用户提供二次选项（很少使用）
alternative	项目，是对当前显示的数据替代行动

android:orderInCategory

整数。该项目的“重要性”的顺序，一个组内。

<group>

菜单组（创建一个共享的特征，如他们是否是可见的，启用，或托运的物品的集合）。包含一个或多个的<item>元素。必须一个子<menu>元素。

属性：

android:id

资源ID。独特的资源ID。此项目创建一个新的资源ID，使用的形式："@+id/name"。加符号表示，这应该被视为一个新的ID创建的。

android:checkableBehavior

关键字。组托运的行为类型。有效值：

值	描述
none	不可检查
all	可以检查所有项目（使用复选框）
single	只有一个项目可以检查（使用单选按钮）

android:visible

布尔。如果组是可见的“真实”。

android:enabled

布尔。“真”，如果该组已启用。

android:menuCategory

关键字。相应的菜单 CATEGORY_ * 常量，它定义组的优先级值。有效值：

值	描述
container	团体是一个容器的一部分
system	对于系统提供的组
secondary	对于群体的用户提供二次选项（很少使用）
alternative	团体，是对当前显示的数据替代action

android:orderInCategory

整数。默认类别内的项目顺序。

例如：XML文件保存在 res/menu/example_menu.xml，如代码清单5-41所示:

<menu xmlns:android="http://schemas.android.com/apk/res/android">

    <item android:id="@+id/item1"

          android:title="@string/item1"

          android:icon="@drawable/group_item1_icon"

          android:showAsAction="ifRoom|withText"/>

    <group android:id="@+id/group">

        <item android:id="@+id/group_item1"

              android:onClick="onGroupItemClick"

              android:title="@string/group_item1"

              android:icon="@drawable/group_item1_icon" />

        <item android:id="@+id/group_item2"

              android:onClick="onGroupItemClick"

              android:title="@string/group_item2"

              android:icon="@drawable/group_item2_icon" />

    </group>

    <item android:id="@+id/submenu"

          android:title="@string/submenu_title"

          android:showAsAction="ifRoom|withText" >

        <menu>

            <item android:id="@+id/submenu_item1"

                  android:title="@string/submenu_item1" />

        </menu>

    </item>

</menu>

代码清单5-41

下面的应用程序代码膨胀从菜单onCreateOptionsMenu（菜单）回调，也定义了按钮回调两个项目，如代码清单5-42所示：

public boolean onCreateOptionsMenu(Menu menu) {

    MenuInflater inflater = getMenuInflater();

    inflater.inflate(R.menu.example_menu, menu);

    return true;

}



public void onGroupItemClick(MenuItem item) {

    // 所有其他菜单item处理可以通过onOptionsItemSelected()

}

代码清单5-42

注：android:showAsAction仅适用于的Android 3.0（API等级11）和以上。

5.5 字符串资源

字符串资源为应用程序提供可选样式和格式的文本字符串。应用程序可以使用三种类型的字符串资源：
String

提供了一个字符串的XML资源。

String Array

提供了一个字符串数组的资源。

Quantity Strings (Plurals)

提供同一个单词或者词组不固定重复组成的字符串资源

5.5.1 String

单个字符串可以被应用程序或者其它资源文件（如XML布局文件）引用。

注意：单个字符串资源是只能通过提供的name属性（而不是XML文件名）进行引用。所以，在一个XML文件中，可以在

<resource>元素下组合引用字符串和其他简单资源。

文件位置：

res/values/filename.xml

filename文件名是可以自定义的。<string>元素的name属性值会被用作资源的ID号。

编译资源数据类型：

指向字符串的资源指针。

资源引用：

JAVA：R.string.string_name

XML：@string/string_name

语法，如代码清单5-43所示：

<?xml version="1.0" encoding="utf-8"?>

<resources>

    <string

        name="string_name"

        >text_string</string>

</resources>

代码清单5-43

元素：

必须定义的。必须是根节点。没有属性值。

一个字符串，可以包含样式标签。

属性：

name

字符串。标识字符串的名字。这个名字将被用作资源ID.

例子：

XML文件保存为res/values/strings.xml，如代码清单5-44所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="hello">Hello!</string>
</resources>

代码清单5-44

XML布局文件把字符串应用到一个视图中, 如代码清单5-45所示:

<TextView
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/hello" />

代码清单5-45

应用程序通过以下代码返回一个字符串, 如代码清单5-46所示:

String string = getString(R.string.hello);

代码清单5-46

可以通过getString(int)或者getText(int)取回一个字符串。 getText(int)将保留所有应用到字符串的文本样式。

5.5.2 String Array

由可以被应用程序引用的字符串组成的数组

注意：字符串数组是只能通过提供的name属性（而不是XML文件名）进行引用的简单资源。所以，在一个XML文件中，可以在<resource>元素下组合引用字符串和其他简单资源。

文件定位：

res/values/filename.xml

filename文件名是可以自定义的。<string-array>元素的name属性值会被用作资源的ID号。

编译资源数据类型：

指向字符串数组的资源指针。

资源引用：

JAVA：R.string.string_array_name

语法, 如代码清单5-47所示：

<?xml version="1.0" encoding="utf-8"?>

<resources>
    <string-array
        name="string_array_name">
        <item
            >text_string</item>
    </string-array>
</resources>

代码清单5-47

元素：

必须定义的。必须是根节点。没有属性值。

<string-array>

定义一个字符串数组，可以包含一个或多个<item>标签。

属性：

name

字符串。标识字符串数组的名字。这个名字将被用作该数组的资源ID.

<item>

一个字符串，可以包含样式标签。值可以是对其它字符串资源的引用，必须是<string-array>元素的子元素。没有属性。

例子

XML文件保存为res/values/strings.xml, 如代码清单5-48所示:

<?xml version="1.0" encoding="utf-8"?>

<resources>

    <string-array name="planets_array">

        <item>Mercury</item>

        <item>Venus</item>

        <item>Earth</item>

        <item>Mars</item>

    </string-array>

</resources>

代码清单5-48

应用程序通过代码返回字符串数组, 如代码清单5-49所示:

Resources res = getResources();

String[] planets = res.getStringArray(R.array.planets_array);

代码清单5-49

5.5.3 大量 Strings

不同的语言对数量进行描述的语法规则也不同。比如在英语里，数量1是个特殊情况，我们写成“1 book”，但其他任何数量都要写成“n books”。这种单复数之间的区别是很普遍的，不过其他语言会有更好的区分方式。Android支持的全集包括zero、one、 two、few、many和other。决定选择和使用某种语言和复数的规则是非常复杂的，所以Android提供了诸如getQuantityString()的方法来选择合适的资源。

注意，要按照语法规则来建立可选项。在英语里，即使数量为0，字符串零（zero）也不需要建立。因为0在英语语法表达上和2没有区别，和其他除1以外的任何数字都没有差别（"zero books", "one book", "two books"，等等）。不要被“two听起来似乎只能用于数量2” 之类的事误导。某语言可能需要2、12、102和1一样形式表示，而又与其他数的形式都不同。

如果和应用程序的风格一致，常可以用诸如“Books: 1”的模糊数量形式来避免使用数量字符串。

注意：复数字符串是只能通过提供的name属性（而不是XML文件名）进行引用的简单类型资源。所以，在一个XML文件中，可以在<resource>元素下组合引用字符串和其他简单资源。

文件定位：

res/values/filename.xml

filename文件名是可以自定义的。<plurals>元素的name属性值会被用作资源的ID号。

资源引用：

在JAVA文件中：R.plurals.plural_name

语法，如代码清单5-50所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <plurals
        name="plural_name">
        <item
            quantity=["zero" | "one" | "two" | "few" | "many" | "other"]
            >text_string</item>
    </plurals>
</resources>

代码清单5-50

元素：

必须定义的。必须是根节点。没有属性值。

一个字符串集，每个数量表示提供一个字符串。可以包含一个或多个<item>标签。

属性：

name

字符串。标识字符串集的名字。这个名字将被用作该数组的资源ID.

<item>

一个单数或复数形式的字符串。可以是对其他字符串资源的引用。必须是<plurals>元素的子元素。

属性：

quantity

关键字。表示要使用此字符串的数量值。以下是合法的值（括号内列出部分语言要求）：

Class/Interface	描述
zero	语言需要对数字0进行特殊处理。（比如阿拉伯语）
one	语言需要对类似1的数字进行特殊处理。（比如英语和其它大多数语言里的1；在俄语里，任何以1结尾但不以11结尾的数也属于此类型。）
two	语言需要对类似2的数字进行特殊处理。（比如威尔士语）
few	语言需要对较小数字进行特殊处理（比如捷克语里的2、3、4；或者波兰语里以2、3、4结尾但不是12、13、14的数。）
many	语言需要对较大数字进行特殊处理（比如马耳他语里以11-99结尾的数）
other	语言不需要对数字进行特殊处理。

例子，如代码清单5-51所示:

XML文件保存为res/values/strings.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <plurals name="numberOfSongsAvailable">
        <item quantity="one">One song found.</item>
        <item quantity="other">%d songs found.</item>
    </plurals>
</resources>

代码清单5-51

XML文件保存为res/values-pl/strings.xml，如代码清单5-52所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <plurals name="numberOfSongsAvailable">
        <item quantity="one">Znaleziono jedną piosenkę.</item>
        <item quantity="few">Znaleziono %d piosenki.</item>
        <item quantity="other">Znaleziono %d piosenek.</item>
    </plurals>
</resources>

代码清单5-52

JAVA代码，如代码清单5-53所示:

int count = getNumberOfsongsAvailable();
Resources res = getResources();
String songsFound = res.getQuantityString(R.plurals.numberOfSongsAvailable, count, count);

代码清单5-53

在使用getQuantityString()方法时，如果字符串包含数字格式化串，则需要传递2个count参数。例如：对于字符串“%d songs found”，第一个count参数选择合适的复数字符串，第二个count参数插入占位符%d中。如果复数字符串资源不包含格式化信息，就不需要给getQuantityString()传递第三个参数。

5.5.4 Formatting和Styling

下面是关于字符串资源格式化和样式应该了解的比较重要的地方。

省略号和引号的转义

如果字符串里包含撇号或引号，必须进行转义，或者把整个串封闭在与当前引号不同的成对的引号内。下面是一些有效或无效的字符串示例，如代码清单5-54所示:

<string name="good_example">"This'll work"</string>
<string name="good_example_2">This\'ll also work</string>
<string name="bad_example">This doesn't work</string>
<string name="bad_example_2">XML encodings don&apos;t work</string>

代码清单5-54

1.字符串的格式化

如果需要使用String.format(String, Object...)。格式化字符串，可以把格式化参数放在字符串（string）资源里。比如存在以下资源，如代码清单5-55所示:

<string name="welcome_messages">Hello, %1$s! You have %2$d new messages.</string>

代码清单5-55

此例中存在两个参数：%1$s是个字符串，%2$d 是个数字，在应用程序中可以用如下方式用参数来格式化字符串，如代码清单5-56所示:

Resources res = getResources();
String text = String.format(res.getString(R.string.welcome_messages), username, mailCount);

代码清单5-56

2.用HTML标记来样式化

可以用HTML 标记来为字符串加入样式。如代码清单5-57所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="welcome">Welcome to <b>Android</b>!</string>
</resources>

代码清单5-57

支持以下HTML元素：

◆<b>文本加粗bold。

◆<i>文本变斜体italic。

◆<u>文本加下划线underline。

有时可能要创建一个样式化的文本资源，并可作为格式化串使用。通常这不能生效，因为String.format(String,Object...)方法会去除字符串内的所有的样式信息。解决方法是写入一段转义后的HTML标记，然后在格式化后再用fromHtml(String)恢复出这些样式。例如：

将样式化的文本资源存储为转义后的HTML字符串，如代码清单5-58所示:

<resources>
  <string name="welcome_messages">Hello, %1$s! You have &lt;b>%2$d new messages&lt;/b>.</string>
</resources>

代码清单5-58

在这个格式化字符串里，加入了一个元素。注意左尖括号是用标记&lt转义过的HTML。

按照通常方式格式化字符串，并调用fromHtml(String)把HTML文本转换成带样式的文本，如代码清单5-59所示:

Resources res = getResources();
String text = String.format(res.getString(R.string.welcome_messages), username, mailCount);
CharSequence styledText = Html.fromHtml(text);

代码清单5-59

因为fromHtml(String)方法会格式化所有的HTML内容，所以要确保用htmlEncode(String)对带格式化文本的字符串内所有可能的HTML字符进行转义。比如，如果要把可能包含诸如“<”或“&”等字符的串作为参数传给String.format()，那么在格式化之前必须对这些字符进行转义。格式化之后再把字符串传入fromHtml(String)，这些特殊字符就能还原成本来意义了，如代码清单5-60所示:

String escapedUsername = TextUtil.htmlEncode(username);

Resources res = getResources();

String text = String.format(res.getString(R.string.welcome_messages), escapedUsername, mailCount);

CharSequence styledText = Html.fromHtml(text);

代码清单5-60

5.6 样式（Style）

一个样式资源定义了格式并寻找一个UI。一个样式能被应用到个别的View中或者整个Activity或应用程序中。更多关于创建和应用风格的实例，我们在上一篇的（11章样式和主题）中已经讲述。注意：一个样式一个简单的通过name属性来引用的资源。所以你可以在一个XML文件中结合样式资源和其他简单的资源，只要在<resources>节点下即可。

文件位置:

res/values/filename.xml
文件名任意。

资源引用:

XML: @[package:]style/style_name

语法，如代码清单5-61所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <style
        name="style_name"
        parent="@[package:]style/style_to_inherit">
        <item
            name="[package:]style_property_name"
            >style_value</item>
    </style>
</resources>

代码清单5-61

节点:

必须的。这是一个根节点。没有属性

<style>

定义一个单一的样式。包含<item>节点

属性:

name

String。必须的。作为样式的一个名字，由View，Activity或应用程序来引用。

parent

样式资源。从一个继承的样式属性中引用一个样式

<item>

定义一个单一的样式属性。必须是<style>节点的子节点。

属性:

name

属性资源。必须的。这个名字的样式属性将被定义，用一个包的前缀是个不错的选择。（例如android:textColor）。

实例:

样式的XML文件（保存在res/values/下），如代码清单5-62所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <style name="CustomText" parent="@style/Text">
        <item name="android:textSize">20sp</item>
        <item name="android:textColor">#008</item>
    </style>
</resources>

代码清单5-62

XML文件应用样式到TextView中 (保存在res/layout/下)，如代码清单5-63所示:

<?xml version="1.0" encoding="utf-8"?>
<TextView
    style="@style/CustomText"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="Hello, World!" />

代码清单5-63

5.7 更多资源类型

这个页面定义了更多可以外部化的资源类型,包括:

Bool（布尔）

XML资源,承载布尔值

Color （颜色）

XML资源，承载颜色值（一个16进制的颜色）

Dimension（尺码）

XML资源，承载尺码值 (带有一个度量单位)

XML资源，为程序资源和组件提供一个唯一的标识

Integer

XML资源，承载一个整形值

Integer Array

XML资源，承载一个整形数组

Typed Array

XML资源，提供一个TypedArray (你可以将这个TypedArray作为一个drawables数组)

5.7.1 Bool

在XML中定义一个布尔值。

注意:bool是一种简单的资源，它用name属性提供的值来引用(而不是XML文件的名称)。这样,你可以将bool资源与其他简单的资源放在一个XML文件中的元素里。

文件位置:

res/values/filename.xml

文件名是任意的。< bool >元素的名称name将用作资源ID。

资源引用:

Java: R.bool.bool_name

XML: @[package:]bool/bool_name

语法，如代码清单5-64所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <bool
        name="bool_name"
        >[true | false]</bool>
</resources>

代码清单5-64

元素：

必须，而且必须是根节点。没有属性。

Bool

值:true或false。

属性:

name

类型为String字符串。一个bool值的名称。该名称将用作资源ID。

例如，XML文件保存在 res/values-small/bools.xml，如代码清单5-65所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <bool name="screen_small">true</bool>
    <bool name="adjust_view_bounds">true</bool>
</resources>

代码清单5-65

5.7.2 Color

在XML中定义一个颜色值。颜色被指定为RGB值和alpha通道。你可以在任何地方使用color资源，只要它接受十六进制的颜色值表示。当XML文件需要drawable资源时，也可以使用color资源(例如,android:drawable="@color/green")。

值通常以#字符开头，接着Alpha-Red-Green-Blue（阿尔法-红-绿-蓝）信息，以下面的某种格式：

#RGB

#ARGB

#RRGGBB

#AARRGGBB

注意:color是一种简单的资源，它用name属性提供的值来引用(而不是XML文件的名称)。这样,你可以将color资源与其他简单的资源放在一个XML文件中的元素里。

文件位置:

res/values/colors.xml

文件名任意。<color>节点的名字将被用于资源ID。

资源应用:

Java: R.color.color_name

XML: @[package:]color/color_name

语法，如代码清单5-66所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color
        name="color_name"
        >hex_color</color>
</resources>

代码清单5-66

节点:

必须的。这个必须的根节点。没有属性

<color>

一种用十六进制表示的颜色,如上所述

属性:

name

String。一个颜色的名字。它将被用于资源ID。

例如，XML文件保存在res/values/colors.xml，如代码清单5-67所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
   <color name="opaque_red">#f00</color>
   <color name="translucent_red">#80ff0000</color>
</resources>

代码清单5-67

这个应用程序代码检索资源的颜色，如代码禽蛋5-68所示:

Resources res = getResources();
int color = res.getColor(R.color.opaque_red);

代码清单5-68

这个布局的XML应用颜色属性到TextView中，5-69所示：

<TextView
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:textColor="@color/translucent_red"
    android:text="Hello"/>

代码清单5-69

5.7.3 Dimension

一个dimension值定义在XML中。一个dimension通过一定数量的计量单位指定。例如: 10px, 2in, 5sp. 以下测量单位是android支持的:

Density-independent Pixels (分辨率无关的像素) - 基于屏幕上的物理密度的抽象单位。这些单位是相对于一个160 DPI（点每英寸）屏幕，其中1DP是大致相等为1px。在分辨率较高的屏幕上运行时，绘制1dp的像素数量按比例扩大，扩大基于屏幕的dpi。同样，在分辨率较低的屏幕上时，1DP使用的像素数缩减。 dp-to-pixel的比例会随屏幕分辨率改变，但不一定成正比。使用dp单位（而不是像素单位），是一个简单的解决方案，以使你的布局调整大小视图的尺寸适应不同的屏幕分辨率。换句话说，它为不同设备上的UI元素提供了一致的真实大小。

Scale-independent Pixels(大小无关的像素)- 这个和dp单位很像，但是它基于用户的字体大小偏爱来调整。当指定字体大小时，推荐你使用这种单位，所以他们为屏幕分辨率和用户偏爱来调整。

Points - 1/72英寸基于物理尺寸的屏幕。

Pixels(像素)对应于屏幕上的实际像素。这个测量单位以并不推荐,因为实际的显示可能在不同设备;每个设备可能有不同数量的像素,可能有更多或者更少的像素点在屏幕上可见。

Millimeters(毫米)-基于物理屏幕的大小。

Inches(英寸)- 基于物理屏幕的大小。

注意:dimension是一种简单的资源，它用name属性提供的值来引用(而不是XML文件的名称)。这样,你可以将dimension资源与其他简单的资源放在一个XML文件中的<resources>元素里。

文件位置:

res/values/filename.xml

文件名是任意的。元素的名称将用作资源ID。

资源引用:

Java: R.dimen.dimension_name

XML: @[package:]dimen/dimension_name

语法, 如代码清单5-70所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <dimen
        name="dimension_name"
        >dimension</dimen>
</resources>

代码清单5-70

元素:

必须的。必要的根节点，没有属性

<dimen>

一个dimension,通过一个float表示，可以使用以下单位(dp, sp, pt, px, mm, in)

属性:

name

Stringdimension的名字，被用做资源ID

例如，XML文件保存在res/values/dimens.xml下，如代码清单5-71所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <dimen name="textview_height">25dp</dimen>
    <dimen name="textview_width">150dp</dimen>
    <dimen name="ball_radius">30dp</dimen>
    <dimen name="font_size">16sp</dimen>
</resources>

代码清单5-71

应用程序代码检索一个dimension，如代码清单5-72所示:

Resources res = getResources();
float fontSize = res.getDimension(R.dimen.font_size);

代码清单5-72

这个布局的XML文件应用dimensions属性，如代码清单5-73所示:

<TextView
    android:layout_height="@dimen/textview_height"
    android:layout_width="@dimen/textview_width"
    android:textSize="@dimen/font_size"/>

代码清单5-73

5.7.4 ID

XML中定义的一个唯一的资源。使用你在元素中提供的name,Android开发工具在项目中的R.java类里创建一个唯一的整数,你可以使用它作为应用程序资源的标识符(例如,在你的UI布局中的View)或一个唯一的整数,用在你的程序代码中(例如,作为一个对话框的ID或result代码)。注意:ID是一种简单的资源，它用name属性提供的值来引用(而不是XML文件的名称)。这样,你可以将dimension资源与其他简单的资源放在一个XML文件中的元素里，并在<resources>节点下。同样，记住，ID资源并不是引用一个真实的资源项；它仅仅是一个唯一的ID你可以附加到其他资源，或者当作你程序中的唯一整数。

文件位置:

res/values/filename.xml
文件名任意

资源引用:

Java: R.id.name
XML: @[package:]id/name

语法，如代码清单5-74所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <item
        type="id"
        name="id_name" />
</resources>

代码清单5-74

例如，XML文件保存在res/values/ids.xml，如代码清单5-75所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <item type="id" name="button_ok" />
    <item type="id" name="dialog_exit" />
</resources>

代码清单5-75

然后，这个layout布局文件的片段用"button_ok"作为一个Button窗体的ID，如代码清单5-76所示:

<Button android:id="@id/button_ok"
    style="@style/button_style" />

代码清单5-76

注意,android:id值在id引用中不包括加号,因为id已经存在,在上面的ids.xml例子中定义了。(当你为一个XML资源指定一个ID，使用加上加号——用格式 android:id="@+id/name"——意味着“name”ID是不存在的,应该被创建)。

另一个例子,下面的代码片段使用“dialog_exit“ID作为一个对话框的惟一标识符: showDialog(R.id.dialog_exit) ，如代码清单5-77所示:

showDialog(R.id.dialog_exit);

代码清单5-77

在同一个应用程序中,当创建一个对话框时“dialog_exit“ID用来对比，如代码清单5-78所示:

protected Dialog onCreateDialog(int)(int id) {
    Dialog dialog;
    switch(id) {
    case R.id.dialog_exit:
        ...
        break;
    default:
        dialog = null;
    }
    return dialog;

}

代码清单5-78

5.7.5 Integer

定义在XML中的整数。

注意:integer是一种简单的资源，它用name属性提供的值来引用(而不是XML文件的名称)。这样,你可以将integer资源与其他简单的资源放在一个XML文件中的元素里。

文件位置:

res/values/filename.xml
文件名任意。<integer> 元素的name将被用做资源ID。

资源引用:

Java: R.integer.integer_name
XML: @[package:]integer/integer_name

语法，如代码清单5-79所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <integer
        name="integer_name"
        >integer</integer>
</resources>

代码清单5-79

元素:

必须。根节点，无属性。

一个integer型值

属性:

name

String。Integer的名字。被用于资源ID

例如，XML文件保存在res/values/integers.xml，如代码清单5-80所示:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <integer name="max_speed">75</integer>
    <integer name="min_speed">5</integer>
</resources>

代码清单5-80

在应用程序中用代码检索一个整数，如代码清单5-81所示:

Resources res = getResources();
int maxSpeed = res.getInteger(R.integer.max_speed);

代码清单5-81

5.7.6 Integer Array

XML中定义的整型数组

注意:integer array是一种简单的资源，它用name属性提供的值来引用(而不是XML文件的名称)。这样,你可以将integer array资源与其他简单的资源放在一个XML文件中的元素里。

文件位置:

res/values/filename.xml
文件名任意。<integer-array> 元素的name将被用做资源ID。

资源引用:

Java: R.integer.integer_name
XML: @[package:]array.integer_array_name

语法，如代码清单5-82所示:

<?xml version="1.0" encoding="utf-8"?>

<resources>

    <integer-array

        name="integer_array_name">

        <item

            >integer</item>

    </integer-array>

</resources>

代码清单5-82

元素:

必须。根节点，无属性。

<integer-array>

定义了整数数组。包含一个或多个子<item>元素。

属性:

name

String。Integer的名字。被用于资源ID

<item>

一个integer值。这个值能被另一个integer资源引用。必须是<integer-array>的子节点。无属性

例如，XML文件保存在res/values/integers.xml，如代码清单5-83所示:

<?xml version="1.0" encoding="utf-8"?>

<resources>

    <integer-array name="bits">

        <item>4</item>

        <item>8</item>

        <item>16</item>

        <item>32</item>

    </integer-array>

</resources>

代码清单5-83

在应用程序中用代码检索一个整数数组，如代码清单5-84所示:

Resources res = getResources();

int[] bits = res.getIntArray(R.array.bits);

代码清单5-84

5.7.7 Typed Array

TypedArray在XML中定义。您可以使用它来创建一个其他资源的数组,比如drawables。请注意数组不需要类型一致,所以你可以创建一个混合不同资源类型的数组,但你必须知道有什么数据类型，以及数据类型在数组的什么位置，这样就可以通过TypedArray的get…()方法正确的获得每一个item。

文件位置:

res/values/filename.xml
文件名任意。< array> 元素的name将被用做资源ID。

编译资源数据类型:

TypedArray类型的资源指针

资源引用:

Java: R.array.array_name
XML: @[package:]array.array_name

语法，如代码清单5-85所示:

<?xml version="1.0" encoding="utf-8"?>

<resources>

    <array

        name="integer_array_name">

        <item>resource</item>

    </array>

</resources>

代码清单5-85

元素:

必须。根节点，无属性。

<array>

定义了一个数组。包含一个或多个子<item>元素。

属性:

name

String。数组的名字。被用于资源ID

<item>

一个通用类型资源。这个值能被引用到一个资源或者简单数据类型。必须是<array>的子节点。无属性

例如，XML文件保存在res/values/arrays.xml，如代码清单5-86所示:

<?xml version="1.0" encoding="utf-8"?>

<resources>

    <array name="icons">

        <item>@drawable/home</item>

        <item>@drawable/settings</item>

        <item>@drawable/logout</item>

    </array>

    <array name="colors">

        <item>#FFFF0000</item>

        <item>#FF00FF00</item>

        <item>#FF0000FF</item>

    </array>

</resources>

代码清单5-86

这个应用程序代码检索每个数组,如代码清单5-87所示:

Resources res = getResources();

TypedArray icons = res.obtainTypedArray(R.array.icons);

Drawable drawable = icons.getDrawable(0);

TypedArray colors = res.obtainTypedArray(R.array.colors);

int color = colors.getColor(0,0);

代码清单5-87

本文来自jy02432443，是本人辛辛苦苦一个个字码出来的，转载请保留出处，并保留追究法律责任的权利 QQ78117253

posted @ 2013-12-23 13:51 jy02432443 阅读(1237) 评论(0) 编辑收藏举报

会员力量，点亮园子希望

刷新页面返回顶部

第三部分：Android 应用程序接口指南---第三节：应用程序资源---第五章 资源类型

第5章 资源类型

5.1 动画

5.2 颜色状态列表

5.3 Drawable资源

5.4 菜单资源

5.5 字符串资源

5.6 样式（Style）

5.7 更多资源类型

公告

第三部分：Android 应用程序接口指南---第三节：应用程序资源---第五章资源类型

第5章资源类型