Android Spinner控件詳解

Spinner提供了從一個數據集合中快速選擇一項值的辦法。默認情況下Spinner顯示的是當前選擇的值，點擊Spinner會彈出一個包含所有可選值的dropdown菜單，從該菜單中可以爲Spinner選擇一個新值。

上圖顯示的是Spinner常見的樣式。這篇文章中我將討論1.Spinner的基本用法 2.設置Spinner的Adapter (arrayadapter 和自定義BaseAdapter)3.Spinner的菜單顯示方式 4.Spinner的xml屬性

最簡單的Spinner

在佈局文件中添加Spinner控件

1.     <LinearLayout 
2.         android:layout_width="fill_parent"
3.         android:layout_height="fill_parent"
4.         android:orientation="vertical" >
5.      
6.         <Spinner
7.             android:id="@+id/spinner1"
8.             android:layout_width="wrap_content"
   
   
9.             android:layout_height="wrap_content"
10.             android:entries="@array/languages"
11.           />
12.     </LinearLayout>

其中android:entries="@array/languages"表示Spinner的數據集合是從資源數組languages中獲取的，languages數組資源定義在values/arrays.xml中：

1. <?xml version="1.0" encoding="utf-8"?>
2. <resources>
3.     <string-array name="languages">
4.         <item>c語言</item>
5.         <item>java </item>
6.         <item>php</item>
7.         <item>xml</item>
8.         <item>html</item>
9.     </string-array>
10. </resources>

如果你不需要對Spinner的選擇事件做響應，那麼一個完整的Spinner使用流程就結束了。

運行結果：

當然，一般情況下我們是需要響應Spinner選擇事件的,可以通過OnItemSelectedListener的回調方法實現

1. public class MainActivity extends Activity {
2.  
3.     @Override
4.     protected void onCreate(Bundle savedInstanceState) {
5.         super.onCreate(savedInstanceState);
6.         setContentView(R.layout.activity_main);
7.         Spinner spinner = (Spinner) findViewById(R.id.spinner1);
8.         spinner.setOnItemSelectedListener(new OnItemSelectedListener() {
9.             @Override
10.             public void onItemSelected(AdapterView<?> parent, View view, 
11.                     int pos, long id) {
12.            
13.                 String[] languages = getResources().getStringArray(R.array.languages);
14.                 Toast.makeText(MainActivity.this, "你點擊的是:"+languages[pos], 2000).show();
15.             }
16.             @Override
17.             public void onNothingSelected(AdapterView<?> parent) {
18.                 // Another interface callback
19.             }
20.         });
21.     }
22.  
23. }

上面的Spinner看起來非常漂亮，不過它並不是總是如此，剛剛看到的是在android:Theme.Holo.Light主題下的效果，同樣的代碼如果在android:Theme.Light下面就會變得很醜。

想必這也是很多人不想使用Spinner的原因了吧。如果想兼容2.3，則只能忍受這樣的效果。

設置Spinner的Adapter

上面使用Spinner數據源於xml數組，其實用的最多的還是通過adapter來跟Spinner綁定數據。

使用ArrayAdapter

1. // 初始化控件
2. Spinner spinner = (Spinner) findViewById(R.id.spinner1);
3. // 建立數據源
4. String[] mItems = getResources().getStringArray(R.array.languages);
5. // 建立Adapter並且綁定數據源
6. ArrayAdapter<String> adapter=new ArrayAdapter<String>(this,android.R.layout.simple_spinner_item, mItems);
7. adapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);
8. //綁定 Adapter到控件
9. spinner .setAdapter(adapter);
10. spinner.setOnItemSelectedListener(new OnItemSelectedListener() {
11.     @Override
12.     public void onItemSelected(AdapterView<?> parent, View view, 
13.             int pos, long id) {
14.    
15.         String[] languages = getResources().getStringArray(R.array.languages);
16.         Toast.makeText(MainActivity.this, "你點擊的是:"+languages[pos], 2000).show();
17.     }
18.     @Override
19.     public void onNothingSelected(AdapterView<?> parent) {
20.         // Another interface callback
21.     }
22. });

這是Spinner的標準使用方法，其中，有兩行代碼可以決定Spinner的外觀：

1

1. ArrayAdapter<String> adapter=new ArrayAdapter<String>(this,android.R.layout.simple_spinner_item, mItems);

第二個參數是Spinner未展開菜單時Spinner的默認樣式，android.R.layout.simple_spinner_item是系統自帶的內置佈局。

2

1. adapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);

設置的是展開的時候下拉菜單的樣式（注意和上面區別），同理android.R.layout.simple_spinner_dropdown_item也是內置佈局。

如果不設置adapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item)會怎樣呢？

會造成未展開的sipnner和展開的菜單都是一種佈局樣式。下面一運行截圖來說明：

沒有adapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item)：

有setDropDownViewResource：

你可能會很好奇如果設置了setDropDownViewResource但是setDropDownViewResource的參數和ArrayAdapter的第二個佈局參數（simple_spinner_item）一致的情況下會怎樣。情況是和沒有setDropDownViewResource是一樣的，因爲上面說了不設置setDropDownViewResource Spinner未展開和展開都是用的一樣的佈局。

其實simple_spinner_item和simple_spinner_dropdown_item兩者的名字正好反映了他們的區別。一個應用於下拉一個應用於Spinner本身。

使用自定義的BaseAdapter

這種情況適用於spinner比較複雜的情況，比如帶有圖標。

下面我們定義一個選擇聯繫人的Spinner。

