API 参考文档的使用

第 3 章 Android 应用层程序的开发方式

3.2 API 参考文档的使用

Activity

extends ContextThemeWrapper

implements ComponentCallbacks KeyEvent.Callback LayoutInflater.Factory View.On CreateContextMenuListener Window.Callback

java.lang.Object

↳ android.content.Context

↳ android.content.ContextWrapper ↳ android.view.ContextThemeWrapper ↳ android.app.Activity

Known Direct Subclasses

ActivityGroup, AliasActivity, ExpandableListActivity, ListActivity

Known Indirect Subclasses

LauncherActivity, PreferenceActivity, TabActivity

android.view.ContextThemeWrapper，并且被 ActivityGroup, ListActivity 等几个类直接继承。被 LauncherActivity 等几个类间接继承。

Inherited Constants

（继承的常量的列表，按照继承类的顺序）

Public Constructors （公共的构造函数）

（详细的介绍） Known Direct Subclasses CompoundButton

CompoundButton A button with two states, checked and unchecked.

Known Indirect Subclasses

CheckBox, RadioButton, ToggleButton

XML attributes

See Button Attributes, TextView Attributes, View Attributes Summary

Button 类的头部信息和普通的类基本相同，但是包含了 XML attributes 一个

项目，在这里包含了 Button Attributes，TextView Attributes，View Attributes，根

据类的继承关系可以得知，这个启示是自己的属性、父类的属性（Button 类的父

类是 android.widget.TextView ）、祖父类的属性（ Button 类的祖父类是

android.view.View 可以得到这些属性的列表。每个属性包含了 Attribute Name（属性名称） Related Method（相关方法） Description（描述）几个项目。

例如，TextView 的几个属性如下所示：

android:text setText(CharSequence) Text to display.

android:textColor setTextColor(ColorStateList) Text color.

android:text 等表示了属性在 XML 文件中的名称，setText()等表示了在 JAVA 源文件中使用的方法，最右侧的内容是这个属性的描述。

点击 XML attributes 中的连接可以进入其详细的内容中查看，这些 XML 属性的帮助以及相关的值可以在 android.R.styleable 类中查找，这个类也可以直接被调出，方法为：

Package Index → android → android.R.styleable

android.R.styleable 中列出了一些类的 XML 属性，例如 TextView 的 capitalize 属性的相关内容如下所示：

public static final int TextView_capitalize

If set, specifies that this TextView has a textual input method and should automatically capitalize what the user types. The default is "none".

Must be one of the following constant values.

Constant Value Description

none 0 Don't automatically capitalize anything.

sentences 1 Capitalize the first word of each sentence.

words 2 Capitalize the first letter of every word.

characters 3 Capitalize every character.

This corresponds to the global attribute resource symbol capitalize.

Constant Value: 44 (0x0000002c)

这里列出了属性的值（Value），这些值的本质是整数常量，但是在 XML 中使用的还是名称。整数值是 Android 内部运作使用的。

XML 属性有些是在布局文件中使用的，也有在 AndroidManifest.xml 中使用的，或者在其他的 XML 文件中使用。

这在 android.R.styleable 的帮助信息中，以 AndroidManifest 为开头的内容是在 AndroidManifest.xml 中使用的属性。

例如，AndroidManifestAction 项目是 AndroidManifest.xml 中的 Action 标签中使用的内容，如下所示：

public static final int[] AndroidManifestAction

Android入门到精通详解

Attributes that can be supplied in an AndroidManifest.xml action tag, a child of the intent-filter tag. See addAction(String) for more information.

Includes the following attributes:

Attribute Summary

android:name The name of an action that is handled, using the Java-style naming convention.

Attribute Summary 中的 android:name 引用的内容是 AndroidManifest.xml 中的 Action 标签可以使用的 android:name 属性。

相比各种类的帮助信息，接口（Interface）的帮助信息更加简单一些。一般的接口是需要被实现才能够使用的。

例如，View.OnClickListener 的帮助信息前面的内容如下所示：

public static interface View.OnClickListener

android.view.View.OnClickListener

Known Indirect Subclasses

CharacterPickerDialog, KeyboardView

这里的，android.view.View.OnClickListener 表示了 View.OnClickListener 这个接口在 android.view 这个包中。对于一个接口，Indirect Subclasses 的含义为实现

（

implements

）这个接口。

第 4 章 Android 应用程序示例

 

4.1 HelloActivity 程序的运行 4.2 HelloActivity 的源文件结构 4.3 HelloActivity 的编译结构 4.4 SkeletonApp 的程序的运行 4.5 SkeletonApp 源文件结构 4.6 SkeletonApp 编译结构

Android入门到精通详解

在软件开发的最初阶段，通常使用一个 Hello World 程序作为最简单的示例，

本部分介绍一个 Android 中最简单应用程序，通过这部分内容可以了解到 Android 程序的文件结构和编译后的结构。

4.1 HelloActivity 程序的运行

HelloActivity 是一个简单的 Android 应用程序，其工程文件名称为 HelloActivity，在 Android 的源代码和 SDK 中，都包含了这个包。

HelloActivity 的图标和运行情况如图所示。

图 HelloActivity 的图标和运行情况

4.2 HelloActivity 的源文件结构

HelloActivity 工程中另有一个 tests 目录，其中也具有自己的 Android.mk 和 AndroidManifest.xml 文件，这是另一个工程，是 HelloActivity 工程的测试程序。

4.2.1．Android.mk 文件

# Only compile source java files in this apk.

LOCAL_SRC_FILES := $(call all-java-files-under, src) LOCAL_PACKAGE_NAME := HelloActivity

Android入门到精通详解

LOCAL_SDK_VERSION := current include $(BUILD_PACKAGE)

# Use the following include to make our test apk.

include $(call all-makefiles-under,$(LOCAL_PATH))

Android.mk 文件是 Android 编译过程中通用的工程管理文件，本地程序、

本地库和 Java 程序包都使用这个文件。这个文件仅仅在基于源代码开发的情况中使用，在 Java 应用程序工程的管理中，该文件不用定义过多的内容，其中关键的内容是使用 include $(BUILD_PACKAGE)表示从当前目录编译 Java 应用程序包。 LOCAL_PACKAGE_ NAME 定义的是这个程序的 APK 包的名称。 LOCAL_MODULE_TAGS 表示这个包的类型。

这个包的 LOCAL_MODULE_TAGS 定义成了 samples，这将编译 APK 包，

但是不安装在系统中。使用不同的值，可以决定是否编译和安装，例如使用 eng，

package="com.example.android.helloactivity">

<intent-filter>

com/example/android/helloactivity 中寻找程序中的 Java 源代码。活动名称将被定义为 HelloActivity，表示活动的代码是上述源代码目录中的 HelloActivity.java 文件。 intent-filter 中的内容指定了程序的启动方式，这里 category 中的 android.intent.category.LAUNCHER 表示活动将在 Android 的桌面（Android 默认的桌面程序名称也是 LAUNCHER）上出现。

这里指定 application 的 android:label 为"Hello，Activity!"，这和桌面图标下面的文字以及活动启动后上面的标题文字是一致的。本例没有指定图标，所以桌面上的图标使用的是默认图标。

在 AndroidManifest.xml 文件中为一个活动指定 label（标签）和 icon（图标）

的方法如下所示：

<activity android:name="HelloActivity"

android:label="@string/label_name"

android:icon="@drawable/icon_name" >

<intent-filter>

</intent-filter>

</activity>

android:label 指定为字符串、android:icon 指定为图标后，将使用 res/drawable 中对应名称的图片文件作为图标（本例中将使用 icon_name.png）。

activity 和 application 都具有 android:label 和 android:icon 等属性，由于活动是程序的单元，且应用可以包含多个活动，因此程序首先将使用 activity 中的这

public class HelloActivity extends Activity { public HelloActivity() { }

@Override

public void onCreate(Bundle savedInstanceState) { // 重载 onCreate()方法 super.onCreate(savedInstanceState);

setContentView(R.layout.hello_activity); // 使用 hello_activity.xml 布局文件

Android入门到精通详解

} }

这里的类 HelloActivity 继承实现了 Android 系统 API 提供的活动类

（Activity），使用 setContentView(R.layout.hello_activity)指定了当前活动的布局，

这里表示将从 res/layout 目录中找到 hello_activity.xml 文件作为本例的布局文件使用。

android:layout_height="fill_parent"

android:textSize="18sp"

