Android 中常见控件参考手册
Android
Android
Android
Android 中常见控件参考手册
目录
1 TextView 文本框....................................................................................................................5
1.1 TextView 类的结构.....................................................................................................5
1.2 TextView 类的方法.................................................................................................... 5
1.3 TextView 标签的属性.............................................................................................. 6
1.4 TextView 的使用...................................................................................................... 9
2 EditText 编辑框................................................................................................................... 12
2.1 EditText 类的结构................................................................................................ 12
2.2 EditText 常用的方法............................................................................................ 12
2.3 EditText 标签的主要属性.................................................................................... 12
2.4 EditText 的使用 .................................................................................................. 16
3 Button 按钮.......................................................................................................................... 20
3.1Button 类的结构...................................................................................................... 20
3.2 Button 类的方法.................................................................................................... 20
3.3 Button 标签的属性................................................................................................ 21
3.4 Button 的使用........................................................................................................ 21
4 ImageButton 图片按钮........................................................................................................ 24
4.1 ImageButton 类的结构.......................................................................................... 24
4.1 ImageButton 类常用的方法.................................................................................. 24
4.2 ImageButton 标签的常用属性................................................................................. 24
4.3ImageButton 的使用................................................................................................ 25
5 CheckBox 多项选择............................................................................................................ 27
5.1 CheckBox 类的层次关系........................................................................................ 27
5.2 CheckBox 常用的方法............................................................................................ 27
5.3 CheckBox 的使用.................................................................................................... 27
6 RadioGroup、RadioButton 单项选择................................................................................. 33
6.1 类的层次关系.......................................................................................................... 33
6.2 常用的方法............................................................................................................... 33
6.3RadioButton 和 RadioGroup 的综合使用.............................................................. 35
7 Toast 提示............................................................................................................................ 38
7.1 Toast 类的结构...................................................................................................... 38
7.2 Toast 的常量.......................................................................................................... 38
7.3 Toast 类的方法......................................................................................................... 38
7.4 Toast 的使用实例.................................................................................................. 40
8 Spinner 下拉列表.................................................................................................................43
8.1 Spinner 类的层次关系.......................................................................................... 43
第 1 页 共 169 页
Android 中常见控件参考手册
8.2 Spinner 类的主要方法.......................................................................................... 43
8.3 Spinner 类的属性.................................................................................................. 44
8.4 Spinner 的使用示例.............................................................................................. 45
9 ListView 列表...................................................................................................................... 47
9.1 ListView 类的层次关系........................................................................................ 47
9.2 ListView 的所有方法............................................................................................ 47
9.3 ListView 的属性及包含的几个常量.................................................................... 56
9.4 ListView 的使用示例............................................................................................ 57
9.5 关于 ListView 使用的参考链接............................................................................ 58
10 TabHost 标签页..................................................................................................................60
10.1 TabHost 类的层次关系.......................................................................................... 60
10.2 TabHost 常用的方法............................................................................................ 60
10.3 TabHost 的使用示例.............................................................................................. 63
10.4 补充....................................................................................................................... 64
11 LinearLayout 线性布局......................................................................................................65
11.1 线性布局介绍........................................................................................................ 65
11.2 线性布局的常用属性........................................................................................... 65
11.3 Linear 常用的方法.............................................................................................. 65
11.4 LinearLayout 的使用.......................................................................................... 66
12 FrameLayout 框架布局.................................................................................................... 68
12.1 FrameLayout 的简单介绍.................................................................................... 68
12.2 FrameLayout 的使用............................................................................................ 68
13 TableLayout 表格布局....................................................................................................... 70
13.1 TableLayout 的层次关系.................................................................................... 70
13.2 TableLayout 常用的方法.................................................................................... 70
13.3 TableLayout 常用的属性.................................................................................... 74
13.4 TableLayout 的使用............................................................................................ 76
14 RelativeLayout 相对布局.................................................................................................. 78
14.1 RelativeLayout 类的层次关系.......................................................................... 78
14.2 RelativeLayout 常用的方法.............................................................................. 78
14.3 RelativeLayout 常用的属性.............................................................................. 78
14.4 RelativeLayout 的使用...................................................................................... 79
15 AbsoluteLayout 绝对布局..................................................................................................81
15.1 AbsoluteLayout 层次关系.................................................................................. 81
15.2 AbsoluteLayout 常用的方法.............................................................................. 81
15.3 AbsoluteLayout 常用属性.................................................................................. 81
15.4 AbsoluteLayout 的使用...................................................................................... 83
15.5 补充........................................................................................................................ 84
16 Menu 菜单..........................................................................................................................85
16.1 Menu 的介绍.......................................................................................................... 85
16.2 选项菜单的介绍以及使用.................................................................................... 85
16.3 子菜单的介绍以及使用........................................................................................ 86
16.4 上下文菜单的介绍以及使用................................................................................ 87
17 AutoCompleteTextView 自动提示.................................................................................... 88
第 2 页 共 169 页
Android 中常见控件参考手册
17.1 AutoCompleteTextView 类层次关系.................................................................. 88
17.2 AutoCompleteTextView 常用的方法.................................................................. 88
17.3 AutoCompleteTextView 的实现.......................................................................... 89
17.4 补充........................................................................................................................ 90
18 DatePicker 日期................................................................................................................. 91
18.1 DatePicker 的类层次关系.................................................................................. 91
18.2 DatePicker 的常用方法...................................................................................... 91
18.3 DatePicker 的使用.............................................................................................. 92
19 TimePicker 时间选择器.....................................................................................................95
19.1 Timepicker 类的层次关系.................................................................................. 95
19.2 TimePicker 类常用的方法.................................................................................. 95
19.3 TimePicker 的使用实例...................................................................................... 96
19.4 补充....................................................................................................................... 98
20 Dialog 对话框.................................................................................................................... 99
20.1 Dialog 对话框...................................................................................................... 99
20.2Dialog 的使用........................................................................................................ 99
21 ImageView 图片视图.......................................................................................................104
21.1 ImageView 类的结构.......................................................................................... 104
21.2 ImageView 类属性.............................................................................................. 104
21.3 ImageView 常用的方法...................................................................................... 106
21.4 ImageView 的使用.............................................................................................. 112
21.5 补充..................................................................................................................... 114
22 Gallery 拖动效果............................................................................................................. 115
22. 1 Gallery 类的层次关系.................................................................................... 115
22.2 Gallery 的 XML 属性....................................................................................... 115
22.3 Gallery 类的常用方法...................................................................................... 116
22.4 Gallery 的使用.................................................................................................. 122
22.5 补充..................................................................................................................... 123
23 ImageSwitcher 切换图片.................................................................................................125
23.1 ImageSwitcher 类概述...................................................................................... 125
23.2 ImageSwitcher 常用的方法.............................................................................. 125
23.3 ImageSwitcher 的使用...................................................................................... 126
23.4 补充资料............................................................................................................. 129
24 GridView 网络视图......................................................................................................... 130
24.1 GridView 类概述................................................................................................ 130
24.2 GridView 常用属性............................................................................................ 130
24.3 GridView 常用的方法........................................................................................ 131
24.4 GridView 的简单使用........................................................................................ 133
25 ScrollView 卷轴视图....................................................................................................... 135
25.1 ScrollView 类概述............................................................................................ 135
25.2 ScrollView 常用的方法.................................................................................... 135
25.3 ScrollView 的几个属性.................................................................................... 143
25.4 ScrollView 的使用............................................................................................ 144
25.5 补充资料............................................................................................................. 146
第 3 页 共 169 页
Android 中常见控件参考手册
26 ProgressBar 进度条..........................................................................................................147
26.1 ProgressBar 类概述.......................................................................................... 147
26.2 ProgressBar 常用的方法.................................................................................. 147
26.3 ProgressBar 的使用.......................................................................................... 148
27 SeekBar 拖动条................................................................................................................152
27.1 SeekBar 类概述.................................................................................................. 152
27.2 SeekBar 常用的方法.......................................................................................... 152
27.3 SeekBar 属性...................................................................................................... 153
27.4 SeekBar 的使用.................................................................................................. 153
27.5 补充资料............................................................................................................. 154
28 RatingBar 评分条.............................................................................................................155
28.1 RatingBar 类概述.............................................................................................. 155
28.2 RatingBar 的属性.............................................................................................. 155
28.3 RatingBar 的常用方法...................................................................................... 156
28.4 RatingBar 的使用.............................................................................................. 157
28.5 补充资料............................................................................................................. 159
29 ProgressDialog 对话框中的进度条.................................................................................160
29.1 ProgressDialog 类概述.................................................................................... 160
29.2 ProgressDialog 中常用的方法........................................................................ 160
29.3 ProgressDialog 的使用.................................................................................... 160
30 Notification、NotificationManager 状态栏提示.............................................................164
30.1 概述..................................................................................................................... 164
30.2 Notification 属性............................................................................................ 164
30.3 Notification 的方法........................................................................................ 165
30.4 Notification 的使用........................................................................................ 166
第 4 页 共 169 页
Android 中常见控件参考手册
TextView
1111 TextView
TextView
TextView 文本框文本框文本框文本框
TextView
1.11.11.11.1 TextView
TextView
TextView 类的结构
TextView 是用于显示字符串的组件,对于用户来说就是屏幕中一块用于显
示文本的区域。TextView 类的层次关系如下:
java.lang.Object
↳ android.view.View
↳ android.widget.TextView
直接子类:
Button, CheckedTextView, Chronometer, DigitalClock, EditText
间接子类:
AutoCompleteTextView, CheckBox, CompoundButton, ExtractEditText,M
ultiAutoCompleteTextView, RadioButton, ToggleButton
TextView
1.21.21.21.2 TextView
TextView
TextView 类的方法
主要方法
TextView
getDefaultMovementmethod
getText
功能描述
TextView 的构造方法
获取默认的箭头按键移动方式
获得 TextView 对象的文本
返回值
Null
Movementmethod
CharSquence
length
getEditableText
getCompoundPaddingBottom
setCompoundDrawables
setCompoundDrawablesWithIn
trinsicBounds
setPadding
获得 TextView 中的文本长度
取得文本的可编辑对象,通过 这
个对象可对 TextView 的文本进行
操作,如在光标之后插入字符
返回底部填充物
设置图像显示的位置,在 设置该
Drawable 资 源 之 前 需 要 调 用
setBounds(Rect)
设置 Drawable 图像的显示位置,
但其边界不变
根据位置设置填充物
Int
Void
Int
Void
Void
Void
第 5 页 共 169 页
getAutoLinkMask
setTextColor
setHighlightColor
setShadowLayer
setHintTextColor
setLinkTextColor
setGravity
getFreezesText
Android 中常见控件参考手册
返回自动连接的掩码
设置文本显示的颜色
设置文本选中时显示的颜色
设置文本显示的阴影颜色
设置提示文字的颜色
设置链接文字的颜色
设置当 TextView 超出了文本本身
时横向以及垂直对齐
设置该视图是否包含整个文本,
如果包含则返回真值,否则返回
假值
Void
Void
Void
Void
Void
Void
Void
Boolean
1.3 TextView 标签的属性
XML 属性
属性名称
android:autoLink
android:autoText
描述
设置是否当文本为 URL 链接/email/电话号码/map 时,文
本显示为可点击的链接。可选值
(none/web/email/phone/map/all)
如果设置,将自动执行输入值的拼写纠正。此处无效果,
在显示输入法并输入的时候起作用。
指定 getText()方式取得的文本类别。选项 editable 类
android:bufferType
似于 StringBuilder 可追加字符,
android:capitalize
也就是说 getText 后可调用 append 方法设置文本内容。
设置英文字母大写类型。此处无效果,需要弹出输入法才
能看得到,参见 EditView 此属性说明。
android:cursorVisible
设定光标为显示/隐藏,默认显示。
android:digits
设置允许输入哪些字符。如“1234567890.+-*/%\n()”
在 text 的下方输出一个 drawable,如图片。如果指定一
android:drawableBottom
个颜色的话会把 text 的背景设为该颜色,并且同时和
background 使用时覆盖后者。
android:drawableLeft
在 text 的左边输出一个 drawable,如图片。
android:drawablePadding
设置 text 与 drawable(图片)的间隔,与 drawableLeft、
drawableRight、drawableTop、drawableBottom 一起使
android:drawableRight
android:drawableTop
android:editable
android:editorExtras
android:ellipsize
用,可设置为负数,单独使用没有效果。
在 text 的右边输出一个 drawable,如图片。
在 text 的正上方输出一个 drawable,如图片。
设置是否可编辑。这里无效果,参见 EditView。
设置文本的额外的输入数据。在 EditView 再讨论。
设置当文字过长时,该控件该如何显示。有如下值设
置:”start”—–省略号显示在开头;”end”——省略
第 6 页 共 169 页
Android 中常见控件参考手册
号显示在结尾;”middle”—-省略号显示在中
间;”marquee” ——以跑马灯的方式显示(动画横向移
动)
设置保存文本的内容以及光标的位置。
设置文本位置,如设置成“center”,文本将居中显示。
Text 为空时显示的文字提示信息,可通过 textColorHint
设置提示信息的颜色。比较奇怪的是 TextView 本来就相
当于 Label,怎么会不设置 Text?!
附加功能,设置右下角 IME 动作与编辑框相关的动作,如
actionDone 右下角将显示一个“完成”,而不设置默认是
一个回车符号。这个在 EditView 中再详细说明,此处无
用。
android:freezesText
android:gravity
android:hint
android:imeOptions
android:imeActionId
android:imeActionLabel
设置 IME 动作 ID。在 EditView 再做说明,
设置 IME 动作标签。在 EditView 再做说明。
android:includeFontPadding 设置文本是否包含顶部和底部额外空白,默认为 true。
为文本指定输入法,需要完全限定名(完整的包名)。例
如:com.google.android.inputmethod.pinyin,但是这
android:inputMethod
里报错找不到。
android:inputType
设置文本的类型,用于帮助输入法显示合适的键盘类型。
在 EditView 中再详细说明,这里无效果。
android:linksClickable
设置链接是否点击连接,即使设置了 autoLink。
android:marqueeRepeatLimit
在 ellipsize 指定 marquee 的情况下,设置重复滚动的次
数,当设置为 marquee_forever 时表示无限次。
设置 TextView 的宽度为 N 个字符的宽度。这里测试为一
android:ems
android:maxEms
android:minEms
个汉字字符宽度,如图:
设置 TextView 的宽度为最长为 N 个字符的宽度。与 ems
同时使用时覆盖 ems 选项。
设置 TextView 的宽度为最短为 N 个字符的宽度。与 ems
同时使用时覆盖 ems 选项。
android:maxLength
限制显示的文本长度,超出部分不显示。
android:lines
android:maxLines
设置文本的行数,设置两行就显示两行,即使第二行没有
数据。
设置文本的最大显示行数,与 width 或者 layout_width
结合使用,超出部分自动换行,超出行数将不显示。
android:minLines
设置文本的最小行数,与 lines 类似。
android:lineSpacingExtra
android:lineSpacingMultipli
er
设置行间距。
设置行间距的倍数。如”1.2”
android:numeric
设置后唯一效果是 TextView 有点击效果,此属性在
如果被设置,该 TextView 有一个数字输入法。此处无用,
EdtiView 将详细说明。
第 7 页 共 169 页
Android 中常见控件参考手册
android:password
android:phoneNumber
以小点”.”显示文本
设置为电话号码的输入方式。
android:privateImeOptions 设置输入法选项,此处无用,在 EditText 将进一步讨论。
android:scrollHorizontally
设置文本超出 TextView 的宽度的情况下,是否出现横拉
条。
android:selectAllOnFocus
如果文本是可选择的,让他获取焦点而不是将光标移动为
文本的开始位置或者末尾位置。TextView 中设置后无效
指定文本阴影的颜色,需要与 shadowRadius 一起使用。
果。
android:shadowColor
android:shadowDx
android:shadowDy
android:shadowRadius
android:singleLine
效果:
设置阴影横向坐标开始位置。
设置阴影纵向坐标开始位置。
设置阴影的半径。设置为 0.1 就变成字体的颜色了,一般
设置为 3.0 的效果比较好。
设置单行显示。如果和 layout_width 一起使用,当文本
不能全部显示时,后面用“…”来表示。如
android:text="test_ singleLine "
android:singleLine="true"
android:layout_width="20dp"将只显示“t…”。如果不
设置 singleLine 或者设置为 false,文本将自动换行
android:text
设置显示文本.
android:textAppearance
设置文字外观。如
“?android:attr/textAppearanceLargeInverse
”这里引用的是系统自带的一个外观,?表示系统是否有
这种外观,否则使用默认的外观。可设置的值如下:
textAppearanceButton/textAppearanceInverse/textAp
pearanceLarge/textAppearanceLargeInverse/textAppe
aranceMedium/textAppearanceMediumInverse/textAppe
aranceSmall/textAppearanceSmallInverse
android:textColor
设置文本颜色
android:textColorHighlight
被选中文字的底色,默认为蓝色
android:textColorHint
android:textColorLink
android:textScaleX
设置提示信息文字的颜色,默认为灰色。与 hint 一起使
用。
文字链接的颜色.
设置文字之间间隔,默认为 1.0f。分别设置
0.5f/1.0f/1.5f/2.0f 效果如下:
android:textSize
设置文字大小,推荐度量单位”sp”,如”15sp”
android:textStyle
设置字形[bold(粗体) 0, italic(斜体) 1,
bolditalic(又粗又斜) 2] 可以设置一个或多个,用“|”
第 8 页 共 169 页