1.     <LinearLayout 
2.         android:layout_width="fill_parent"
3.         android:layout_height="80dip"
4.         android:orientation="vertical" >
5.      
6.         <Spinner
7.             android:id="@+id/spinner2"
8.             android:layout_width="wrap_content"
9.             android:layout_height="wrap_content"
10.           />
11.     </LinearLayout>

activity中：

1.            // 初始化控件
2.         Spinner spinner2  = (Spinner) findViewById(R.id.spinner2);
3.         // 建立數據源
4.         List<Person>  persons=new ArrayList<Person>();
5.         persons.add(new Person("張三", "上海 "));
6.         persons.add(new Person("李四", "上海 "));
7.         persons.add(new Person("王五", "北京" ));
8.         persons.add(new Person("趙六", "廣州 "));
9.         //  建立Adapter綁定數據源
10.         MyAdapter _MyAdapter=new MyAdapter(this, persons);
11.         //綁定Adapter
12.         spinner2.setAdapter(_MyAdapter);

Person.java

1. package com.example.spinnerdemo;
2.  
3. public class Person {
4.     private String personName;
5.     private String personAddress;
6.     public Person(String personName, String personAddress) {
7.         super();
8.         this.personName = personName;
9.         this.personAddress = personAddress;
10.     }
11.     public String getPersonName() {
12.         return personName;
13.     }
14.     public void setPersonName(String personName) {
15.         this.personName = personName;
16.     }
17.     public String getPersonAddress() {
18.         return personAddress;
19.     }
20.     public void setPersonAddress(String personAddress) {
21.         this.personAddress = personAddress;
22.     }
23.  
24. }

MyAdapter.java

1. package com.example.spinnerdemo;
2.  
3. import java.util.List;
4. import android.content.Context;
5. import android.view.LayoutInflater;
6. import android.view.View;
7. import android.view.ViewGroup;
8. import android.widget.BaseAdapter;
9. import android.widget.ImageView;
10. import android.widget.TextView;
11.  
12. /**
13.  * 自定義適配器類
14.  * @author jiangqq  <a href=http://blog.csdn.net/jiangqq781931404></a>
15.  *
16.  */
17. public class MyAdapter extends BaseAdapter {
18.     private List<Person> mList;
19.     private Context mContext;
20.  
21.     public MyAdapter(Context pContext, List<Person> pList) {
22.         this.mContext = pContext;
23.         this.mList = pList;
24.     }
25.  
26.     @Override
27.     public int getCount() {
28.         return mList.size();
29.     }
30.  
31.     @Override
32.     public Object getItem(int position) {
33.         return mList.get(position);
34.     }
35.  
36.     @Override
37.     public long getItemId(int position) {
38.         return position;
39.     }
40.     /**
41.      * 下面是重要代碼
42.      */
43.     @Override
44.     public View getView(int position, View convertView, ViewGroup parent) {
45.         LayoutInflater _LayoutInflater=LayoutInflater.from(mContext);
46.         convertView=_LayoutInflater.inflate(R.layout.item_custom, null);
47.         if(convertView!=null) {
48.             ImageView imageView = (ImageView)convertView.findViewById(R.id.image);
49.             imageView.setImageResource(R.drawable.ic_launcher);
50.             TextView _TextView1=(TextView)convertView.findViewById(R.id.textView1);
51.             TextView _TextView2=(TextView)convertView.findViewById(R.id.textView2);
52.             _TextView1.setText(mList.get(position).getPersonName());
53.             _TextView2.setText(mList.get(position).getPersonAddress());
54.         }
55.         return convertView;
56.     }
57. }

運行效果：

Spinner的菜單顯示方式

它有兩種顯示形式，一種是下拉菜單，一種是彈出框，菜單顯示形式是spinnerMode屬性決定的：

1. android:spinnerMode="dropdown"
2. android:spinnerMode="dialog"

在android2.3上沒有這個屬性，系統默認將Spinner彈出菜單顯示成dialog。下面是Theme.Light和Theme.Holo.Light下Spinner在不同模式下的效果對比圖。

	dropdown	dialog
Theme.Light 默認爲彈出框的形式
Theme.Holo.Light 默認爲下拉菜單的形式

Spinner的xml屬性

其實上面已經提到了Spinner的兩個屬性：

1 entries: 直接在xml佈局文件中綁定數據源（可以不設置，即可以在Activity中動態綁定）

2 spinnerMode: Spinner的顯示形式

除此之外還有如下屬性：

prompt：在Spinner彈出選擇對話框的時候對話框的標題：

屬性名稱

android:dropDownHorizontalOffset

對應方法：   

1. 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

對應方法：

1. setDropDownVerticalOffset(int)

spinnerMode=”dropdown”時，下拉的項目選擇窗口在垂直方向相對於Spinner窗口的偏移量。

這個屬性它必須是一個帶有單位的浮點型尺寸值，如：”14.5sp”。有效的單位包括：px(像素)、dp(密度無關的像素)、sp(基於引用字體的尺寸來縮放的像素)、in(英寸)、mm(毫米)。

還可以引用一個資源(格式：@[package:]type:name）或者是包含這種類型值的主題屬性（格式：?[package][type:]name）。

這個屬性對應全局屬性資源符號dropDownVerticalOffset。

android:dropDownWidth

對應方法：

1. 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

對應方法：

1. 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

對應方法：

1. setPopupBackgroundResource(int)

在spinner=”dropdown”時，使用這個屬性來設置下拉列表的背景。

可以使用”@[+][package:]type:name”格式來引用另外的資源，或者使用”?[package:][type:]name”格式來應用主題屬性，也可以使用”#rgb”、”#argb”、”#rrggbb”、”#aarrggbb”格式的顏色值。

對應的全局屬性資源符號是popupBackground