<string name="hello_activity_text_text">Hello, World!</string>

</resources>

4.3 HelloActivity 的编译结构

在 Android 的 SDK 环境开发中，HelloActivity 工程经过编译后，SDK 环境下开发生成的所有目标文件均在当前工程目录中，包含了 assets、bin、gen 等目录。

在 gen 目录中，包含了以类的层次关系为结构的资源文件。例如，gen/com/

example/android/helloactivity 目录中的 R.java 就是 HelloActivity 中的资源文件。

在 bin 目录中，目录结构按照类的关系组织，com/example/android/helloactivity 子目录包含了经过编译后的各个 Java 类，以.class 为后缀。

在 bin 目录中包含的 classes.dex 文件是编译后的，可以在 Dalvik 虚拟机上运行的 Java 的字节码文件，生成的 HelloActivity.apk 文件是最终的 APK 文件，可以在兼容的 Android API 的目标系统中安装，进而运行程序。

SkeletonApp 是 Android 中一个应用程序的框架，这个程序比 HelloActivity 复杂一些，这个程序的运行结果如图所示：

Android入门到精通详解

图 SkeletonApp 程序的运行

这个程序包含了两个按钮和菜单，两个按钮分别用于清除编辑文本框中的内

容，菜单的功能和两个按钮时是相同的，点击菜单按钮将出现菜单，菜单是

Android 中的标准组件。

图使用 SkeletonApp 程序中的按钮和菜单

4.5 SkeletonApp 的源文件结构

SkeletonApp 工程的源文件的结构按照目录树的方式如下所示：

SkeletonApp/

|-- Android.mk （工程管理文件）

|-- AndroidManifest.xml （工程描述文件）

|-- res （资源文件）

| |-- drawable

| | `-- violet.jpg （图片文件）

| |-- layout

| | `-- skeleton_activity.xml （布局文件）

| `-- values

| |-- colors.xml （颜色资源文件）

| |-- strings.xml （字串资源文件）

| `-- styles.xml （样式资源文件）

|-- src （Java 源代码文件）

Android入门到精通详解

`-- com

`-- example `-- android

`-- skeletonapp

