android studio StackView控件的源码解释和简单示例

   我在这里给大家介绍一个好玩的控件，stackView，但是这个控件好像不是很常用到，至少我也是最近才
遇到这个控件，觉得还是不错的，所以就给大家介绍下。也权当自己在熟悉一遍。
   因为网上的资料还比较少，所以自己将源码大略的翻译一遍，英语还是有点蹩脚，见谅！
   开始我们的学习之旅吧！！！
   stackView官方定义：A view that displays its children in a stack and allows users
to discretely swipe through the children.
   解释：stackView是在一个栈中显示它的子控件，可以允许用户直接的去滑动它的
子控件。

源码解释：
1、Google已经帮我们定义好了例如
    /**
     * Default animation parameters
     */
//解释：默认的动画时间参数
    private static final int DEFAULT_ANIMATION_DURATION = 400;
    private static final int MINIMUM_ANIMATION_DURATION = 50;
    private static final int STACK_RELAYOUT_DURATION = 100;

    /**
     * Represent the two possible stack modes, one where items slide up, and the other
     * where items slide down. The perspective is also inverted between these two modes.
     */
//解释：定义两个往上滑或者往下滑的两个动作模式，并且是只在这两个模式间切换。
    //不会有第三个动作模式。
    private static final int ITEMS_SLIDE_UP = 0;
    private static final int ITEMS_SLIDE_DOWN = 1;


    /**
     * These specify the different gesture states
     */
//解释：指定不同的手势状态以及一些手势状态等
    private static final int GESTURE_NONE = 0;
    private static final int GESTURE_SLIDE_UP = 1;
    private static final int GESTURE_SLIDE_DOWN = 2;

     /**
     * Specifies how far you need to swipe (up or down) before it
     * will be consider a completed gesture when you lift your finger
     */
//解释：表示手指要往上或者下滑动多少，stackView才会完成剩下的滑动切换动作
    private static final float SWIPE_THRESHOLD_RATIO = 0.2f; //官方的是20%


    /**
     * Specifies the total distance, relative to the size of the stack,
     * that views will be slid, either up or down
     */
//解释：指定到达相对于stackView控件的宽高的固定距离，则视图会执行向上或向下的滑动操作；
    private static final float SLIDE_UP_RATIO = 0.7f;


    /**
     * Sentinel value for no current active pointer.
     * Used by {@link #mActivePointerId}.
     */
//解释：当前没有可用的手势时的默认值
    private static final int INVALID_POINTER = -1;


    /**
     * Number of active views in the stack. One fewer view is actually visible, as one is hidden.
     */
//解释：在stackView栈中的活动的视图的顺序。当一个fewer view视图（我理解为，较近的视图）
  //实际可见时，另一个视图就被隐藏了。
    private static final int NUM_ACTIVE_VIEWS = 5; //定义5个活动的视图


    private static final int FRAME_PADDING = 4; //？

    private final Rect mTouchRect = new Rect();

    private static final int MIN_TIME_BETWEEN_INTERACTION_AND_AUTOADVANCE = 5000;

    private static final long MIN_TIME_BETWEEN_SCROLLS = 100; //100毫秒就滑动完


    /**
     * These variables are all related to the current state of touch interaction
     * with the stack
     */
//解释：以下这些变量值，是在栈中各个视图和用户交互时的状态密切相关的变量。
    private float mInitialY;
    private float mInitialX;
    private int mActivePointerId;
    private int mYVelocity = 0;
    .....还有好多，这里就不一一列举出来了。



stackView的函数解释：

    /**
     * {@inheritDoc}
     */
//解释：这个是其中一个参数最多的构造函数
    public StackView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
        
    }

    /**
     * Animate the views between different relative indexes within the {@link AdapterViewAnimator}
     */
//解释：在相对的两个不同的索引index里面进行动画切换。
    void transformViewForTransition(int fromIndex, int toIndex, final View view, boolean animate) {}

//显示下一个视图
public void showNext() {}

//显示上一个视图
public void showPrevious() {}

//处理鼠标滚轮事件的处理函数
public boolean onGenericMotionEvent(MotionEvent event) {}

//触发拦截触摸事件
public boolean onInterceptTouchEvent(MotionEvent ev) {}

 //不解释了这个，见太多了
public boolean onTouchEvent(MotionEvent ev) {}

//显示下一张，类似showNext()方法
public void advance() {}

//得到类名
public CharSequence getAccessibilityClassName() {
     return StackView.class.getName();
  }

//初始化？？用
 public void onInitializeAccessibilityNodeInfoInternal(AccessibilityNodeInfo info) {}

最后给出一个简单的示例：

示例截图：

直接上代码：

首先是主布局activity_main.xml，很简单的放了一个stackView和底部4个按钮分别是向上，向下切换，开始和停止播放自动动画。

