Android--UI之Gallery

前言

　　这篇博客讲解一下Android开发中，Gallery控件的使用，这是一个画廊视图，用于展示一组图片，用固定在中间位置的水平滚动列表显示列表项的视图。Android最新的API文档中了解到，在Android4.1（Android API level16）之后，就不再赞成使用这个控件，但还对其有支持，所以这里简单讲解一下如何使用。在这篇博客中，将了解到Gallery的一些常用属性、方法、以及样式的设置，最后会以一个小示例来展示如何使用Gallery展示一个画廊的效果。

Gallery

　　Gallery与Spinner两个控件具有共同的父类：AbsSpinner，表示Gallery和Spinner都是一个列表框。它们之间的区别在于Spinner显示的是一个垂直的列表选择框，而Gallery显示的是一个水平的列表选择框，而且支持水平滑动的效果。Gallery与Spinner还有一个区别：Spinner的作用是供用户选择，而Gallery则允许用户通过拖动来查看上一个、下一个列表项。对于Spinner，在我的另外一篇博客中有详细讲解，有兴趣的朋友可以看看：Android--UI之Spinner。

　　下面介绍一下Gallery的常用XML属性，Android也为其属性提供了相应的getter、setter方法：

• android:animationDuration：设置列表项切换时的动画持续时间，使用毫秒为单位。
• android:gravity：设置列表项的对其方式。
• android:spacing：设置Gallery内列表项之间的间距。
• android:unselectedAlpha：设置没有被选中的列表项的透明度，范围是一个为0~1的float数，越接近0越透明。

　　作为一个列表框，它和Spinner一样，声明的事件也是定义在AdapterView类中，常用事件有如下几个：

• AdapterView.OnItemCLickListener：列表项被点击时触发。
• AdapterView.OnItemLongClickListener：列表项被长按时触发。
• AdapterView.OnItemSelectedListener：列表项被选择时触发。 

Gallery的数据绑定

　　Gallery本身的用法非常简单，基本上与Spinner的用法相似，只要为它提供一个Adapter适配器即可。如果需要响应Gallery上用户的操作，可以监听上面介绍的几个事件。

　　Adapter适配器的概念，在我的另外一篇博客中有讲解，有兴趣的朋友可以看看，Android--UI之AutoCompleteTextView。而对于Gallery的Adapter适配器，虽然可以直接实现Adapter接口，但是一般推荐继承另外一个抽象类：BaseAdapter，它已经实现了一些常用的方法。对于BaseAdapter而言，继承它必须要实现几个方法，下面先了解一下这几个方法：

• int getCount()：当前适配器中存在多少个数据项。
• Object getItem(int position)：返回数据集中指定位置的数据项。
• long getItemId(int position)：返回数据集中指定位置的数据行Id。
• View getView(int position,View convertView,ViewGroup parent)：返回一个视图，用于显示数据集中指定位置的数据项。

　　对于BaseAdapter的getView()方法，这里着重讲解一下。在绑定Adapter适配器之后，系统会根据getCount()方法返回的数据项，循环调用getView()方法，用于返回每个position位置的显示视图，所以对于一个Adapter适配器，其主要的代码量就在getView()方法中。因为BaseAdapter的getView()方法返回的是一个View数据，所以一般自定义的展示效果都会用到BaseAdapter来做父类，继承实现其中的方法来实现自定义的View来展示在UI界面上，

示例程序

　　下面通过一个示例说明上面讲到的知识点，在这个示例程序中，使用一个Gallery来展示一组图片的画廊效果，大部分项目中用到的也是这种效果，但是它展示的是一个View，所以并不是仅仅可以用来显示图片，这里只是用图片进行演示。在示例程序中还声明了一个ImageView，用于显示从Gallery中选中的图片，对于ImageView的用法，请参见另外一篇博客：ImageView的使用，这里就不在累述了。　

　　因为是显示一个图片的画廊效果，所以需要准备一组图片，这些图片放在res/drawable-hdpi目录下，这些图片会随着项目源码一起打包到源码中的。