`-- SkeletonActivity.java

在 SkeletonApp 中，资源目录 res 中的 values 目录中除了 strings.xml 文件，还包含了 colors.xml 和 styles.xml 文件，这两种文件也是 Android 中的标准资源文件。

colors.xml 文件的内容如下所示：

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

</resources>

styles.xml 文件的内容如下所示：

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

<item name="android:layout_width">wrap_content</item>

<item name="android:layout_height">wrap_content</item>

@style/TextAppearance.ActionButton</item>

</style>

</style>

<item name="android:textStyle">italic</item>

</style>

</resources>

资源目录 res 还包含了 drawable 目录，表示可以绘制的内容，这里的 violet.jpg 是一个 jpeg 的文件。

在布局文件 skeleton_activity.xml 中的部分内容引用了以上的资源

<LinearLayout

android:layout_width="wrap_content"

android:layout_height="wrap_content"

<ImageView android:id="@+id/image"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:paddingLeft="4dip" android_paddingRight="4dip"

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

<Button android:id="@+id/clear" style="@style/ActionButton"

android:text="@string/clear" android:textColor="@color/red" />

</LinearLayout>

布局文件中引用了上面的资源，颜色可以作为字体的颜色， style/ActionButton 作为按钮的样式，drawable/semi_black 表示了背景的内容，

drawable/violet 表示引用 violet.jpg 图片作为图像的内容。例如根据上面 styles.xml 文件中的定义，两个按钮上的字体为斜体，第二个按钮的字体红色。

JAVA 源代码 SkeletonActivity.java 中构建了菜单、按钮的动作等功能。

4.6 SkeletonApp 的编译结构

在这里 drawable 中图片文件保持原状，layout 中的布局文件经过 aapt 处理成为压缩的文本文件，其他的资源文件在最终的程序包中，不再单独存在。

Android入门到精通详解

第 5 章 Android 应用程序的内容

 

5.1 Android 应用程序的感念性描述 5.2 应用程序包含的各个文件

5.3 使用 am 工具启动 Android 应用程序

5.1 Android 应用程序的概念性描述

 内容提供者（Content Provider）。

一个 Android 应用程序是一个包(Package)，包中可能包含一个或者多个

广播接收器用于让应用程序对一个外部事件做出响应。例如：电话呼入事件、

 进程正在屏幕的最前端运行一个与用户交互的 Activity（它的 onResume()方法被调用）；

 进程有一个正在运行的 BroadcastReceiver （它的 BroadcastReceiver.onReceive()方法正在执行）；

 进程有一个 Service，并且在 Service 的某个方法（Service.onCreate()、

Service.onStart()或者 Service.onDestroy()）内有正在执行的代码。

（2）可见（Visible）进程

对话框之后，就可能出现这种进程。这样的进程很重要，一般不允许被杀死，除非为了保证前台进程的运行不得不这样做。

（3）服务（Service）进程

有一个已经用 startService() 方法启动的 Service，虽然这些进程用户无法直接

看到，但它们做的事情却是用户所关心的（例如：后台 MP3 回放或后台网络数

均进入不可见状态（被完全覆盖）。

图活动（Activity）的生命周期

Android入门到精通详解

 活动被恢复的情景：当界面上最前面的活动退出后，它所覆盖的活动将被恢复，这时 onResume()方法将被调用，活动重新转入前台运行。

 活动完全退出的情景：当使用回退（Back）按钮退出活动时，onDestroy() 方法将被调用，活动关闭。如果系统缺少内存时，也会杀死（kill）后台的活动，其中优先杀死不可见的活动，可见的活动一般不会被杀死。

2．服务的生命周期

服务可以长时间运行，它的特点是没有可视化界面，服务的生命周期如图 2

所示。

图服务（Service）的生命周期

使用 StartService 运行服务的情景：使用这种方法启动服务，服务的 onCreate() 和 onStart()这两个方法将被调用，服务会在后台运行直到退出，退出时将调用 onDestroy()方法。

使用 bindService 运行服务的情景：使用这种方法启动服务，调用者（也就是服务的客户端）将获得和服务交互的类，通过其调用时服务的相关内容会处于活动状态。

3．广播接收器的生命周期

Android入门到精通详解

广播接收器有一个单一的回调方法 onReceive()，当广播消息到达接收器时，

Java 源代码 AndroidManifest.xml 资源文件

的字节码集成在一起。资源文件和 AndroidManifest.xml 文件通过 aapt 工具进行处

理。

5.3 使用 am 工具启动 Android 应用程序

am instrument [-r] [-e <ARG_NAME> <ARG_VALUE>] [-p <PROF_FILE>]

[-w] <COMPONENT>

使用 am start 是其中的一个功能，INTENT 使用的选项如下所示：

[-a <ACTION>] [-d <DATA_URI>] [-t <MIME_TYPE>]

[-c <CATEGORY> [-c <CATEGORY>] ...]

[-e|--es <EXTRA_KEY> <EXTRA_STRING_VALUE> ...]

[--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE> ...]

[-e|--ei <EXTRA_KEY> <EXTRA_INT_VALUE> ...]

[-n <COMPONENT>] [-f <FLAGS>] [<URI>]

主要的参数是使用-a 指定使用的动作（action），使用-d 指定数据（data），

使用 URI 的格式，使用-n 指定组件。

例如：使用 am 启动应用程序的格式如下所示：

# am start -n {包名}/{包名}.活动名

启动 Android 设置工具的命令如下所示：

# am start -n com.android.settings/com.android.settings.Settings

启动 Android 计算器程序的命令如下所示：

# am start -n com.android.calculator2/com.android.calculator2.Calculator

启动 Android 录音机程序的命令如下所示：

# am start -n

com.android.soundrecorder/com.android.soundrecorder.SoundRecorder

# am start -n com.android.camera/com.android.camera.VideoCamera

启动 Android 音乐浏览器的命令如下所示：

# am start -n com.android.music/com.android.music.MusicBrowserActivity

启动 Android 视频浏览器的命令如下所示：

# am start -n com.android.music/com.android.music.VideoBrowserActivity

启动 Android 网络浏览器等的命令如下所示：

# am start -n com.android.browser/com.android.browser.BrowserActivity

在上面的程序中，有些程序位于同一个包中，例如：音乐浏览器和视频浏览器都在 Music 包中，照相机和摄像机都在 Camera 包中。

对于某些具有附加数据的应用程序，还可以使用-d 选项增加数据 URL，示例如下所示：

# am start -n com.android.music/com.android.music.MediaPlaybackActivity -d /a.mp3

# am start -n com.android.music/com.android.music.MediaPlaybackActivity -d file: ///a.mp3

# am start -n com.android.camera/com.android.camera.MovieView -d file:///b.mp4

# am start -n com.android.camera/com.android.camera.MovieView -d /b.mp4

# am start -n com.android.camera/com.android.camera.ViewImage -d file:///c.jpg

以上程序分别进行了音乐播放、视频播放、图片浏览等功能。 com.android.music. MediaPlaybackActivity 、 com.android.camera.MovieView 和 com.android.camera.ViewImage 分别是对应的应用程序。

对于上述内容，还可以使用 mime type 方式启动程序，如下所示：

# am start -a android.intent.action.VIEW -d file:///a.mp3 -t audio/*

# am start -a android.intent.action.VIEW -d file:///b.mp4 -t video/*

# am start -a android.intent.action.VIEW -d file:///c.jpg -t image/*

这里使用的是 am -a 参数，表示执行一个动作，后面的 audio/、video/和 image/*表示数据 mime 类型，Android 将自动找到支持相应数据 mime 类型的程序来打开对应的音乐、视频和图片文件。

Android入门到精通详解

第三篇 Android 的 UI 系统实现第 6 章 UI 的基本外形和控制

 

6.1 控制和基本事件的响应 6.2 键盘事件的响应

6.3 运动事件的处理

6.4 屏幕间的跳转和事件的传递 6.5 菜单的使用

6.6 弹出对话框

6.7 样式的设置

Android UI 系统的知识结构如下图所示：

本小节介绍在 Android 中几种基本的程序控制方法，要获得的效果是通过 2 个按钮来控制一个文本框的背景颜色，其运行结果如图所示：

图控件事件的响应

6.1.1．事件响应方法

本例构建一个应用程序，其在 AndroidManifest.xml 描述文件中的内容如下所示：

<intent-filter>

</intent-filter>

</activity>

本例定义了一个 Android 中基本的活动。

android:orientation="vertical">

<TextView android:id="@+id/text1"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_gravity="center"

android:textSize="24sp"

android:text="@string/text1" />

<Button android:id="@+id/button1"

android:layout_width="80sp"

android:layout_height="wrap_content"

android:layout_gravity="center"

android:text="@string/red"/>

<Button android:id="@+id/button2"

android:layout_width="80sp"

android:layout_height="wrap_content"

android:layout_gravity="center"

android:text="@string/green"/>

public class TestEvent1 extends Activity {

private static final String TAG = "TestEvent1";

public TestEvent1() { }

@Override

public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);

setContentView(R.layout.testevent);

final TextView Text = (TextView) findViewById(R.id.text1); // 获得句柄

final Button Button1 = (Button) findViewById(R.id.button1);

final Button Button2 = (Button) findViewById(R.id.button2);

Android入门到精通详解

Button1.setOnClickListener(new OnClickListener() { // 实现行为功能 public void onClick(View v) {

Text.setBackgroundColor(Color.RED);

} });

Button2.setOnClickListener(new OnClickListener() { public void onClick(View v) {

根据 Button 控件的 setOnClickListener()设置了其中的点击行为，这个方法的参数实际上是一个 View.OnClickListener 类型的接口，这个接口需要被实现才能够使用，

因此在本例的设置中，实现了其中的 onClick()函数。这样既可实现点击的时候实现相应的功能，在点击的函数中，将通过 Text 的句柄对其进行控制。

在 Android 的控件使用方面，这两个编程方面要点是：

 使用 findViewById()获取布局文件（XML）中控件的句柄；

 使用 setOnXXXListener()设置事件处理函数。

在获取句柄时需要转换成相应的控件类型，findViewById()函数的参数是一个整数，返回值是一个 android.view.View 类型。通过 R.id.XXX 找到布局文件中定义的 ID，

然后通过将基础类转换成其实际的类获得真正的句柄。注意：所转换类必须和布局文件中描述的控件一致。

SetOnXXXListener()等函数是 android.view.View 类的函数，各种控件（包括

Button、EditText）都扩展这个类，同族的函数包括：

这些函数用于事件处理，它们由程序实现，通过设置这些内容也就设置了控件的行为。这些函数的参数都是所对应的 android.view.View 类中的方法。

Android 中 UI 基本控制内容：使用 findViewById()联系布局文件中控件和句柄，

并通过 OnClickListener()等定制句柄的行为。

public class TestEvent2 extends Activity implements OnClickListener { // 实现相关的接口

public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);

setContentView(R.layout.testevent);

mText = (TextView) findViewById(R.id.text1);

public void onClick(View v) {

断，参数是一个 View 类型，通过 getId()获得它们的 ID，使用 switch…case 分别进行处理。

public class TestEvent3 extends Activity{

Button2_OnClickListener();

public TestEvent3() { }

class Button1_OnClickListener implements OnClickListener { // 接口的第一个实现

public void onClick(View v) {

mText.setBackgroundColor(Color.RED);

} }

class Button2_OnClickListener implements OnClickListener { // 接口的第一个实现

public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);

setContentView(R.layout.testevent);

mText = (TextView) findViewById(R.id.text1);

final Button mButton1 = (Button) findViewById(R.id.button1);

final Button mButton2 = (Button) findViewById(R.id.button2);

mButton1.setOnClickListener(mListener1); // 设置监听者的类 mButton2.setOnClickListener(mListener2); // 设置监听者的类

} }

本例通过定义实现活动类中的 2 个子类，来实现 View.OnClickListener 这个接口，

这种方式是一种最为直接的方式，即为不同的控件单独实现它的相应类。

图按键事件的响应

本例的布局文件 testkeyevent.xml 如下所示：

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

android:id="@+id/screen"

android:layout_width="fill_parent"

android:layout_height="fill_parent"

android:orientation="vertical">

<TextView android:id="@+id/alphavalue"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_gravity="center"/>

<ImageView android:id="@+id/image"

android:src="@drawable/robot"

android:layout_gravity="center"

android:layout_width="wrap_content"

android:layout_height="wrap_content" />

</LinearLayout>

本例包含了一个文本框和一个显示图片的控件，这样可以文本框用作显示当前的

Alpha 的比例值，显示图片的控件 ImageView 用于显示一个图片。

import android.graphics.*;

public class TestKeyEvent extends Activity {

private static final String TAG = "TestKeyEvent";

private ImageView mImage;

private TextView mAlphavalueText;

private int mAlphavalue;

@Override

protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);

setContentView(R.layout.testkeyevent);

mImage = (ImageView) findViewById(R.id.image);

mAlphavalueText = (TextView) findViewById(R.id.alphavalue);

mAlphavalue = 100;

public boolean onKeyDown(int keyCode, KeyEvent msg){

Log.v(TAG, "onKeyDown: keyCode = "+ keyCode);

mAlphavalueText.setText("Alpha = " + mAlphavalue*100/0xff + "%");

return super.onKeyDown(keyCode, msg);

} }

Android入门到精通详解

本例子使用 onKeyDown()函数来获得按键的事件，同类的函数还包括 onKeyUp() 函数，其参数 int keyCode 为按键码，KeyEvent msg 表示按键事件的消息（其中包含了更详细的内容）。

上面打出的 log 信息为：

VERBOSE/TestKeyEvent(771): onKeyDown: keyCode = 20

VERBOSE/TestKeyEvent(771): onKeyDown: String = KeyEvent{action=0 code=20 repeat=0 meta=0 scancode=108 mFlags=8}

基本上通过 keyCode 可以获得是哪一个按键响应，而通过 msg 除了按键码之外，

public boolean onTouchEvent(MotionEvent event) public boolean onTrackballEvent(MotionEvent event)

在以上 2 个函数中，MotionEvent 类作为参数传入，在这个参数中可以获得运动事件的各种信息。

本例介绍另外触摸屏事件的程序，这个程序在 UI 的界面中，显示当前的

MotionEvent 的动作和位置。

图触摸屏程序的运行结果

本例的程序的代码如下所示：

package com.android.basicapp;

import android.app.Activity;

import android.content.Context;

import android.os.Bundle;

import android.util.Log;

import android.view.MotionEvent;

import android.widget.TextView;

public class TestMotionEvent extends Activity {

private static final String TAG = "TestMotionEvent";

TextView mAction;

TextView mPostion;

@Override

protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);

setContentView(R.layout.testmotionevent);

mAction = (TextView)findViewById(R.id.action);

mPostion = (TextView)findViewById(R.id.postion);

}

@Override

public boolean onTouchEvent(MotionEvent event) { int Action = event.getAction();

Android入门到精通详解

float X = event.getX();

float Y = event.getY();

Log.v(TAG, "Action = "+ Action );

Log.v(TAG, "("+X+","+Y+")");

mAction.setText("Action = "+ Action);

mPostion.setText("Postion = ("+X+","+Y+")");

return true;

} }

布局文件 testmotionevent.xml 的内容如下所示：

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

android:layout_width="fill_parent"android:layout_height="fill_parent"

android:orientation="vertical">

<TextView android:id="@+id/action"

android:textSize = "20sp"

android:layout_width="wrap_content"

android:layout_height="wrap_content"/>

<TextView android:id="@+id/postion"

android:textSize = "20sp"

android:layout_width="wrap_content"

android:layout_height="wrap_content"/>

</LinearLayout>

另外一个示例程序，当触摸屏按下、移动、抬起的时候，在坐标处绘制不同颜色

的点，在标题栏中显示当时的动作和坐标。程序的结果如图所示：

图触摸屏程序的运行结果

public class TestMotionEvent2 extends Activity {

private static final String TAG = "TestMotionEvent2";

@Override

protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);

setContentView(new TestMotionView(this));

}

public class TestMotionView extends View { private Paint mPaint = new Paint();

mY = 0;

坐标，在 Android 2.0 版本之后，MotionEvent 中还包含了多点触摸的信息，当有多个触点同时起作用的时候，可以获得触点的数目和每一个触点的坐标。

6.4 屏幕间的跳转和事件的传递

在一般情况下，Android 的每一个屏幕基本上就是一个活动（Activity），屏幕之

Intent

Android入门到精通详解

</intent-filter>

</activity>

两个活动的名称分别为 Forwarding 和 ForwardTarget，由于第二个活动没有 intent-filter，因此在程序中只能由第一个活动来启动。

Forward 程序的运行结果如图所示：

图 Forward 程序的运行结果

点击“Go”按钮从 Forward 跳转到 ForwardTarget，这个内容在 Java 源文件 Forward.java 的以下片段中处理：

public void onClick(View v) {

Intent intent = new Intent(); // 建立 Intent intent.setClass(Forwarding.this, ForwardTarget.class); // 设置活动

这里使用的 Intent 的 setClass()的方法的原型如下所示：

Intent setClass(Context packageContext, Class<?> cls)

第一个参数是当前的上下文类型 Context，因此把当前的活动设置过去即可

（Activity 本身继承了 Context），第二个是 Intent 所包含的 JAVA 类，直接设置 ForwardTarget.class 类即可。

android:label="@string/activity_receive_result">

<intent-filter>

</intent-filter>

</activity>

ReceiveResult 程序的运行结果如图所示：

Android入门到精通详解

图 ReceiveResult 程序的运行结果

初始化界面如图所示，点击“Get Result”按钮将跳转到第二个屏幕，如中图所

示；在第二个屏幕中点击“Corky”和“Violet”按钮将返回第一个屏幕，并获得对应

显示，如右图所示。

startActivityForResult (intent, GET_CODE);

} };

这里调用的是 startActivityForResult()方法，设置一个 GET_CODE 为请求代码，

这样可以获得目标活动的返回信息。这个函数的原型为：

public void startActivityForResult (Intent intent, int requestCode)

被跳转的目标的 Java 源文件 SendResult.java 的代码片段如下所示：

private OnClickListener mCorkyListener = new OnClickListener() {

private OnClickListener mVioletListener = new OnClickListener() {

onActivityResult()函数来实现，两个整数类型的参数 requestCode 和 resultCode 分别代表请求代码和结果码，第三个参数 Intent（类型 data）表示活动间交互附加的数据信息。

@Override

protected void onActivityResult(int requestCode, int resultCode, Intent data) {

text.append(") ");

if (data != null) {

text.append(data.getAction());

} }

text.append("\n");

} }

这里 onActivityResult()是一个被继承的函数，其参数 data 就是这个活动作为返回值接受到，data.getAction()可以从返回的 Intent 中取回内容。

这里的参数 requestCode 也是根据当时的在调用 startActivityForResult()的时候指定的返回值。

Android 中使用 Intent 并使用 startActivity()和 startActivityForResult()调用一个新的活动，实现屏幕的跳转功能，调用者可以获得跳转对象的返回信息。

6.5 菜单的使用

菜单是屏幕中比较独立的一个元素，它和普通的控件略有不同，很多 GUI 系统都对菜单有单独的接口和运作方式。在 Android 中具有单独接口，用于在活动中使用菜单。

本例使用一个菜单来控制按钮的背景颜色，从其中可以了解如何在应用程序中使

用菜单。

图菜单示例程序的运行结果

建立菜单和调用的代码片段如下所示：

package com.android.basicapp;

import android.app.Activity;

import android.content.Intent;

import android.os.Bundle;

import android.graphics.Color;

import android.view.View;

import android.view.Menu;

import android.view.Gravity;

import android.view.MenuItem;

import android.widget.Button;

import android.widget.TextView;

import android.view.View.OnClickListener;

import android.util.Log;

public class TestMenu extends Activity {

Android入门到精通详解

private static final String TAG = "TestMenu";

public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);

setContentView(R.layout.testmenu);

mButton = (Button) findViewById(R.id.color_button);

}

@Override

public boolean onCreateOptionsMenu(Menu menu) { super.onCreateOptionsMenu(menu);

public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) {

return super.onOptionsItemSelected(item);

} }

使用菜单主要通过重载 Activity 中的两个函数来实现：

public boolean onCreateOptionsMenu(Menu menu) public boolean onOptionsItemSelected(MenuItem item)

菜单类在 Android 中表示为 android.view.Menu 类。使用这个类可以进行一些更为细节的设置和操作。

abstract MenuItem add(int groupId, int itemId, int order, CharSequence title) abstract MenuItem add(int groupId, int itemId, int order, int titleRes)

add()的第 1、2 个参数是整数值，分别代表按钮项的组 ID 和选项 ID，第 3 个参数用于设置按钮上的文件。

6.6 弹出对话框

在 GUI 程序中，有时需要弹出对话框来提示一些信息。这些对话框比一个独立的屏幕简单，在 Android 中弹出式对话框不同于表示一个屏幕的活动，它通常用于简单的功能处理。

对话框的父类是 android.app.Dialog，通过构建类 android.app.AlertDialog 来实现弹出式对话框，可以使用 AlertDialog.Builder 和不同的参数来构建对话框。

参考示例程序：Dialog（ApiDemo => App=>Dialog）

源代码：com/example/android/apis/app/AlertDialogSamples.java 布局文件：alert_dialog.xml

Dialog 程序的运行结果如图所示：

Android入门到精通详解

图 Dialog 程序的运行结果

通过点击屏幕上的不同按钮（第 4 个按钮除外）将会启动不同的对话框。

实现方法是继承 onCreateDialog()函数，返回一个 Dialog 类型：

@Override

protected Dialog onCreateDialog(int id) { }

onCreateDialog()函数的参数 id 是区分对话框的标示，当调用对话框的时候需要调用 showDialog()。

public final void showDialog (int id)

showDialog()函数也是通过 id 来区分对话框。通过 showDialog()和 onCreateDialog() 函数可以统一活动中的对话框。

6.6.1. 提示信息和两个按钮的对话框

第 1 个按钮（OK Cancel dialog with a message）启动一个提示信息和两个按钮的

对话框，如图所示：

.setIcon(R.drawable.alert_dialog_icon)

.setTitle(R.string.alert_dialog_two_buttons_title)

.setPositiveButton(R.string.alert_dialog_ok, new DialogInterface.OnClickListener() {

public void onClick(DialogInterface dialog, int whichButton) { /* 左键事件 */

} })

.setNegativeButton(R.string.alert_dialog_cancel, new DialogInterface.OnClickListener() {

public void onClick(DialogInterface dialog, int whichButton) { /* 右键事件 */

} })

其中，setPositiveButton 表示设置的左面的按钮，setNegativeButton 表示设置的右面的按钮，这两个按钮是确定的，但是可以设置其显示的字符和点击后的行为函数。

6.6.2. 提示信息和三个按钮的对话框

第 2 个按钮（OK Cancel dialog with a long message）启动一个提示信息和三个按钮的对话框，如图所示：

Android入门到精通详解

图提示信息和三个按钮的对话框

代码实现的片断如下所示：

return new AlertDialog.Builder(AlertDialogSamples.this) .setIcon(R.drawable.alert_dialog_icon)

.setTitle(R.string.alert_dialog_two_buttons_msg) .setMessage(R.string.alert_dialog_two_buttons2_msg)

.setPositiveButton(R.string.alert_dialog_ok, new DialogInterface.OnClickListener() {

public void onClick(DialogInterface dialog, int whichButton) { /* 左键事件 */

} })

.setNeutralButton(R.string.alert_dialog_something, new DialogInterface.OnClickListener() {

public void onClick(DialogInterface dialog, int whichButton) { /* 中键事件 */

} })

.setNegativeButton(R.string.alert_dialog_cancel, new DialogInterface.OnClickListener() {

图列表项对话框

代码实现的片断如下所示：

return new AlertDialog.Builder(AlertDialogSamples.this) .setTitle(R.string.select_dialog)

.setItems(R.array.select_dialog_items, new

DialogInterface.OnClickListener() {

public void onClick(DialogInterface dialog, int which) { String[] items =

getResources().getStringArray(R.array.select_dialog_items);

new AlertDialog.Builder(AlertDialogSamples.this)

.setMessage("You selected: " + which + " , " + items[which]) .show();

} })

这里使用了 setItems()表示设置几个不同的项目，从 res/values/array.xml 文件中取得 select_dialog_items 的内容，这部分内容如下所示：

<string-array name="select_dialog_items">

<item>Command one</item>

<item>Command two</item>

<item>Command three</item>

<item>Command four</item>

</string-array>

这里的 Item 也设置了点击函数，因此它们被点击后，也会弹出新的对话框。

Android入门到精通详解

6.6.4. 单选项和按钮对话框

第 5 个按钮（Single choice list）启动一个单选项和按钮对话框；

图单选项和按钮对话框

代码实现的片断如下所示：

return new AlertDialog.Builder(AlertDialogSamples.this) .setIcon(R.drawable.alert_dialog_icon)

.setTitle(R.string.alert_dialog_single_choice)

.setSingleChoiceItems(R.array.select_dialog_items2, 0, new DialogInterface.OnClickListener() {

public void onClick(DialogInterface dialog, int whichButton) { }

})

.setPositiveButton(R.string.alert_dialog_ok, new DialogInterface.OnClickListener() {

public void onClick(DialogInterface dialog, int whichButton) {

/* 右键事件 */

} })

本例是一个包含单选项的对话框，其中的选项使用了更简单的模式，从 res/values/array.xml 文件中取得 select_dialog_items2 中的内容作为单选项的项目。

这部分的内容如下所示：

<string-array name="select_dialog_items2">

<item>Satellite</item>

<item>Traffic</item>

<item>Street view</item>

</string-array>

6.6.5. 复选项和按钮对话框

第 6 个按钮（Repeat alarm）启动一个复选项和按钮对话框；

图复选项和按钮对话框

代码实现的片断如下所示：

return new AlertDialog.Builder(AlertDialogSamples.this) .setIcon(R.drawable.ic_popup_reminder)

.setTitle(R.string.alert_dialog_multi_choice) .setMultiChoiceItems(R.array.select_dialog_items3,

Android入门到精通详解

new boolean[]{false, true, false, true, false, false, false},

.setPositiveButton(R.string.alert_dialog_ok, new DialogInterface.OnClickListener() {

public void onClick(DialogInterface dialog, int whichButton) { /* 左键事件 */

} })

.setNegativeButton(R.string.alert_dialog_cancel, new DialogInterface.OnClickListener() {

<string-array name="select_dialog_items3">

<item>Every Monday</item>

图文本的按键对话框

代码实现的片断如下所示：

LayoutInflater factory = LayoutInflater.from(this);

final View textEntryView =

factory.inflate(R.layout.alert_dialog_text_entry, null);

return new AlertDialog.Builder(AlertDialogSamples.this) .setIcon(R.drawable.alert_dialog_icon)

.setTitle(R.string.alert_dialog_text_entry) .setView(textEntryView)

.setPositiveButton(R.string.alert_dialog_ok, new DialogInterface.OnClickListener() {

public void onClick(DialogInterface dialog, int whichButton) { /* 左键事件 */

} })

.setNegativeButton(R.string.alert_dialog_cancel, new DialogInterface.OnClickListener() {

alert_dialog_text_entry.xml 也是一个布局文件，其中包含了 2 个文本框和 2 个可

Android入门到精通详解

编辑文本，这就是显示在屏幕上的内容，由此根据这种模式，也可以在弹出的对话框

 setIcon()和 setTitle()：用于设置图标和标题；

 setMessage()：用于设置提示信息；

 setPositiveButton()、setNeutralButton()和 setNegativeButton()：用于设置左、中、

右按钮；

 setSingleChoiceItems()和 setMultiChoiceItems()：用于设置单选项和复选项；

 setView()：用于设置一个 View 作为对话框的内容。

以上函数的返回类型均为 android.app.AlertDialog.Builder，也就是这个类本身，

因此可以使用如下的方式进行连续调用来设置更多的内容。

设置完成后调用 create()函数返回 android.app.AlertDialog 类，这个类表示一个可以使用的对话框。

在 Android 中使用对话框，可以在没有 Activity 的情况下建立一个比较简易的窗

体，基本界面可以通过直接设置得到，通过 setView()可以获得任意内容的界面。

源代码：com/example/android/apis/app/DialogActivity.java 布局文件：custom_dialog_activity.xml

AndroidManifest.xml 中的定义如下所示：

<activity android:name=".app.DialogActivity"

android:label="@string/activity_dialog"

android:theme="@android:style/Theme. Dialog" >

<intent-filter>

</intent-filter>

</activity>

DialogActivity 程序的运行结果如图所示：

图 DialogActivity 程序的运行结果

这个程序本质上是一个活动，但是显示的结果类似于一个小对话框，而且背景是透明的。这个程序的布局文件和源代码都并无特别的地方，效果是通过在 AndroidManifest.xml 中设置其样式（android:theme）为 Theme.Dialog 来实现的，

Theme.Dialog 是 Android 中的预定义样式。

Android入门到精通详解

6.7.2．自定义样式对话框

除了使用 Android 系统中已有的样式，还可是使用自定义的样式。本示例介绍如何使用自定义样式。

参考示例程序：CustomDialogActivity（ApiDemo=>App=>Activity=>CustomDialog）

源代码：com/example/android/apis/app/CustomDialogActivity.java 布局文件：dialog_activity.xml

样式文件：values/styles.xml

AndroidManifest.xml 中的定义如下所示：

<activity android:name=".app.CustomDialogActivity"

android:label="@string/activity_custom_dialog"

android:theme="@style/Theme.CustomDialog“ >

<intent-filter>

</intent-filter>

</activity>

CustomDialogActivity 程序的运行结果如图所示：

图 CustomDialogActivity 程序的运行结果

这个程序和上一个程序基本相同，区别在于样式被设置成了 CustomDialog，

CustomDialog 是一个自定义样式，在 styles.xml 中进行定义，如下所示：

<item name="android:windowBackground">@drawable/filled_box</item>

</style>

CustomDialog 本身是“扩展”了预定的 Dialog 样式，重新定义了窗口的背景为 drawable 中的 filled_box，这里引用了 filled_box.xml 文件，这个文件在 res/drawable 中，其中定义了相关内容。

<padding android:left="10dp" android:top="10dp"

android:right="10dp" android:bottom="10dp" />

android:label="@string/activity_translucent"

android:theme="@style/Theme.Translucent“ >

<intent-filter>

</intent-filter>

</activity>

Android入门到精通详解

<activity android:name=".app.TranslucentBlurActivity"

android:label="@string/activity_translucent_blur"

android:theme="@style/Theme.Transparent“ >

<intent-filter>

</intent-filter>

</activity>

TranslucentActivity 和 TranslucentBlurActivity 程序的运行结果如图所示：

图 TranslucentActivity 和 TranslucentBlurActivity 程序的运行结果

这两个程序使用的都是窗口透明的效果，TranslucentActivity 获得的效果是背景普通的透明，TranslucentBlurActivity 获得的效果是背景模糊的透明。它们的样式被设置成了 Translucent，这是一个用于描述背景透明的自定义样式，在 styles.xml 中定义。

@drawable/translucent_background </item>

</style>

translucent_background 值用于设置窗口的背景为透明，同时设置了 windowNoTitle 表示窗口不包含标题栏。

TranslucentBlurActivity 之所以能够获得背景模糊的效果，是因为在源代码中进行了进一步的设置，如下所示：

public class TranslucentBlurActivity extends Activity { protected void onCreate(Bundle icicle) {

super.onCreate(icicle);

Android入门到精通详解

getWindow().

setFlags(WindowManager.LayoutParams.FLAG_BLUR_BEHIND, WindowManager.LayoutParams.FLAG_BLUR_BEHIND);

setContentView(R.layout.translucent_background);

} }

设置模糊效果是通过窗口管理器（WindowManager）设置参数来完成的，这

种设置只有在背景设置为透明后才能显示效果。

第 7 章控件（Widget）的使用

 

7.1 Android 中控件的层次结构 7.2 基本控件的使用

7.3 自定义的视图

Android入门到精通详解

在各个 GUI 系统中，控件一般都是占内容最多的部分，使用各种控件也是使用一个 GUI 系统的主要内容。

7.1 Android 中控件的层次结构

android.view.View 类（视图类）呈现了最基本的 UI 构造块。一个视图占据

屏幕上的一个方形区域，并且负责绘制和事件处理。View 是 widgets 的基类，常

型来使用。android.view.View 的扩展者也称作 Widget，通常包含在 android.widget 包中，也就是在 UI 中使用的控件。这些 android.view.View 的扩展者，通常可以在应用程序中直接使用，也可以应用程序再扩展一次使用。

在 Android 中各种 UI 类的名称也是它们在布局文件 XML 中使用的标签名称。

android.view.View 的一个重要的扩展者是 android.view.ViewGroup 类，这个类表示一个视图的集合，在这个视图的集合中可以包含众多的子视图。 android.view.ViewGroup 类的扩展者既是多个视图的组合，本身也是一个视图。

7.2 基本控件的使用

Android 中的基本视图是 GUI 中通常直接使用的一些类，例如：字符区域、按钮、

图像区域、图像按钮、进度条等。

7.2.1．普通按钮

这里介绍普通按钮的使用，最普通的按钮是各种 GUI 系统中都类似的按钮，

另外一种 ToggleButton 是具有开关两种状态的按钮。

参考示例程序：Buttons1（ApiDemo=>Views=>Buttons1）

源代码：com/example/android/apis/view/Buttons1.java 布局文件：buttons_1.xml

Buttons1 程序的运行结果如图所示：

Android入门到精通详解

图 Buttons1 程序的运行结果

界面比较简单，前两个按钮是 Button 类，表示普通的按钮；第三个按钮是 ToggleButton 类，表示可以进行开关操作的按钮。

这个活动的源代码很简单，实际上只有布局文件有特殊点。buttons_1.xml 的内容如下所示：

<LinearLayout

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:orientation="vertical">

<Button android:id="@+id/button_normal"

android:text="@string/buttons_1_normal"

android:layout_width="wrap_content"

android:layout_height="wrap_content" />

<Button android:id="@+id/button_small"

style="?android:attr/buttonStyleSmall"

android:text="@string/buttons_1_small"

</LinearLayout>

这里主要引用了 3 个控件，2 个 Button 和 1 个 ToggleButton，它们都是 Android 中预定义的控件。

Button 类的扩展关系如下所示：

=> android.view.View

=> android.widget.TextView => android.widget.Button

Button 类扩展了 TextView 类，TextView 类是 View 的直接扩展者，表示一个文本区域，Android 中以文本为主要内容的各种控件均扩展自这个类。除了按钮之外，TextView 类的另外一个重要的扩展者是可编辑文本区域（EditText）。

按钮类（Button）作为 TextView 类的扩展者，主要的区别表现在外观和使用的方式上，Button 通常要设置处理点击动作的处理器（View.OnClickListener）；

TextView 类虽然也可以设置这个内容，但是通常不需要这样做。

在本例的布局文件中，使用了 android:text 一个属性来定义在 Button 上面显示的文本，根据帮助，这其实是 TextView 中的一个 XML 属性，在这里被 Button

可以显示不同的文本 textOn（开）和 textOff（关），在使用 ToggleButton 时主要根据 CompoundButton 的 isChecked()函数获得其是否选择的状态。

根据 ToggleButton 的帮助可以得知，其特定的 XML 属性包括了以下的内容：

android:disabledAlpha：禁止的时候的 Alpha 值，使用浮点数 android:textOff：定义开状态下显示的文本

Android入门到精通详解

android:textOn：定义开状态下显示的文本 Android 中的控件在使用上涉及的内容包括了：

在 JAVA 源代码中使用的方法在布局文件中使用 XML 属性

每个控件本身涉及的内容包括它直接或者间接扩展的类，以及它自己的独特功能。例如，根据上述的继承关系，TextView 中能使用的所有内容，都可以在 Button 中使用，在 Button 中能使用的内容，都可以在 ToggleButton 中使用。

7.2.2．图像区域

在 UI 界面上显示图片，是一个常常需要使用到的功能。在 Android 中可以使用图像区域是一个可以直接显示图片文件的控件，可以方便显示一个图片。

参考示例程序：ImageView（ApiDemo=>Views=>ImageView）

源代码：com/example/android/apis/view/ImageView1.java 布局文件：image_view_1.xml

ImageView 程序的运行结果如图所示：

图 ImageView 程序的运行结果

程序中的图像都是通过 ImageView 类来实现显示的，ImageView 是 View 的直接扩展者，继承关系如下所示：

void setImageResource (int resId) // 设置图像源的资源 ID void setImageURI(Uri uri) // 设置图像源的 URI

7.2.3．图像按钮

图像按钮是一个带有图片的按钮，从逻辑上可以实现普通按钮功能。图像按钮实际上是结合图像和按钮的双重特性。

参考示例程序：ImageButton（ApiDemo=>Views=>ImageButton）

源代码：com/example/android/apis/view/ImageButton.java 布局文件：image_button_1.xml

ImageButton 程序的运行结果如图所示：

图 ImageButton 程序的运行结果

这里的布局文件的主要内容如下所示：

<ImageButton

android:layout_width="100dip"

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

<ImageButton

android:layout_width="wrap_content"

android:layout_height="wrap_content"

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

示例中使用了 ImageButton 类作为显示一个带有图像的按钮，扩展关系如下

ImageButton 除了可以当作按钮来使用，其他方面和 ImageView 基本一致。

ImageButton 和 ImageView 的区别也仅在于外观和使用方式上，主要的图像设置方法和 ImageButton 中的一样。ImageButton 特定的是具有一个 onSetAlpha()函数：

boolean onSetAlpha(int alpha)

onSetAlpha()函数通过指定 0-255 来指定 Alpha 数值。

事实上，ImageButton 除了在外观上表现成一个按钮的状态，其他方面和 ImageView 基本一样。由于是按钮的功能，在 JAVA 源程序中，ImageButton 通常被设定 OnClickListener 来获得点击时候的响应函数。

由于 JAVA 语言不支持多重继承，因此，在 Android 中图像按钮 ImageButton 只是扩展了 ImageView，和普通按钮 Button 并没有继承（扩展）关系。

ImageButton 有一个扩展者是 ZoomButton，这是一个带有动态缩放功能的图

图 ProgressBar1 程序的运行结果

这里的布局文件 progressbar_1.xml 的主要内容如下所示：

<ProgressBar android:id="@+id/progress_horizontal"

style="?android:attr/progressBarStyleHorizontal"

android:layout_width="200dip"

android:layout_height="wrap_content"

android:max="100"

android:progress="50"

android:secondaryProgress="75" />

标签 ProgressBar 是表示了进度条的控件，扩展关系如下：

=> android.view.View

=> android.widget.ProgressBar

ProgressBar 是 android.view.View 的直接扩展者，在 GUI 界面中实现进度条的功能。ProgressBar 比较特殊的地方是这个类还支持第二个进度条，如示例所示，

第二个进度条在第一个进度条的背后显示，两个进度条的最大值是相同的。

synchronized int getSecondaryProgress () // 获得第二个进度条的进度

ProgressBar 在使用的时候，要注意最大值和当前值的关系，在 UI 上所呈现的状态，其实是当前值和最大值的一个比例。

在本示例程序中，可以通过按钮来控制进度条，这部分内容是在 JAVA 源代码中实现的：

protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);

requestWindowFeature(Window.FEATURE_PROGRESS);

setContentView(R.layout.progressbar_1);

setProgressBarVisibility(true);

final ProgressBar progressHorizontal

= (ProgressBar) findViewById(R.id.progress_horizontal);

setProgress(progressHorizontal.getProgress() * 100);

setSecondaryProgress(progressHorizontal.getSecondaryProgress() * 100);

}

由于这里使用了 requestWindowFeature(Window.FEATURE_PROGRESS)来获得了将进度条设置到标题栏的当中。因此这里调用了几个 Activity 中的函数，用于设置在标题栏中的进度条。

final void setProgress(int progress)

final void setSecondaryProgress(int secondaryProgress) final void setProgressBarVisibility(boolean visible)

其中一个按钮的 onClick()调用如下所示：

事实上，这里调用的 progressHorizontal 是 ProgressBar 类的一个实例，而标

题栏的进度条，是一个单独的内容。

图 ProgressBar1 程序的运行结果

这里的布局文件 ratingbar _1.xml 的主要内容如下所示：

<RatingBar android:id="@+id/ratingbar1"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:numStars="3"

android:rating="2.5" />

<RatingBar android:id="@+id/ratingbar2"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:numStars="5"

android:rating="2.25" />

<LinearLayout

android:layout_width="fill_parent"

android:layout_height="wrap_content"

android:layout_marginTop="10dip">

<TextView android:id="@+id/rating"

android:layout_width="wrap_content"

android:layout_gravity="center_vertical" />

</LinearLayout>

<RatingBar android:id="@+id/indicator_ratingbar"

style="?android:attr/ratingBarStyleIndicator"

android:layout_marginLeft="5dip"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_gravity="center_vertical" />

这里，一共定义了 4 个 RatingBar 标签，RatingBar 的继承关系如下所示：应 setMax()函数）。RatingBar 和 SeekBar 两个类又扩展了 AbsSeekBar，其中 RatingBar 可以直接用星星的方式来表示进度； SeekBar 可以使用可拖拽的小图标。

RatingBar 是 AbsSeekBar 的一个继承者，AbsSeekBar 和 ProgressBar 的一个主要扩展就是其最大值可以设置。在本例的布局文件中，android:numStars 和 android:rating 等几个属性是 RatingBar 自己的属性。

7.2.5．多种控件

图 Controls1 程序的运行结果

在界面中包含了：Button（普通按钮）、EditText（可编辑文本区域）、CheckBox

（复选框）、RadioGroup（单选按钮组）、ToggleButton（开关按钮）、TextView

（文本区域）、Spinner（旋转按钮）等控件，这些内容均在布局文件中定义。

在 Android 中使用各种控件基本的原则是在布局文件中可以实现 UI 的外观，

然后在 JAVA 文件中实现对各种的控件的控制动作。

7.3 自定义的视图

自定义的 View 的含义是通过扩展的方法，实现一个扩展 android.view.View 类的类，这个类的本质也是一个控件，通过它可以直接构建 UI。

参考示例程序：CustomView（ApiDemo=>Views=>CustomView ）

源代码：com/example/android/apis/view/CustomView1.java

图 CustomView 程序的运行结果

布局文件 custom_view_1.xml 的如下所示：

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

在文檔中 Android 入门到精通详解 (頁 58-0)

第 3 章 Android 应用层程序的开发方式

3.2 API 参考文档的使用

android.view.ContextThemeWrapper，并且被 ActivityGroup, ListActivity 等几个类 直接继承。被 LauncherActivity 等几个类间接继承。

Button 类的头部信息和普通的类基本相同，但是包含了 XML attributes 一个

项目，在这里包含了 Button Attributes，TextView Attributes，View Attributes，根

据类的继承关系可以得知，这个启示是自己的属性、父类的属性（Button 类的父

类 是 android.widget.TextView ） 、 祖 父 类 的 属 性 （ Button 类 的 祖 父 类 是

android.view.View 可以得到这些属性的列表。每个属性包含了 Attribute Name（属 性名称） Related Method（相关方法） Description（描述）几个项目。

例如，TextView 的几个属性如下所示：

android:text 等表示了属性在 XML 文件中的名称，setText()等表示了在 JAVA 源文件中使用的方法，最右侧的内容是这个属性的描述。

点击 XML attributes 中的连接可以进入其详细的内容中查看，这些 XML 属性 的帮助以及相关的值可以在 android.R.styleable 类中查找，这个类也可以直接被调 出，方法为：

Package Index → android → android.R.styleable

android.R.styleable 中列出了一些类的 XML 属性，例如 TextView 的 capitalize 属性的相关内容如下所示：

这里列出了属性的值（Value），这些值的本质是整数常量，但是在 XML 中 使用的还是名称。整数值是 Android 内部运作使用的。

XML 属性有些是在布局文件中使用的，也有在 AndroidManifest.xml 中使用 的，或者在其他的 XML 文件中使用。

这在 android.R.styleable 的帮助信息中，以 AndroidManifest 为开头的内容是 在 AndroidManifest.xml 中使用的属性。

例如，AndroidManifestAction 项目是 AndroidManifest.xml 中的 Action 标签中 使用的内容，如下所示：

Attribute Summary 中的 android:name 引用的内容是 AndroidManifest.xml 中 的 Action 标签可以使用的 android:name 属性。

相比各种类的帮助信息，接口（Interface）的帮助信息更加简单一些。一般 的接口是需要被实现才能够使用的。

例如，View.OnClickListener 的帮助信息前面的内容如下所示：

这里的，android.view.View.OnClickListener 表示了 View.OnClickListener 这个 接口在 android.view 这个包中。对于一个接口，Indirect Subclasses 的含义为实现

（

）这个接口。

第 4 章 Android 应用程序示例

4.1 HelloActivity 程序的运行 4.2 HelloActivity 的源文件结构 4.3 HelloActivity 的编译结构 4.4 SkeletonApp 的程序的运行 4.5 SkeletonApp 源文件结构 4.6 SkeletonApp 编译结构

在软件开发的最初阶段，通常使用一个 Hello World 程序作为最简单的示例，

本部分介绍一个 Android 中最简单应用程序，通过这部分内容可以了解到 Android 程序的文件结构和编译后的结构。

4.1 HelloActivity 程序的运行

HelloActivity 是 一 个 简 单 的 Android 应 用 程 序 ， 其 工 程 文 件 名 称 为 HelloActivity，在 Android 的源代码和 SDK 中，都包含了这个包。

HelloActivity 的图标和运行情况如图所示。

4.2 HelloActivity 的源文件结构

HelloActivity 工程中另有一个 tests 目录，其中也具有自己的 Android.mk 和 AndroidManifest.xml 文件，这是另一个工程，是 HelloActivity 工程的测试程序。

4.2.1．Android.mk 文件

Android.mk 文件是 Android 编译过程中通用的工程管理文件，本地程序、

这个包的 LOCAL_MODULE_TAGS 定义成了 samples，这将编译 APK 包，

但是不安装在系统中。使用不同的值，可以决定是否编译和安装，例如使用 eng，

这里指定 application 的 android:label 为"Hello，Activity!"，这和桌面图标下面 的文字以及活动启动后上面的标题文字是一致的。本例没有指定图标，所以桌面 上的图标使用的是默认图标。

在 AndroidManifest.xml 文件中为一个活动指定 label（标签）和 icon（图标）

的方法 如下所示：

android:label 指定为字符串、android:icon 指定为图标后，将使用 res/drawable 中对应名称的图片文件作为图标（本例中将使用 icon_name.png）。

activity 和 application 都具有 android:label 和 android:icon 等属性，由于活动 是程序的单元，且应用可以包含多个活动，因此程序首先将使用 activity 中的这

这 里 的 类 HelloActivity 继 承 实 现 了 Android 系 统 API 提 供 的 活 动 类

（Activity），使用 setContentView(R.layout.hello_activity)指定了当前活动的布局，

这里表示将从 res/layout 目录中找到 hello_activity.xml 文件作为本例的布局文件使 用。

4.3 HelloActivity 的编译结构

在 Android 的 SDK 环境开发中，HelloActivity 工程经过编译后，SDK 环境下 开发生成的所有目标文件均在当前工程目录中，包含了 assets、bin、gen 等目录。

在 gen 目录中，包含了以类的层次关系为结构的资源文件。例如，gen/com/

example/android/helloactivity 目录中的 R.java 就是 HelloActivity 中的资源文件。

在 bin 目录中，目录结构按照类的关系组织，com/example/android/helloactivity 子目录包含了经过编译后的各个 Java 类，以.class 为后缀。

在 bin 目录中包含的 classes.dex 文件是编译后的，可以在 Dalvik 虚拟机上运 行的 Java 的字节码文件，生成的 HelloActivity.apk 文件是最终的 APK 文件，可 以在兼容的 Android API 的目标系统中安装，进而运行程序。

SkeletonApp 是 Android 中一个应用程序的框架，这个程序比 HelloActivity 复杂一些，这个程序的运行结果如图所示：

这个程序包含了两个按钮和菜单，两个按钮分别用于清除编辑文本框中的内

容，菜单的功能和两个按钮时是相同的，点击菜单按钮将出现菜单，菜单是

Android 中的标准组件。

4.5 SkeletonApp 的源文件结构

SkeletonApp 工程的源文件的结构按照目录树的方式如下所示：

SkeletonApp/

|-- Android.mk （工程管理文件）

|-- AndroidManifest.xml （工程描述文件）

|-- res （资源文件）

| |-- drawable

| | `-- violet.jpg （图片文件）

