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