android Spinner控件详解

Spinner提供了从一个数据集合中快速选择一项值的办法。默认情况下Spinner显示的是当前选择的值，点击Spinner会弹出一个包含所有可选值的dropdown菜单，从该菜单中可以为Spinner选择一个新值。

上图显示的是Spinner常见的样式。这篇文章中我将讨论1.Spinner的基本用法 2.设置Spinner的Adapter (arrayadapter 和自定义BaseAdapter)3.Spinner的菜单显示方式 4.Spinner的xml属性

最简单的Spinner

在布局文件中添加Spinner控件

 <LinearLayout 
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:orientation="vertical" >

        <Spinner
            android:id="@+id/spinner1"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:entries="@array/languages"
          />
    </LinearLayout

其中Android:entries=”@array/languages”表示Spinner的数据集合是从资源数组languages中获取的，languages数组资源定义在values/arrays.xml中：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string-array name="languages">
        <item>c语言</item>
        <item>java </item>
        <item>php</item>
        <item>xml</item>
        <item>html</item>
    </string-array>
</resources>

如果你不需要对Spinner的选择事件做响应，那么一个完整的Spinner使用流程就结束了。

运行结果：

当然，一般情况下我们是需要响应Spinner选择事件的,可以通过OnItemSelectedListener的回调方法实现

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Spinner spinner = (Spinner) findViewById(R.id.spinner1);
        spinner.setOnItemSelectedListener(new OnItemSelectedListener() {
            @Override
            public void onItemSelected(AdapterView<?> parent, View view, 
                    int pos, long id) {

                String[] languages = getResources().getStringArray(R.array.languages);
                Toast.makeText(MainActivity.this, "你点击的是:"+languages[pos], 2000).show();
            }
            @Override
            public void onNothingSelected(AdapterView<?> parent) {
                // Another interface callback
            }
        });
    }

}

上面的Spinner看起来非常漂亮，不过它并不是总是如此，刚刚看到的是在android:Theme.Holo.Light主题下的效果，同样的代码如果在android:Theme.Light下面就会变得很丑。

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

设置Spinner的Adapter
上面使用Spinner数据源于xml数组，其实用的最多的还是通过adapter来跟Spinner绑定数据。

使用ArrayAdapter

// 初始化控件
Spinner spinner = (Spinner) findViewById(R.id.spinner1);
// 建立数据源
String[] mItems = getResources().getStringArray(R.array.languages);
// 建立Adapter并且绑定数据源
ArrayAdapter<String> adapter=new ArrayAdapter<String>(this,android.R.layout.simple_spinner_item, mItems);
adapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);
//绑定 Adapter到控件
spinner .setAdapter(adapter);
spinner.setOnItemSelectedListener(new OnItemSelectedListener() {
    @Override
    public void onItemSelected(AdapterView<?> parent, View view, 
            int pos, long id) {

        String[] languages = getResources().getStringArray(R.array.languages);
        Toast.makeText(MainActivity.this, "你点击的是:"+languages[pos], 2000).show();
    }
    @Override
    public void onNothingSelected(AdapterView<?> parent) {
        // Another interface callback
    }
});

这是Spinner的标准使用方法，其中，有两行代码可以决定Spinner的外观：

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

第二个参数是Spinner未展开菜单时Spinner的默认样式，android.R.layout.simple_spinner_item是系统自带的内置布局。

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。

 <LinearLayout 
        android:layout_width="fill_parent"
        android:layout_height="80dip"
        android:orientation="vertical" >

        <Spinner
            android:id="@+id/spinner2"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
          />
    </LinearLayout>

activity中：

 // 初始化控件
        Spinner spinner2  = (Spinner) findViewById(R.id.spinner2);
        // 建立数据源
        List<Person>  persons=new ArrayList<Person>();
        persons.add(new Person("张三", "上海 "));
        persons.add(new Person("李四", "上海 "));
        persons.add(new Person("王五", "北京" ));
        persons.add(new Person("赵六", "广州 "));
        //  建立Adapter绑定数据源
        MyAdapter _MyAdapter=new MyAdapter(this, persons);
        //绑定Adapter
        spinner2.setAdapter(_MyAdapter);

Person.Java

package com.example.spinnerdemo;

public class Person {
    private String personName;
    private String personAddress;
    public Person(String personName, String personAddress) {
        super();
        this.personName = personName;
        this.personAddress = personAddress;
    }
    public String getPersonName() {
        return personName;
    }
    public void setPersonName(String personName) {
        this.personName = personName;
    }
    public String getPersonAddress() {
        return personAddress;
    }
    public void setPersonAddress(String personAddress) {
        this.personAddress = personAddress;
    }

}

MyAdapter.java

package com.example.spinnerdemo;

import java.util.List;
import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.ImageView;
import android.widget.TextView;

/**
 * 自定义适配器类
 * @author jiangqq  <a href=http://blog.csdn.net/jiangqq781931404></a>
 *
 */
public class MyAdapter extends BaseAdapter {
    private List<Person> mList;
    private Context mContext;

    public MyAdapter(Context pContext, List<Person> pList) {
        this.mContext = pContext;
        this.mList = pList;
    }

    @Override
    public int getCount() {
        return mList.size();
    }

    @Override
    public Object getItem(int position) {
        return mList.get(position);
    }

    @Override
    public long getItemId(int position) {
        return position;
    }
    /**
     * 下面是重要代码
     */
    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        LayoutInflater _LayoutInflater=LayoutInflater.from(mContext);
        convertView=_LayoutInflater.inflate(R.layout.item_custom, null);
        if(convertView!=null) {
            ImageView imageView = (ImageView)convertView.findViewById(R.id.image);
            imageView.setImageResource(R.drawable.ic_launcher);
            TextView _TextView1=(TextView)convertView.findViewById(R.id.textView1);
            TextView _TextView2=(TextView)convertView.findViewById(R.id.textView2);
            _TextView1.setText(mList.get(position).getPersonName());
            _TextView2.setText(mList.get(position).getPersonAddress());
        }
        return convertView;
    }
}

运行效果：

Spinner的菜单显示方式

它有两种显示形式，一种是下拉菜单，一种是弹出框，菜单显示形式是spinnerMode属性决定的：

android:spinnerMode="dropdown"
android:spinnerMode="dialog"

在android2.3上没有这个属性，系统默认将Spinner弹出菜单显示成dialog。下面是Theme.Light和Theme.Holo.Light下Spinner在不同模式下的效果对比图。

Spinner的xml属性

其实上面已经提到了Spinner的两个属性：

1 entries: 直接在xml布局文件中绑定数据源（可以不设置，即可以在Activity中动态绑定）

2 spinnerMode: Spinner的显示形式

除此之外还有如下属性：

prompt：在Spinner弹出选择对话框的时候对话框的标题：

属性名称

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

对应方法：

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