| |-- layout

| | `-- skeleton_activity.xml （布局文件）

| `-- values

| |-- colors.xml （颜色资源文件）

| |-- strings.xml （字串资源文件）

| `-- styles.xml （样式资源文件）

|-- src （Java 源代码文件）

`-- com

`-- example `-- android

`-- skeletonapp

`-- SkeletonActivity.java

在 SkeletonApp 中，资源目录 res 中的 values 目录中除了 strings.xml 文 件，还包含了 colors.xml 和 styles.xml 文件，这两种文件也是 Android 中的标准资 源文件。

colors.xml 文件的内容如下所示：

styles.xml 文件的内容如下所示：

资源目录 res 还包含了 drawable 目录，表示可以绘制的内容，这里的 violet.jpg 是一个 jpeg 的文件。

在布局文件 skeleton_activity.xml 中的部分内容引用了以上的资源

布 局 文 件 中 引 用 了 上 面 的 资 源 ， 颜 色 可 以 作 为 字 体 的 颜 色 ， style/ActionButton 作为按钮的样式，drawable/semi_black 表示了背景的内容，

android.view.ContextThemeWrapper，并且被 ActivityGroup, ListActivity 等几个类直接继承。被 LauncherActivity 等几个类间接继承。

类是 android.widget.TextView ）、祖父类的属性（ Button 类的祖父类是

