Android的Spinner组件的XML属性（备查）

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