　　布局代码： 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context=".MainActivity" >

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Gallery Demo" />
    <!-- 定义一个Gallery，其中动画换进3秒，数据项间隔3dp，透明度为50% -->
    <Gallery
        android:id="@+id/gallery1"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:animationDuration="3000"
        android:spacing="3dp"
        android:unselectedAlpha="0.5" />

    <ImageView
        android:id="@+id/image1"
        android:layout_width="320dp"
        android:layout_height="250dp"
        android:scaleType="fitXY" />

</LinearLayout>

　实现代码：

package com.bgxt.gallerydemo;

import android.os.Bundle;
import android.app.Activity;
import android.content.Context;
import android.content.res.TypedArray;
import android.view.Menu;
import android.view.View;
import android.view.ViewGroup;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.BaseAdapter;
import android.widget.Gallery;
import android.widget.ImageView;

public class MainActivity extends Activity {
    private int[] imagesIDs = new int[] { R.drawable.bmp1, R.drawable.bmp2,
            R.drawable.bmp3, R.drawable.bmp4, R.drawable.bmp5, R.drawable.bmp6,
            R.drawable.bmp7, R.drawable.bmp8, R.drawable.bmp9, R.drawable.bmp10 };
    private Gallery gallery;
    private ImageView image;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        gallery = (Gallery) findViewById(R.id.gallery1);
        image = (ImageView) findViewById(R.id.image1);
        gallery.setAdapter(new ImageAdapter(MainActivity.this));
        gallery.setOnItemClickListener(new OnItemClickListener() {

            @Override
            public void onItemClick(AdapterView<?> parent, View view,
                    int position, long id) {
                image.setImageResource(imagesIDs[position]);
            }
        });
    }

    // 声明一个BaseAdapter
    public class ImageAdapter extends BaseAdapter {
        // 使用Adapter的上下文变量
        Context context;
        // 背景样式的Id
        int itemBackground;

        public ImageAdapter(Context c) {
            // 在构造函数中传递需要使用这个Adapter的上下文变量
            context = c;
            // 通过XML资源中定义的样式，设定背景
            TypedArray a = obtainStyledAttributes(R.styleable.Gallery1);
            itemBackground = a.getResourceId(
                    R.styleable.Gallery1_android_galleryItemBackground, 0);
            a.recycle();
        }

        @Override
        public int getCount() {
            // 返回当前数据集中数据的个数
            return imagesIDs.length;
        }

        @Override
        public Object getItem(int position) {
            // 返回数据集中，当前position位置的数据
            return imagesIDs[position];
        }

        @Override
        public long getItemId(int position) {
            // 返回数据集中，当前position位置的数据的Id
            return position;
        }

        @Override
        public View getView(int position, View convertView, ViewGroup parent) {
            // 返回当前position位置的视图
            ImageView imageview;
            if (convertView == null) {
                // 通过数据上下文对象声明一个ImageView，并设置相关属性
                imageview = new ImageView(context);
                imageview.setImageResource(imagesIDs[position]);
                imageview.setScaleType(ImageView.ScaleType.FIT_XY);
                imageview.setLayoutParams(new Gallery.LayoutParams(150, 120));

            } else {
                imageview = (ImageView) convertView;
            }
            // 使用XML 中定义的样式为待显示的View设定背景样式
            imageview.setBackgroundResource(itemBackground);

            return imageview;
        }

    }

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // Inflate the menu; this adds items to the action bar if it is present.
        getMenuInflater().inflate(R.menu.main, menu);
        return true;
    }

}

　　在代码中用到了一个XML文件定义的Android样式，这里仅仅是为了用于Gallery展示图片的背景样式，并不是必须的。下面是样式的XML资源文件attrs.xml的代码，文件存放地址为res/values中。

<?xml version="1.0" encoding="utf-8"?>
<resources>

    <declare-styleable name="Gallery1">
        <attr name="android:galleryItemBackground" />
    </declare-styleable>

</resources>

　　效果展示：

　　源码下载 

总结

　　虽然Gallery在Android4.1之后就已经不推荐使用了，但是在实际项目中，还是有机会用到这个控件的，并且通过这个控件，讲解了BaseAdapter的用法，BaseAdapter可以定义所有自定义的返回数据，在实际项目中属于比较常用的Adapter。

　　请支持原创，尊重原创，转载请注明出处。谢谢。