android.view.View 可以得到这些属性的列表。每个属性包含了 Attribute Name（属性名称） Related Method（相关方法） Description（描述）几个项目。

点击 XML attributes 中的连接可以进入其详细的内容中查看，这些 XML 属性的帮助以及相关的值可以在 android.R.styleable 类中查找，这个类也可以直接被调出，方法为：

这里列出了属性的值（Value），这些值的本质是整数常量，但是在 XML 中使用的还是名称。整数值是 Android 内部运作使用的。

XML 属性有些是在布局文件中使用的，也有在 AndroidManifest.xml 中使用的，或者在其他的 XML 文件中使用。

这在 android.R.styleable 的帮助信息中，以 AndroidManifest 为开头的内容是在 AndroidManifest.xml 中使用的属性。

例如，AndroidManifestAction 项目是 AndroidManifest.xml 中的 Action 标签中使用的内容，如下所示：

Attribute Summary 中的 android:name 引用的内容是 AndroidManifest.xml 中的 Action 标签可以使用的 android:name 属性。

相比各种类的帮助信息，接口（Interface）的帮助信息更加简单一些。一般的接口是需要被实现才能够使用的。

这里的，android.view.View.OnClickListener 表示了 View.OnClickListener 这个接口在 android.view 这个包中。对于一个接口，Indirect Subclasses 的含义为实现