<RelativeLayout 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"
    tools:context=".MainActivity">

    <StackView
        android:id="@+id/sk_show"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:loopViews="true" />

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        android:layout_centerHorizontal="true"
        android:gravity="center"
        android:orientation="horizontal">

        <Button
            android:id="@+id/btn_prev"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:gravity="center"
            android:text="privious" />

        <Button
            android:id="@+id/btn_next"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="5dp"
            android:text="next" />

        <Button
            android:id="@+id/btn_autoPlay"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="5dp"
            android:text="auto play" />

        <Button
            android:id="@+id/btn_autostop"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="5dp"
            android:text="auto play" />
    </LinearLayout>
</RelativeLayout>

然后是一个用来装载每一个图片的子布局stackview_cell.xml，里面就放了一个imageView而已。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ImageView
        android:layout_centerInParent="true"
        android:id="@+id/img_show"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:scaleType="fitCenter" />
</RelativeLayout>

最后是MainActivity.java的代码，主要是利用适配器将每个图片设置进stackView里面去。还加上一个自动循环播放的按钮和停止播放的按钮。

package com.kuyu.com.stackview;

import android.os.Bundle;
import android.os.Handler;
import android.os.Message;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Button;
import android.widget.SimpleAdapter;
import android.widget.StackView;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Timer;
import java.util.TimerTask;

public class MainActivity extends AppCompatActivity implements View.OnClickListener {
    private StackView sk_show;
    private Button btn_prev, btn_next, btn_autoplay, btn_autostop;
    private int[] imgIds = new int[]{R.drawable.imgv1, R.drawable.imgv2, R.drawable.imgv3,
            R.drawable.imgv4, R.drawable.imgv5, R.drawable.imgv6};
    private Timer timer;
    private TimerTask task;
    private final int UPDATE_ID = 101;
    private int iCount;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        initViews();
        initListener();
        initDate();
    }

    /**
     * 初始化空间
     */
    private void initViews() {
        sk_show = (StackView) findViewById(R.id.sk_show);
        btn_prev = (Button) findViewById(R.id.btn_prev);
        btn_next = (Button) findViewById(R.id.btn_next);
        btn_autoplay = (Button) findViewById(R.id.btn_autoPlay);
        btn_autostop = (Button) findViewById(R.id.btn_autostop);
    }

    /**
     * 初始化监听器
     */
    private void initListener() {
        btn_prev.setOnClickListener(this);
        btn_next.setOnClickListener(this);
        btn_autoplay.setOnClickListener(this);
        btn_autostop.setOnClickListener(this);
    }

    /**
     * 初始化数据
     */
    private void initDate() {
        List<Map<String, Object>> listItems = new ArrayList<>();
        for (int i = 0; i < imgIds.length; i++) {
            Map<String, Object> item = new HashMap<String, Object>() {
            };
            item.put("img", imgIds[i]);
            listItems.add(item);
        }
        SimpleAdapter adapter = new SimpleAdapter(this, listItems, R.layout.stackview_cell, new
                String[]{"img"}, new int[]{R.id.img_show}); //用适配器将每个图片设置到stackView里面去
        sk_show.setAdapter(adapter);
        btn_autostop.setClickable(false);
    }



    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.btn_prev:
                sk_show.showPrevious();
                break;

            case R.id.btn_next:
                sk_show.showNext();
                break;

            case R.id.btn_autoPlay:
                btn_autoplay.setClickable(false);
                btn_autostop.setClickable(true);
                startPlay();
                break;

            case R.id.btn_autostop:
                btn_autostop.setClickable(false);
                btn_autoplay.setClickable(true);
                stopPlay();
                break;
        }
    }

    /**
     * 开始自动播放
     */
    private void startPlay() {
        timer = new Timer();
        task = new TimerTask() {
            @Override
            public void run() {
                Message msg = handler.obtainMessage();
                msg.arg1 = UPDATE_ID;
                handler.sendMessage(msg);
                iCount++;
                if(iCount > 20){
                    timer.cancel();
                    task.cancel();
                    iCount = 0;
                    btn_autoplay.setClickable(true);
                }
            }
        };
        timer.schedule(task,0, 1000);
    }

    /**
     * 停止自动播放
     */
    private void stopPlay(){
        timer.cancel();
        task.cancel();
    }

    /**
     * 更新ui
     */
    Handler handler = new Handler(){
        public void handleMessage(Message msg) {
            switch (msg.arg1){
                case UPDATE_ID:
                    sk_show.showNext();
                    break;
            }
        }
    };
}

   最后，奉上下载链接：点击打开链接

   好啦，关于StackView控件就先介绍到这里了。

   以后发现有更好玩的东西在放上来，大家一起分享。