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控件就先介绍到这里了。

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