HelloActivity 是一个简单的 Android 应用程序，其工程文件名称为 HelloActivity，在 Android 的源代码和 SDK 中，都包含了这个包。

这里指定 application 的 android:label 为"Hello，Activity!"，这和桌面图标下面的文字以及活动启动后上面的标题文字是一致的。本例没有指定图标，所以桌面上的图标使用的是默认图标。

的方法如下所示：

activity 和 application 都具有 android:label 和 android:icon 等属性，由于活动是程序的单元，且应用可以包含多个活动，因此程序首先将使用 activity 中的这

这里的类 HelloActivity 继承实现了 Android 系统 API 提供的活动类

这里表示将从 res/layout 目录中找到 hello_activity.xml 文件作为本例的布局文件使用。

在 Android 的 SDK 环境开发中，HelloActivity 工程经过编译后，SDK 环境下开发生成的所有目标文件均在当前工程目录中，包含了 assets、bin、gen 等目录。

在 bin 目录中包含的 classes.dex 文件是编译后的，可以在 Dalvik 虚拟机上运行的 Java 的字节码文件，生成的 HelloActivity.apk 文件是最终的 APK 文件，可以在兼容的 Android API 的目标系统中安装，进而运行程序。

在 SkeletonApp 中，资源目录 res 中的 values 目录中除了 strings.xml 文件，还包含了 colors.xml 和 styles.xml 文件，这两种文件也是 Android 中的标准资源文件。

