Android的Spinner组件的XML属性(备查)

本文译自:http://developer.android.com/reference/android/widget/Spinner.html

java.lang.Object

  |___android.view.View

         |___android.view.ViewGroup

                |___android.widget.AdapterView<T extends android.widget.Adapter>

                       |___android.widget.AbsSpinner

                              |___android.widget.Spinner

类概要

每次只显示容器中一个子View的可视控件,并且让用户可以在指定的范围内进行选择。Spinner内的项目来自跟它关联的Adapter

XML Attributes

属性名称

对应的方法

描述

android:dropDownHorizontalOffset

setDropDownHorizontalOffset(int)

spinnerMode=”dropdown”时,下拉的项目选择窗口在水平方向相对于Spinner窗口的偏移量。

它必须是一个带有单位的浮点型尺寸值,如:”14.5sp”。有效的单位包括:px(像素)、dp(密度无关的像素)、sp(基于引用字体的尺寸来缩放的像素)、in(英寸)、mm(毫米)。

这个属性还可以引用一个资源(格式:@[package:]type:name)或者是包含这种类型值的主题属性(格式:?[package][type:]name)。

这个属性对应全局属性资源符号dropDownHorizontalOffset

 

android:dropDownSelector

 

用于设定spinnerMode=”dropdown”时列表选择器的显示效果。

它可以用”@[+][package]:type:name”格式来引用另外的资源,或者是用”?[package:][type:]name”的格式来应用主题属性,还可以是”#rgb”、”#argb”、”#rrggbb”、”aarrggbb”格式的颜色值。

它对应的全局属性资源符号是dropDownSelector

android:dropDownVerticalOffset

setDropDownVerticalOffset(int)

spinnerMode=”dropdown”时,下拉的项目选择窗口在垂直方向相对于Spinner窗口的偏移量。

这个属性它必须是一个带有单位的浮点型尺寸值,如:”14.5sp”。有效的单位包括:px(像素)、dp(密度无关的像素)、sp(基于引用字体的尺寸来缩放的像素)、in(英寸)、mm(毫米)。

还可以引用一个资源(格式:@[package:]type:name)或者是包含这种类型值的主题属性(格式:?[package][type:]name)。

这个属性对应全局属性资源符号dropDownVerticalOffset

 

android:dropDownWidth

setDropDownWidth(int)

在spinnerMode=”dropdown”时,设定下拉框的宽度。

这个属性可以是带有单位的浮点型的尺寸值,如:14.5sp。有效的单位包括:px(像素)、dp(密度无关的像素)、sp(基于引用字体的尺寸来缩放的像素)、in(英寸)、mm(毫米)。

还可以引用一个资源(格式:@[package:]type:name)或者是包含这种类型值的主题属性(格式:?[package][type:]name)。

还可以是下列常量之一:

fill_parent = -1,下拉框的宽度应该使用屏幕的宽度来设定。这个常量从API Level 8开始被废弃了,并且使用mach_parent常量来代替。

mach_parent = -1,下拉框的宽度应该使用屏幕的宽度来设定。在API Level 8中被引入。

wrap_content = -2,下拉框的宽度应该跟它的内容相适应。

它对应的全局资源符号是dropDownWidth

android:gravity

setGravity(int)

这个属性用于设置当前选择的项目的对齐方式。

它必须是以下常量值之一或组合(用”|”符号分离)。

top = 0x30:把选择的对象放到它的容器的顶部,不改变它的尺寸。

bottom = 0x50:把选择的对象放到它的容器的底部,不改变它的尺寸。

left = 0x03:把选择的对象放到它的容器的左边,不改变它的尺寸。

right = 0x05:把选择的对象放到它的容器的右边,不改变它的尺寸。

center_vertical = 0x10:把选择的对象放到它的容器的垂直中心,不改变它的尺寸。

fill_vertical = 0x70:为了完全的填充它的容器,系统会根据需要来增加选择对象的垂直尺寸。

center_horizontal = 0x01:把选择的对象放到它的容器的水平中心,不改变它的尺寸。

fill_horizontal = 0x07:为了完全的填充它的容器,系统会根据需要来增加选择对象的水平尺寸。

center = 0x11:把选择的对象放到它的容器的垂直和水平中心,不改变它的尺寸。

fill = 0x77:为了完全的填充它的容器,系统会根据需要来增加选择对象的水平和垂直尺寸。

clip_vertical = 0x80:附加的可选设置,它可以设置容器内子对象的上下边缘裁剪它的容器边框。裁剪会基于垂直对齐的方式:顶部对齐的会裁剪底部边缘,底部对齐的会裁剪顶部边缘,不会上下边缘都裁剪。

clip_horizontal = 0x08:附加的可选设置,它可以设置容器内子对象的左右边缘裁剪它的容器边框。裁剪会基于水平对齐的方式:左对齐的会裁剪右边缘,右对齐的会裁剪左边缘,不会左右边缘都裁剪。

start = 0x00800003:把对象放到它的容器的开始位置,不改变它的尺寸。

end = 0x00800005:把对象放到它的容器的结束位置,不改变它的尺寸。

对应的全局属性资源符号是gravity。

注:Spinner对象是一个视窗对象容器,设置它的gravity属性时,只会改变容器内部子视窗对象的对齐方式,并不会改变子视窗内部内容的对齐方式。

android:popupBackground

setPopupBackgroundResource(int)

在spinner=”dropdown”时,使用这个属性来设置下拉列表的背景。

可以使用”@[+][package:]type:name”格式来引用另外的资源,或者使用”?[package:][type:]name”格式来应用主题属性,也可以使用”#rgb”、”#argb”、”#rrggbb”、”#aarrggbb”格式的颜色值。

对应的全局属性资源符号是popupBackground

android:prompt

 

这个属性用于显示Spinner对话框时的显示提示。

它必须使用”@[+][package:]type:name”格式来引用另外的资源,或者使用”?[package:][type:]name”的格式来应用主题属性。

对应的全局属性资源符号是prompt

android:spinnerMode

 

设定Spinner的显示模式。

必须是下列常量之一:

dialog = 0:Spinner会被作为一个对口窗口来显示。

dropdown = 1:Spinner会作为一个内嵌的下拉列表来显示。

对应的全局属性资源符号是spinnerMode

 

 

你可能感兴趣的:(Android的Spinner组件的XML属性(备查))