布局文件中引用了上面的资源，颜色可以作为字体的颜色， style/ActionButton 作为按钮的样式，drawable/semi_black 表示了背景的内容，

在这里 drawable 中图片文件保持原状，layout 中的布局文件经过 aapt 处理成为压缩的文本文件，其他的资源文件在最终的程序包中，不再单独存在。

 进程正在屏幕的最前端运行一个与用户交互的 Activity（它的 onResume()方法被调用）；

 进程有一个正在运行的 BroadcastReceiver （它的 BroadcastReceiver.onReceive()方法正在执行）；

对话框之后，就可能出现这种进程。这样的进程很重要，一般不允许被杀死，除非为了保证前台进程的运行不得不这样做。

 活动被恢复的情景：当界面上最前面的活动退出后，它所覆盖的活动将被恢复，这时 onResume()方法将被调用，活动重新转入前台运行。

 活动完全退出的情景：当使用回退（Back）按钮退出活动时，onDestroy() 方法将被调用，活动关闭。如果系统缺少内存时，也会杀死（kill）后台的活动，其中优先杀死不可见的活动，可见的活动一般不会被杀死。

使用 bindService 运行服务的情景：使用这种方法启动服务，调用者（也就是服务的客户端）将获得和服务交互的类，通过其调用时服务的相关内容会处于活动状态。

在上面的程序中，有些程序位于同一个包中，例如：音乐浏览器和视频浏览器都在 Music 包中，照相机和摄像机都在 Camera 包中。

对于某些具有附加数据的应用程序，还可以使用-d 选项增加数据 URL，示例如下所示：

以上程序分别进行了音乐播放、视频播放、图片浏览等功能。 com.android.music. MediaPlaybackActivity 、 com.android.camera.MovieView 和 com.android.camera.ViewImage 分别是对应的应用程序。

这里使用的是 am -a 参数，表示执行一个动作，后面的 audio/、video/和 image/*表示数据 mime 类型，Android 将自动找到支持相应数据 mime 类型的程序来打开对应的音乐、视频和图片文件。

第三篇 Android 的 UI 系统实现第 6 章 UI 的基本外形和控制

根据 Button 控件的 setOnClickListener()设置了其中的点击行为，这个方法的参数实际上是一个 View.OnClickListener 类型的接口，这个接口需要被实现才能够使用，

因此在本例的设置中，实现了其中的 onClick()函数。这样既可实现点击的时候实现相应的功能，在点击的函数中，将通过 Text 的句柄对其进行控制。

在获取句柄时需要转换成相应的控件类型，findViewById()函数的参数是一个整数，返回值是一个 android.view.View 类型。通过 R.id.XXX 找到布局文件中定义的 ID，

然后通过将基础类转换成其实际的类获得真正的句柄。注意：所转换类必须和布局文件中描述的控件一致。

这些函数用于事件处理，它们由程序实现，通过设置这些内容也就设置了控件的行为。这些函数的参数都是所对应的 android.view.View 类中的方法。