博客地址 :?http://blog.csdn.net/shulianghan/article/details/41520569

代碼下載 :?

-- GitHub :?https://github.com/han1202012/WheelViewDemo.git?

-- CSDN :?http://download.csdn.net/detail/han1202012/8208997?;

博客總結 :

?

博文內(nèi)容 : 本文完整地分析了 WheelView 所有的源碼, 包括其適配器類型, 兩種回調(diào)接口 (選中條目改變回調(diào), 和開始結束滾動回調(diào)), 以及詳細的分析了 WheelView 主題源碼, 其中 組件寬高測量, 手勢監(jiān)聽器添加, 以及精準的繪圖方法是主要目的, 花了將近1周時間, 感覺很值, 在這里分享給大家;

WheelView 使用方法 : 創(chuàng)建 WheelView 組件 --> 設置顯示條目數(shù) --> 設置循環(huán) --> 設置適配器 --> 設置監(jiān)聽器 ;

自定義組件寬高獲取策略 : MeasureSpec 最大模式 取 默認值 和 給定值中較小的那個, 未定義模式取默認值, 精準模式取 給定值;

自定義組件維護各種回調(diào)監(jiān)聽器策略 : 維護集合, 將監(jiān)聽器置于集合中, 回調(diào)接口時遍歷集合元素, 回調(diào)每個元素的接口方法;

自定義組件手勢監(jiān)聽器添加方法 : 創(chuàng)建手勢監(jiān)聽器, 將手勢監(jiān)聽器傳入手勢探測器, 在 onTouchEvent() 方法中回調(diào)手勢監(jiān)聽器的 onTouchEvent()方法;

一. WheelView 簡介

1. WheelView 效果

在 Android 中實現(xiàn)類似與 IOS 的 WheelView 控件 : 如圖?

2. WheelView 使用流程

(1) 基本流程簡介

?

獲取組件 --> 設置顯示條目數(shù) --> 設置循環(huán) --> 設置適配器 --> 設置條目改變監(jiān)聽器 --> 設置滾動監(jiān)聽器

a. 創(chuàng)建 WheelView 組件 : 使用 構造方法 或者 從布局文件獲取 WheelView 組件;

b. 設置顯示條目數(shù) : 調(diào)用 WheelView 組件對象的?setVisibleItems 方法 設置;

c. 設置是否循環(huán) : 設置 WheelView 是否循環(huán), 調(diào)用?setCyclic() 方法設置;

d. 設置適配器 : 調(diào)用 WheelView 組件的 setAdapter() 方法設置;

e. 設置條目改變監(jiān)聽器 : 調(diào)用 WheelView 組件對象的?addChangingListener() 方法設置;

f. 設置滾動監(jiān)聽器 : 調(diào)用 WheelView 組件對象的 addScrollingListener() 方法設置;

(2) 代碼實例

a. 創(chuàng)建 WheelView 對象 :?

//創(chuàng)建 WheelView 組件final WheelView wheelLeft = new WheelView(context);
b. 設置 WheelView 顯示條目數(shù) :?

//設置 WheelView 組件最多顯示 5 個元素wheelLeft.setVisibleItems(5);
c. 設置 WheelView 是否滾動循環(huán) :?

//設置 WheelView 元素是否循環(huán)滾動wheelLeft.setCyclic(false);
d. 設置 WheelView 適配器 :?

//設置 WheelView 適配器wheelLeft.setAdapter(new ArrayWheelAdapter<String>(left));
e. 設置條目改變監(jiān)聽器 :?

//為左側的 WheelView 設置條目改變監(jiān)聽器wheelLeft.addChangingListener(new OnWheelChangedListener() {@Overridepublic void onChanged(WheelView wheel, int oldValue, int newValue) {//設置右側的 WheelView 的適配器wheelRight.setAdapter(new ArrayWheelAdapter<String>(right[newValue]));wheelRight.setCurrentItem(right[newValue].length / 2);}});
f. 設置滾動監(jiān)聽器 :?

wheelLeft.addScrollingListener(new OnWheelScrollListener() {@Overridepublic void onScrollingStarted(WheelView wheel) {// TODO Auto-generated method stub}@Overridepublic void onScrollingFinished(WheelView wheel) {// TODO Auto-generated method stub}});

二. WheelView ?適配器 監(jiān)聽器 相關接口分析

1. 適配器 分析

這里定義了一個適配器接口, 以及兩個適配器類, 一個用于任意類型的數(shù)據(jù)集適配, 一個用于數(shù)字適配;

適配器操作?: 在 WheelView.java?中通過 setAdapter(WheelAdapter adapter) 和 getAdapter() 方法設置 獲取 適配器;

-- 適配器常用操作 : 在 WheelView 中定義了 getItem(), getItemsCount(), getMaxmiumLength() 方法獲取 適配器的相關信息;

/*** 獲取該 WheelView 的適配器* * @return * 返回適配器*/public WheelAdapter getAdapter() {return adapter;}/*** 設置適配器* * @param adapter* 要設置的適配器*/public void setAdapter(WheelAdapter adapter) {this.adapter = adapter;invalidateLayouts();invalidate();}

(1) 適配器接口 (?interface WheelAdapter )

適配器接口 :?WheelAdapter;

-- 接口作用 : 該接口是所有適配器的接口, 適配器類都需要實現(xiàn)該接口;

接口抽象方法介紹 :?

--?getItemsCount() : 獲取適配器數(shù)據(jù)集合中元素個數(shù);

/*** 獲取條目的個數(shù)* * @return * WheelView 的條目個數(shù)*/public int getItemsCount();

--?getItem(int index) : 獲取適配器集合的中指定索引元素;

/*** 根據(jù)索引位置獲取 WheelView 的條目* * @param index* 條目的索引* @return * WheelView 上顯示的條目的值*/public String getItem(int index);

--?getMaximumLength() : 獲取 WheelView 在界面上的顯示寬度;

/*** 獲取條目的最大長度. 用來定義 WheelView 的寬度. 如果返回 -1, 就會使用默認寬度* * @return * 條目的最大寬度 或者 -1*/public int getMaximumLength();

(2) 數(shù)組適配器 (?class ArrayWheelAdapter<T> implements WheelAdapter?)

適配器作用 : 該適配器可以傳入任何數(shù)據(jù)類型的數(shù)組, 可以是 字符串數(shù)組, 也可以是任何對象的數(shù)組, 傳入的數(shù)組作為適配器的數(shù)據(jù)源;

成員變量分析 :?

-- 數(shù)據(jù)源 :?

/** 適配器的數(shù)據(jù)源 */private T items[];

-- WheelView 最大寬度 :?

/** WheelView 的寬度 */private int length;

構造方法分析 :?

--?ArrayWheelAdapter(T items[], int length) : 傳入 T 類型 對象數(shù)組, 以及 WheelView 的寬度;

/*** 構造方法* * @param items* 適配器數(shù)據(jù)源 集合 T 類型的數(shù)組* @param length* 適配器數(shù)據(jù)源 集合 T 數(shù)組長度*/public ArrayWheelAdapter(T items[], int length) {this.items = items;this.length = length;}

--?ArrayWheelAdapter(T items[]) : 傳入 T 類型對象數(shù)組, 寬度使用默認的寬度;

/*** 構造方法* * @param items* 適配器數(shù)據(jù)源集合 T 類型數(shù)組*/public ArrayWheelAdapter(T items[]) {this(items, DEFAULT_LENGTH);}

實現(xiàn)的父類方法分析 :

-- ?getItem(int index) : 根據(jù)索引獲取數(shù)組中對應位置的對象的字符串類型;

@Overridepublic String getItem(int index) {//如果這個索引值合法, 就返回 item 數(shù)組對應的元素的字符串形式if (index >= 0 && index < items.length) {return items[index].toString();}return null;}

--?getItemsCount() : 獲取數(shù)據(jù)集廣大小, 直接返回數(shù)組大小;

@Overridepublic int getItemsCount() {//返回 item 數(shù)組的長度return items.length;}

--?getMaximumLength() : 獲取 WheelView 的最大寬度;

@Overridepublic int getMaximumLength() {//返回 item 元素的寬度return length;}

(3) 數(shù)字適配器 ( class NumericWheelAdapter implements WheelAdapter?)

NumericWheelAdapter 適配器作用 : 數(shù)字作為 WheelView 適配器的顯示值;

成員變量分析 :?

-- 最小值 : WheelView 數(shù)值顯示的最小值;

/** 設置的最小值 */private int minValue;

-- 最大值 : WheelView 數(shù)值顯示的最大值;

/** 設置的最大值 */private int maxValue;
-- 格式化字符串 : 用于字符串的格式化;

/** 格式化字符串, 用于格式化 貨幣, 科學計數(shù), 十六進制 等格式 */private String format;

構造方法分析 :?

--?NumericWheelAdapter() : 默認的構造方法, 使用默認的最大最小值;

/*** 默認的構造方法, 使用默認的最大最小值*/public NumericWheelAdapter() {this(DEFAULT_MIN_VALUE, DEFAULT_MAX_VALUE);}

--?NumericWheelAdapter(int minValue, int maxValue) : 傳入一個最大最小值;

/*** 構造方法* * @param minValue* 最小值* @param maxValue* 最大值*/public NumericWheelAdapter(int minValue, int maxValue) {this(minValue, maxValue, null);}

--?NumericWheelAdapter(int minValue, int maxValue, String format) : 傳入最大最小值, 以及數(shù)字格式化方式;

/*** 構造方法* * @param minValue* 最小值* @param maxValue* 最大值* @param format* 格式化字符串*/public NumericWheelAdapter(int minValue, int maxValue, String format) {this.minValue = minValue;this.maxValue = maxValue;this.format = format;}

實現(xiàn)的父類方法 :?

-- 獲取條目 : 如果需要格式化, 先進行格式化;

@Overridepublic String getItem(int index) {String result = "";if (index >= 0 && index < getItemsCount()) {int value = minValue + index;//如果 format 不為 null, 那么格式化字符串, 如果為 null, 直接返回數(shù)字if(format != null){result = String.format(format, value);}else{result = Integer.toString(value);}return result;}return null;}
-- 獲取元素個數(shù) :?

@Overridepublic int getItemsCount() {//返回數(shù)字總個數(shù)return maxValue - minValue + 1;}
-- 獲取 WheelView 最大寬度 :?

@Overridepublic int getMaximumLength() {//獲取 最大值 和 最小值 中的 較大的數(shù)字int max = Math.max(Math.abs(maxValue), Math.abs(minValue));//獲取這個數(shù)字 的 字符串形式的 字符串長度int maxLen = Integer.toString(max).length();if (minValue < 0) {maxLen++;}return maxLen;}

2. 監(jiān)聽器相關接口

(1) 條目改變監(jiān)聽器 (?interface OnWheelChangedListener?)

監(jiān)聽器作用 : 在 WheelView 條目改變的時候, 回調(diào)該監(jiān)聽器的接口方法, 執(zhí)行條目改變對應的操作;

接口方法介紹 :?

--?onChanged(WheelView wheel, int oldValue, int newValue) : 傳入 WheelView 組件對象, 以及 舊的 和 新的 條目值索引;

/*** 當前條目改變時回調(diào)該方法* * @param wheel* 條目改變的 WheelView 對象* @param oldValue* WheelView 舊的條目值* @param newValue* WheelView 新的條目值*/void onChanged(WheelView wheel, int oldValue, int newValue);

(2) 滾動監(jiān)聽器 ( interface OnWheelScrollListener?)

滾動監(jiān)聽器作用 : 在 WheelView 滾動動作 開始 和 結束的時候回調(diào)對應的方法, 在對應方法中進行相應的操作;

接口方法介紹 :?

-- 開始滾動方法 : 在滾動開始的時候回調(diào)該方法;

/*** 在 WheelView 滾動開始的時候回調(diào)該接口* * @param wheel* 開始滾動的 WheelView 對象*/void onScrollingStarted(WheelView wheel);

-- 停止?jié)L動方法 : 在滾動結束的時候回調(diào)該方法;

/*** 在 WheelView 滾動結束的時候回調(diào)該接口* * @param wheel* 結束滾動的 WheelView 對象*/void onScrollingFinished(WheelView wheel);

三. WheelView 解析

1. 觸摸 點擊 手勢 動作操作控制組件 模塊

(1) 創(chuàng)建手勢監(jiān)聽器

手勢監(jiān)聽器創(chuàng)建及對應方法 :?

--?onDown(MotionEvent e) : 在按下的時候回調(diào)該方法, e 參數(shù)是按下的事件;

--?onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) : 滾動的時候回調(diào)該方法, e1 滾動第一次按下事件, e2 當前滾動的觸摸事件, X 上一次滾動到這一次滾動 x 軸距離, Y 上一次滾動到這一次滾動 y 軸距離;

--?onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) : 快速急沖滾動時回調(diào)的方法, e1 e2 與上面參數(shù)相同,?velocityX 是手勢在 x 軸的速度,?velocityY 是手勢在 y 軸的速度;

-- 代碼示例 :?

/** 手勢監(jiān)聽器監(jiān)聽到 滾動操作后回調(diào)* * 參數(shù)解析 : * MotionEvent e1 : 觸發(fā)滾動時第一次按下的事件* MotionEvent e2 : 觸發(fā)當前滾動的移動事件* float distanceX : 自從上一次調(diào)用 該方法 到這一次 x 軸滾動的距離, * 注意不是 e1 到 e2 的距離, e1 到 e2 的距離是從開始滾動到現(xiàn)在的滾動距離* float distanceY : 自從上一次回調(diào)該方法到這一次 y 軸滾動的距離* * 返回值 : 如果事件成功觸發(fā), 執(zhí)行完了方法中的操作, 返回true, 否則返回 false * (non-Javadoc)* @see android.view.GestureDetector.SimpleOnGestureListener#onScroll(android.view.MotionEvent, android.view.MotionEvent, float, float)*/public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {//開始滾動, 并回調(diào)滾動監(jiān)聽器集合中監(jiān)聽器的 開始滾動方法startScrolling();doScroll((int) -distanceY);return true;}/** 當一個急沖手勢發(fā)生后 回調(diào)該方法, 會計算出該手勢在 x 軸 y 軸的速率* * 參數(shù)解析 : * -- MotionEvent e1 : 急沖動作的第一次觸摸事件;* -- MotionEvent e2 : 急沖動作的移動發(fā)生的時候的觸摸事件;* -- float velocityX : x 軸的速率* -- float velocityY : y 軸的速率* * 返回值 : 如果執(zhí)行完畢返回 true, 否則返回false, 這個就是自己定義的* * (non-Javadoc)* @see android.view.GestureDetector.SimpleOnGestureListener#onFling(android.view.MotionEvent, android.view.MotionEvent, float, float)*/public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {//計算上一次的 y 軸位置, 當前的條目高度 加上 剩余的 不夠一行高度的那部分lastScrollY = currentItem * getItemHeight() + scrollingOffset;//如果可以循環(huán)最大值是無限大, 不能循環(huán)就是條目數(shù)的高度值int maxY = isCyclic ? 0x7FFFFFFF : adapter.getItemsCount() * getItemHeight();int minY = isCyclic ? -maxY : 0;/** Scroll 開始根據(jù)一個急沖手勢滾動, 滾動的距離與初速度有關* 參數(shù)介紹 : * -- int startX : 開始時的 X軸位置* -- int startY : 開始時的 y軸位置* -- int velocityX : 急沖手勢的 x 軸的初速度, 單位 px/s* -- int velocityY : 急沖手勢的 y 軸的初速度, 單位 px/s* -- int minX : x 軸滾動的最小值* -- int maxX : x 軸滾動的最大值* -- int minY : y 軸滾動的最小值* -- int maxY : y 軸滾動的最大值*/scroller.fling(0, lastScrollY, 0, (int) -velocityY / 2, 0, 0, minY, maxY);setNextMessage(MESSAGE_SCROLL);return true;}};

(2) 創(chuàng)建手勢探測器

手勢探測器創(chuàng)建 : 調(diào)用 其構造函數(shù), 傳入 上下文對象 和 手勢監(jiān)聽器對象;

-- 禁止長按操作 : 調(diào)用?setIsLongpressEnabled(false) 方法, 禁止長按操作, 因為 長按操作會屏蔽滾動事件;

//創(chuàng)建一個手勢處理gestureDetector = new GestureDetector(context, gestureListener);/** 是否允許長按操作, * 如果設置為 true 用戶按下不松開, 會返回一個長按事件, * 如果設置為 false, 按下不松開滑動的話 會收到滾動事件.*/gestureDetector.setIsLongpressEnabled(false);

(3) 將手勢探測器 與 組件結合

關聯(lián)手勢探測器 與 組件 : 在組件的 onTouchEvent(MotionEvent event) 方法中, 調(diào)用手勢探測器的?gestureDetector.onTouchEvent(event) 方法即可;

/** 繼承自 View 的觸摸事件, 當出現(xiàn)觸摸事件的時候, 就會回調(diào)該方法* (non-Javadoc)* @see android.view.View#onTouchEvent(android.view.MotionEvent)*/@Overridepublic boolean onTouchEvent(MotionEvent event) {//獲取適配器WheelAdapter adapter = getAdapter();if (adapter == null) {return true;}/** gestureDetector.onTouchEvent(event) : 分析給定的動作, 如果可用, 調(diào)用 手勢檢測器的 onTouchEvent 方法* -- 參數(shù)解析 : ev , 觸摸事件* -- 返回值 : 如果手勢監(jiān)聽器成功執(zhí)行了該方法, 返回true, 如果執(zhí)行出現(xiàn)意外 返回 false;*/if (!gestureDetector.onTouchEvent(event) && event.getAction() == MotionEvent.ACTION_UP) {justify();}return true;}

2. Scroller 簡介

(1) Scroller 簡介?

Scroller?通用作用 : Scroller?組件并不是一個布局組件, 該組件是運行在后臺的, 通過一些方法設定 Scroller?對象 的操作 或者 動畫, 然后讓 Scroller?運行在后臺中 用于模擬滾動操作, 在適當?shù)臅r機 獲取該對象的坐標信息, 這些信息是在后臺運算出來的;

Scroller?在本 View 中作用 : Android 的這個自定義的 WheelView 組件, 可以平滑的滾動, 當我們做一個加速滑動時, 會根據(jù)速度計算出滑動的距離, 這些數(shù)據(jù)都是在 Scroller?中計算出來的;

(2) 設定 Scroller?對象的動作參數(shù)?

終止?jié)L動?:?

-- 終止?jié)L動 跳轉(zhuǎn)到目標位置 : 終止平緩的動畫, 直接跳轉(zhuǎn)到最終的 x y 軸的坐標位置;

public void abortAnimation()
-- 終止?jié)L動 停止在當前位置 : 強行結束 Scroll 的滾動;

public final void forceFinished(boolean finished)

設置滾動參數(shù) :?

-- 設置最終 x 軸坐標 :?

public void setFinalX(int newX)

-- 設置最終 y 軸坐標 :?

public void setFinalY(int newY)

-- 設置滾動摩擦力 :?

public final void setFriction(float friction)

設置動作 :?

-- 開始滾動 : 傳入?yún)?shù) 開始 x 位置, 開始 y 位置, x 軸滾動距離, y 軸滾動距離;

public void startScroll(int startX, int startY, int dx, int dy)-- 開始滾動 設定時間 : 最后一個參數(shù)是時間, 單位是 ms;

public void startScroll(int startX, int startY, int dx, int dy, int duration)-- 急沖滾動 : 根據(jù)一個 急沖 手勢進行滾動, 傳入?yún)?shù) : x軸開始位置, y軸開始位置, x 軸速度, y 軸速度, x 軸最小速度, x 軸最大速度, y 軸最小速度, y 軸最大速度;

public void fling(int startX, int startY, int velocityX, int velocityY,int minX, int maxX, int minY, int maxY)

延長滾動時間 : 延長滾動的時間, 讓滾動滾的更遠一些;

public void extendDuration(int extend)

(3) 獲取 Scroll 后臺運行參數(shù)?

獲取當前數(shù)據(jù) :?

-- 獲取當前 x 軸坐標 :?

public final int getCurrX()

-- 獲取當前 y 軸坐標 :?

public final int getCurrY()

-- 獲取當前速度 :?

public float getCurrVelocity()

獲取開始結束時的數(shù)據(jù) ?:?

-- 獲取開始 x 軸坐標 :?

public final int getStartX()

-- 獲取開始 y 軸坐標 :?

public final int getStartY()

-- 獲取最終?x 軸坐標 : 該參數(shù)只在急沖滾動時有效;

public final int getFinalX()

-- 獲取最終?y 軸坐標 : 該參數(shù)只在急沖滾動時有效;

public final int getFinalY()

查看是否滾動完畢 :?

public final boolean isFinished()

獲取從開始滾動到現(xiàn)在的時間 :?

public int timePassed()

獲取新位置 : 調(diào)用該方法可以獲取新位置, 如果返回 true 說明動畫還沒執(zhí)行完畢;

public boolean computeScrollOffset()

(4) Scroll 在 WheelView 中的運用

Scroller 創(chuàng)建 :?

//使用默認的 時間 和 插入器 創(chuàng)建一個滾動器scroller = new Scroller(context);

手勢監(jiān)聽器 SimpleOnGestureListener 對象中的 onDown() 方法 : 如果滾動還在執(zhí)行, 那么強行停止 Scroller 滾動;

//按下操作public boolean onDown(MotionEvent e) {//如果滾動在執(zhí)行if (isScrollingPerformed) {//滾動強制停止, 按下的時候不能繼續(xù)滾動scroller.forceFinished(true);//清理信息clearMessages();return true;}return false;}

當手勢監(jiān)聽器 SimpleOnGestureListener?對象中有急沖動作時 onFling() 方法中?: 手勢監(jiān)聽器監(jiān)聽到了 急沖動作, 那么 Scroller 也進行對應操作;

public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {//計算上一次的 y 軸位置, 當前的條目高度 加上 剩余的 不夠一行高度的那部分lastScrollY = currentItem * getItemHeight() + scrollingOffset;//如果可以循環(huán)最大值是無限大, 不能循環(huán)就是條目數(shù)的高度值int maxY = isCyclic ? 0x7FFFFFFF : adapter.getItemsCount() * getItemHeight();int minY = isCyclic ? -maxY : 0;/** Scroll 開始根據(jù)一個急沖手勢滾動, 滾動的距離與初速度有關* 參數(shù)介紹 : * -- int startX : 開始時的 X軸位置* -- int startY : 開始時的 y軸位置* -- int velocityX : 急沖手勢的 x 軸的初速度, 單位 px/s* -- int velocityY : 急沖手勢的 y 軸的初速度, 單位 px/s* -- int minX : x 軸滾動的最小值* -- int maxX : x 軸滾動的最大值* -- int minY : y 軸滾動的最小值* -- int maxY : y 軸滾動的最大值*/scroller.fling(0, lastScrollY, 0, (int) -velocityY / 2, 0, 0, minY, maxY);setNextMessage(MESSAGE_SCROLL);return true;}

動畫控制 Handler 中 :?

-- 滾動 : 獲取當前 Scroller 的 y 軸位置, 與上一次的 y 軸位置對比, 如果 間距 delta 不為0, 就滾動; ?

-- 查看是否停止 : 如果現(xiàn)在距離 到 最終距離 小于最小滾動距離, 強制停止;

-- 執(zhí)行 msg.what 指令 : 如果需要停止, 強制停止, 否則調(diào)整坐標;

/*** 動畫控制器* animation handler* * 可能會造成內(nèi)存泄露 : 添加注解 HandlerLeak* Handler 類應該應該為static類型，否則有可能造成泄露。* 在程序消息隊列中排隊的消息保持了對目標Handler類的應用。* 如果Handler是個內(nèi)部類，那 么它也會保持它所在的外部類的引用。* 為了避免泄露這個外部類，應該將Handler聲明為static嵌套類，并且使用對外部類的弱應用。*/@SuppressLint("HandlerLeak")private Handler animationHandler = new Handler() {public void handleMessage(Message msg) {//回調(diào)該方法獲取當前位置, 如果返回true, 說明動畫還沒有執(zhí)行完畢scroller.computeScrollOffset();//獲取當前 y 位置int currY = scroller.getCurrY();//獲取已經(jīng)滾動了的位置, 使用上一次位置 減去 當前位置int delta = lastScrollY - currY;lastScrollY = currY;if (delta != 0) {//改變值不為 0 , 繼續(xù)滾動doScroll(delta);}/** 如果滾動到了指定的位置, 滾動還沒有停止* 這時需要強制停止*/if (Math.abs(currY - scroller.getFinalY()) < MIN_DELTA_FOR_SCROLLING) {currY = scroller.getFinalY();scroller.forceFinished(true);}/** 如果滾動沒有停止* 再向 Handler 發(fā)送一個停止*/if (!scroller.isFinished()) {animationHandler.sendEmptyMessage(msg.what);} else if (msg.what == MESSAGE_SCROLL) {justify();} else {finishScrolling();}}};

3. StaticLayout?布局容器

(1) StaticLayout 解析

StaticLayout 解析 : 該組件用于顯示文本, 一旦該文本被顯示后, 就不能再編輯, 如果想要修改文本, 使用?DynamicLayout 布局即可;?

-- 使用場景 : 一般情況下不會使用該組件, 當想要自定義組件 或者 想要使用 Canvas 繪制文本時 才使用該布局;

常用方法解析 :?

-- 獲取底部 Padding : 獲取底部 到最后一行文字的 間隔, 單位是 px;

public int getBottomPadding()

-- 獲取頂部 Padding :?

public int getTopPadding()

-- 獲取省略個數(shù) : 獲取某一行需要省略的字符個數(shù);

public int getEllipsisCount(int line)-- 獲取省略開始位置 : 獲取某一行要省略的字符串的第一個位置索引;

public int getEllipsisStart(int line)-- 獲取省略的寬度 : 獲取某一行省略字符串的寬度, 單位 px;

public int getEllipsisStart(int line)-- 獲取是否處理特殊符號 :?

public boolean getLineContainsTab(int line)-- 獲取文字的行數(shù) :?

public int getLineCount()-- 獲取頂部位置 : 獲取某一行頂部的位置;

public int getLineTop(int line)-- 獲取某一行底部位置 :?

public int getLineDescent(int line)-- 獲取行的方向 : 字符串從左至右 還是從右至左;

public final Directions getLineDirections(int line)-- 獲取某行第一個字符索引 : 獲取的是 某一行 第一個字符 在整個字符串的索引;

public int getLineStart(int line)-- 獲取該行段落方向 : 獲取該行文字方向, 左至右 或者 右至左;

public int getParagraphDirection(int line)-- 獲取某個垂直位置顯示的行數(shù) :?

public int getLineForVertical(int vertical)

(2) 布局顯示

布局創(chuàng)建 :?

-- 三種布局 : WheelView 中涉及到了三種 StaticLayout 布局, 普通條目布局 itemLayout, 選中條目布局 valueLayout, 標簽布局 labelLayout;

-- 創(chuàng)建時機 : 在 View 組件 每次 onMeasure() 和 onDraw() 方法中都要重新創(chuàng)建對應布局;

-- 創(chuàng)建布局源碼 :?

/*** 創(chuàng)建布局* * @param widthItems* 布局條目寬度* @param widthLabel* label 寬度*/private void createLayouts(int widthItems, int widthLabel) {/** 創(chuàng)建普通條目布局* 如果 普通條目布局 為 null 或者 普通條目布局的寬度 大于 傳入的寬度, 這時需要重新創(chuàng)建布局* 如果 普通條目布局存在, 并且其寬度小于傳入的寬度, 此時需要將*/if (itemsLayout == null || itemsLayout.getWidth() > widthItems) {/** android.text.StaticLayout.StaticLayout(* CharSequence source, TextPaint paint, * int width, Alignment align, * float spacingmult, float spacingadd, boolean includepad)* 傳入?yún)?shù)介紹 : * CharSequence source : 需要分行顯示的字符串* TextPaint paint : 繪制字符串的畫筆* int width : 條目的寬度* Alignment align : Layout 的對齊方式, ALIGN_CENTER 居中對齊, ALIGN_NORMAL 左對齊, Alignment.ALIGN_OPPOSITE 右對齊* float spacingmult : 行間距, 1.5f 代表 1.5 倍字體高度* float spacingadd : 基礎行距上增加多少 , 真實行間距 等于 spacingmult 和 spacingadd 的和* boolean includepad : */itemsLayout = new StaticLayout(buildText(isScrollingPerformed), itemsPaint, widthItems,widthLabel > 0 ? Layout.Alignment.ALIGN_OPPOSITE : Layout.Alignment.ALIGN_CENTER, 1,ADDITIONAL_ITEM_HEIGHT, false);} else {//調(diào)用 Layout 內(nèi)置的方法 increaseWidthTo 將寬度提升到指定的寬度itemsLayout.increaseWidthTo(widthItems);}/** 創(chuàng)建選中條目*/if (!isScrollingPerformed && (valueLayout == null || valueLayout.getWidth() > widthItems)) {String text = getAdapter() != null ? getAdapter().getItem(currentItem) : null;valueLayout = new StaticLayout(text != null ? text : "", valuePaint, widthItems,widthLabel > 0 ? Layout.Alignment.ALIGN_OPPOSITE : Layout.Alignment.ALIGN_CENTER, 1,ADDITIONAL_ITEM_HEIGHT, false);} else if (isScrollingPerformed) {valueLayout = null;} else {valueLayout.increaseWidthTo(widthItems);}/** 創(chuàng)建標簽條目*/if (widthLabel > 0) {if (labelLayout == null || labelLayout.getWidth() > widthLabel) {labelLayout = new StaticLayout(label, valuePaint, widthLabel, Layout.Alignment.ALIGN_NORMAL, 1,ADDITIONAL_ITEM_HEIGHT, false);} else {labelLayout.increaseWidthTo(widthLabel);}}}

4. 監(jiān)聽器管理

監(jiān)聽器集合維護?:?

-- 定義監(jiān)聽器集合 : 在 View 組件中 定義一個 List 集合, 集合中存放 監(jiān)聽器元素;

/** 條目改變監(jiān)聽器集合 封裝了條目改變方法, 當條目改變時回調(diào) */private List<OnWheelChangedListener> changingListeners = new LinkedList<OnWheelChangedListener>();/** 條目滾動監(jiān)聽器集合, 該監(jiān)聽器封裝了 開始滾動方法, 結束滾動方法 */private List<OnWheelScrollListener> scrollingListeners = new LinkedList<OnWheelScrollListener>();

-- 提供對監(jiān)聽器集合的添加刪除接口 : 提供 對集合 進行 添加 和 刪除的接口;

/*** 添加 WheelView 選擇的元素改變監(jiān)聽器* * @param listener* the listener*/public void addChangingListener(OnWheelChangedListener listener) {changingListeners.add(listener);}/*** 移除 WheelView 元素改變監(jiān)聽器* * @param listener* the listener*/public void removeChangingListener(OnWheelChangedListener listener) {changingListeners.remove(listener);}
-- 調(diào)用監(jiān)聽器接口 :?

/*** 回調(diào)元素改變監(jiān)聽器集合的元素改變監(jiān)聽器元素的元素改變方法* * @param oldValue* 舊的 WheelView選中的值* @param newValue* 新的 WheelView選中的值*/protected void notifyChangingListeners(int oldValue, int newValue) {for (OnWheelChangedListener listener : changingListeners) {listener.onChanged(this, oldValue, newValue);}}

5. 自定義 View 對象的寬高?

(1) onMeasure 方法?MeasureSpec 模式解析

常規(guī)處理方法 : 組件的寬高有三種情況, widthMeasureSpec 有三種模式?最大模式, 精準模式, 未定義模式;

-- 最大模式 : 在 組件的寬或高 warp_content 屬性時, 會使用最大模式;

-- 精準模式 : 當給組件寬 或者高 定義一個值 或者 使用 match_parent 時, 會使用精準模式;

處理寬高的常規(guī)代碼 :?

@Overrideprotected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {super.onMeasure(widthMeasureSpec, heightMeasureSpec);//獲取寬度 和 高度的模式 和 大小int widthMode = MeasureSpec.getMode(widthMeasureSpec);int heightMode = MeasureSpec.getMode(heightMeasureSpec);int widthSize = MeasureSpec.getSize(widthMeasureSpec);int heightSize = MeasureSpec.getSize(heightMeasureSpec);Log.i(TAG, "寬度 : widthMode : " + getMode(widthMode) + " , widthSize : " + widthSize + "\n" + "高度 : heightMode : " + getMode(heightMode) + " , heightSize : " + heightSize);int width = 0;int height = 0;/** 精準模式* 精準模式下 高度就是精確的高度*/if (heightMode == MeasureSpec.EXACTLY) {height = heightSize;//未定義模式 和 最大模式} else {//未定義模式下 獲取布局需要的高度height = 100;//最大模式下 獲取 布局高度 和 布局所需高度的最小值if (heightMode == MeasureSpec.AT_MOST) {height = Math.min(height, heightSize);}}if (widthMode == MeasureSpec.EXACTLY) {width = widthSize;} else {width = 100;if (heightMode == MeasureSpec.AT_MOST) {width = Math.min(width, widthSize);}}Log.i(TAG, "最終結果 : 寬度 : " + width + " , 高度 : " + height);setMeasuredDimension(width, height);}public String getMode(int mode) {String modeName = "";if(mode == MeasureSpec.EXACTLY){modeName = "精準模式";}else if(mode == MeasureSpec.AT_MOST){modeName = "最大模式";}else if(mode == MeasureSpec.UNSPECIFIED){modeName = "未定義模式";}return modeName;}

(2) 測試上述代碼

使用下面的自定義組件測試 :?

package cn.org.octopus.wheelview;import android.content.Context; import android.graphics.Canvas; import android.graphics.Color; import android.util.AttributeSet; import android.util.Log; import android.view.View;public class MyView extends View {public static final String TAG = "octopus.my.view";public MyView(Context context, AttributeSet attrs) {super(context, attrs);}public MyView(Context context) {super(context);}public MyView(Context context, AttributeSet attrs, int defStyle) {super(context, attrs, defStyle);}@Overrideprotected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {super.onMeasure(widthMeasureSpec, heightMeasureSpec);//獲取寬度 和 高度的模式 和 大小int widthMode = MeasureSpec.getMode(widthMeasureSpec);int heightMode = MeasureSpec.getMode(heightMeasureSpec);int widthSize = MeasureSpec.getSize(widthMeasureSpec);int heightSize = MeasureSpec.getSize(heightMeasureSpec);Log.i(TAG, "寬度 : widthMode : " + getMode(widthMode) + " , widthSize : " + widthSize + "\n" + "高度 : heightMode : " + getMode(heightMode) + " , heightSize : " + heightSize);int width = 0;int height = 0;/** 精準模式* 精準模式下 高度就是精確的高度*/if (heightMode == MeasureSpec.EXACTLY) {height = heightSize;//未定義模式 和 最大模式} else {//未定義模式下 獲取布局需要的高度height = 100;//最大模式下 獲取 布局高度 和 布局所需高度的最小值if (heightMode == MeasureSpec.AT_MOST) {height = Math.min(height, heightSize);}}if (widthMode == MeasureSpec.EXACTLY) {width = widthSize;} else {width = 100;if (heightMode == MeasureSpec.AT_MOST) {width = Math.min(width, widthSize);}}Log.i(TAG, "最終結果 : 寬度 : " + width + " , 高度 : " + height);setMeasuredDimension(width, height);}public String getMode(int mode) {String modeName = "";if(mode == MeasureSpec.EXACTLY){modeName = "精準模式";}else if(mode == MeasureSpec.AT_MOST){modeName = "最大模式";}else if(mode == MeasureSpec.UNSPECIFIED){modeName = "未定義模式";}return modeName;}@Overrideprotected void onDraw(Canvas canvas) {super.onDraw(canvas);canvas.drawColor(Color.BLUE);}}

給定具體值情況 :?

-- 組件信息 :?

<cn.org.octopus.wheelview.MyViewandroid:layout_width="300dip"android:layout_height="300dip"/>-- 日志信息 :?

11-30 01:40:24.304: I/octopus.my.view(2609): 寬度 : widthMode : 精準模式 , widthSize : 450 11-30 01:40:24.304: I/octopus.my.view(2609): 高度 : heightMode : 最大模式 , heightSize : 850 11-30 01:40:24.304: I/octopus.my.view(2609): 最終結果 : 寬度 : 450 , 高度 : 100 11-30 01:40:24.304: I/octopus.my.view(2609): 寬度 : widthMode : 精準模式 , widthSize : 450 11-30 01:40:24.304: I/octopus.my.view(2609): 高度 : heightMode : 精準模式 , heightSize : 450 11-30 01:40:24.304: I/octopus.my.view(2609): 最終結果 : 寬度 : 450 , 高度 : 450 11-30 01:40:24.335: I/octopus.my.view(2609): 寬度 : widthMode : 精準模式 , widthSize : 450 11-30 01:40:24.335: I/octopus.my.view(2609): 高度 : heightMode : 最大模式 , heightSize : 850 11-30 01:40:24.335: I/octopus.my.view(2609): 最終結果 : 寬度 : 450 , 高度 : 100 11-30 01:40:24.335: I/octopus.my.view(2609): 寬度 : widthMode : 精準模式 , widthSize : 450 11-30 01:40:24.335: I/octopus.my.view(2609): 高度 : heightMode : 精準模式 , heightSize : 450 11-30 01:40:24.335: I/octopus.my.view(2609): 最終結果 : 寬度 : 450 , 高度 : 450

warp_content 情況 :?

-- 組件信息 :?

<cn.org.octopus.wheelview.MyViewandroid:layout_width="wrap_content"android:layout_height="wrap_content"/>-- 日志信息 :?

11-30 01:37:47.351: I/octopus.my.view(1803): 寬度 : widthMode : 最大模式 , widthSize : 492 11-30 01:37:47.351: I/octopus.my.view(1803): 高度 : heightMode : 最大模式 , heightSize : 850 11-30 01:37:47.351: I/octopus.my.view(1803): 最終結果 : 寬度 : 100 , 高度 : 100 11-30 01:37:47.351: I/octopus.my.view(1803): 寬度 : widthMode : 精準模式 , widthSize : 100 11-30 01:37:47.351: I/octopus.my.view(1803): 高度 : heightMode : 最大模式 , heightSize : 802 11-30 01:37:47.351: I/octopus.my.view(1803): 最終結果 : 寬度 : 100 , 高度 : 100 11-30 01:37:47.390: I/octopus.my.view(1803): 寬度 : widthMode : 最大模式 , widthSize : 492 11-30 01:37:47.390: I/octopus.my.view(1803): 高度 : heightMode : 最大模式 , heightSize : 850 11-30 01:37:47.390: I/octopus.my.view(1803): 最終結果 : 寬度 : 100 , 高度 : 100 11-30 01:37:47.390: I/octopus.my.view(1803): 寬度 : widthMode : 精準模式 , widthSize : 100 11-30 01:37:47.390: I/octopus.my.view(1803): 高度 : heightMode : 最大模式 , heightSize : 802 11-30 01:37:47.390: I/octopus.my.view(1803): 最終結果 : 寬度 : 100 , 高度 : 100

match_parent 情況 :?

-- 組件信息 :?

<cn.org.octopus.wheelview.MyViewandroid:layout_width="match_parent"android:layout_height="match_parent"/>

-- 日志信息 :?

11-30 01:39:08.296: I/octopus.my.view(2249): 寬度 : widthMode : 精準模式 , widthSize : 492 11-30 01:39:08.296: I/octopus.my.view(2249): 高度 : heightMode : 精準模式 , heightSize : 850 11-30 01:39:08.296: I/octopus.my.view(2249): 最終結果 : 寬度 : 492 , 高度 : 850 11-30 01:39:08.296: I/octopus.my.view(2249): 寬度 : widthMode : 精準模式 , widthSize : 492 11-30 01:39:08.296: I/octopus.my.view(2249): 高度 : heightMode : 精準模式 , heightSize : 802 11-30 01:39:08.296: I/octopus.my.view(2249): 最終結果 : 寬度 : 492 , 高度 : 802 11-30 01:39:08.328: I/octopus.my.view(2249): 寬度 : widthMode : 精準模式 , widthSize : 492 11-30 01:39:08.328: I/octopus.my.view(2249): 高度 : heightMode : 精準模式 , heightSize : 850 11-30 01:39:08.328: I/octopus.my.view(2249): 最終結果 : 寬度 : 492 , 高度 : 850 11-30 01:39:08.328: I/octopus.my.view(2249): 寬度 : widthMode : 精準模式 , widthSize : 492 11-30 01:39:08.328: I/octopus.my.view(2249): 高度 : heightMode : 精準模式 , heightSize : 802 11-30 01:39:08.328: I/octopus.my.view(2249): 最終結果 : 寬度 : 492 , 高度 : 802

博客地址?:?http://blog.csdn.net/shulianghan/article/details/41520569#t17

代碼下載?:?

--?GitHub?:?https://github.com/han1202012/WheelViewDemo.git?

--?CSDN?:?http://download.csdn.net/detail/han1202012/8208997?;

四. 詳細代碼?

1.?WheelAdapter

package cn.org.octopus.wheelview.widget;/*** WheelView 適配器接口* @author han_shuliang(octopus_truth@163.com)**/ public interface WheelAdapter {/*** 獲取條目的個數(shù)* * @return * WheelView 的條目個數(shù)*/public int getItemsCount();/*** 根據(jù)索引位置獲取 WheelView 的條目* * @param index* 條目的索引* @return * WheelView 上顯示的條目的值*/public String getItem(int index);/*** 獲取條目的最大長度. 用來定義 WheelView 的寬度. 如果返回 -1, 就會使用默認寬度* * @return * 條目的最大寬度 或者 -1*/public int getMaximumLength(); }

2.?ArrayWheelAdapter

package cn.org.octopus.wheelview.widget;/*** WheelView 的適配器類* * @param <T>* 元素類型*/ public class ArrayWheelAdapter<T> implements WheelAdapter {/** 適配器的 元素集合(數(shù)據(jù)源) 默認長度為 -1 */public static final int DEFAULT_LENGTH = -1;/** 適配器的數(shù)據(jù)源 */private T items[];/** WheelView 的寬度 */private int length;/*** 構造方法* * @param items* 適配器數(shù)據(jù)源 集合 T 類型的數(shù)組* @param length* 適配器數(shù)據(jù)源 集合 T 數(shù)組長度*/public ArrayWheelAdapter(T items[], int length) {this.items = items;this.length = length;}/*** 構造方法* * @param items* 適配器數(shù)據(jù)源集合 T 類型數(shù)組*/public ArrayWheelAdapter(T items[]) {this(items, DEFAULT_LENGTH);}@Overridepublic String getItem(int index) {//如果這個索引值合法, 就返回 item 數(shù)組對應的元素的字符串形式if (index >= 0 && index < items.length) {return items[index].toString();}return null;}@Overridepublic int getItemsCount() {//返回 item 數(shù)組的長度return items.length;}@Overridepublic int getMaximumLength() {//返回 item 元素的寬度return length;}}

3.?NumericWheelAdapter

package cn.org.octopus.wheelview.widget;/*** 顯示數(shù)字的 WheelAdapter*/ public class NumericWheelAdapter implements WheelAdapter {/** 默認最小值 */public static final int DEFAULT_MAX_VALUE = 9;/** 默認最大值 */private static final int DEFAULT_MIN_VALUE = 0;/** 設置的最小值 */private int minValue;/** 設置的最大值 */private int maxValue;/** 格式化字符串, 用于格式化 貨幣, 科學計數(shù), 十六進制 等格式 */private String format;/*** 默認的構造方法, 使用默認的最大最小值*/public NumericWheelAdapter() {this(DEFAULT_MIN_VALUE, DEFAULT_MAX_VALUE);}/*** 構造方法* * @param minValue* 最小值* @param maxValue* 最大值*/public NumericWheelAdapter(int minValue, int maxValue) {this(minValue, maxValue, null);}/*** 構造方法* * @param minValue* 最小值* @param maxValue* 最大值* @param format* 格式化字符串*/public NumericWheelAdapter(int minValue, int maxValue, String format) {this.minValue = minValue;this.maxValue = maxValue;this.format = format;}@Overridepublic String getItem(int index) {String result = "";if (index >= 0 && index < getItemsCount()) {int value = minValue + index;//如果 format 不為 null, 那么格式化字符串, 如果為 null, 直接返回數(shù)字if(format != null){result = String.format(format, value);}else{result = Integer.toString(value);}return result;}return null;}@Overridepublic int getItemsCount() {//返回數(shù)字總個數(shù)return maxValue - minValue + 1;}@Overridepublic int getMaximumLength() {//獲取 最大值 和 最小值 中的 較大的數(shù)字int max = Math.max(Math.abs(maxValue), Math.abs(minValue));//獲取這個數(shù)字 的 字符串形式的 字符串長度int maxLen = Integer.toString(max).length();if (minValue < 0) {maxLen++;}return maxLen;} }

4.?OnWheelChangedListener

package cn.org.octopus.wheelview.widget;/*** 條目改變監(jiān)聽器*/ public interface OnWheelChangedListener {/*** 當前條目改變時回調(diào)該方法* * @param wheel* 條目改變的 WheelView 對象* @param oldValue* WheelView 舊的條目值* @param newValue* WheelView 新的條目值*/void onChanged(WheelView wheel, int oldValue, int newValue); }

5.?OnWheelScrollListener

package cn.org.octopus.wheelview.widget;/*** WheelView 滾動監(jiān)聽器*/ public interface OnWheelScrollListener {/*** 在 WheelView 滾動開始的時候回調(diào)該接口* * @param wheel* 開始滾動的 WheelView 對象*/void onScrollingStarted(WheelView wheel);/*** 在 WheelView 滾動結束的時候回調(diào)該接口* * @param wheel* 結束滾動的 WheelView 對象*/void onScrollingFinished(WheelView wheel); }

6. WheelView

package cn.org.octopus.wheelview.widget;import java.util.LinkedList; import java.util.List;import cn.org.octopus.wheelview.R; import android.annotation.SuppressLint; import android.content.Context; import android.graphics.Canvas; import android.graphics.Paint; import android.graphics.Rect; import android.graphics.drawable.Drawable; import android.graphics.drawable.GradientDrawable; import android.graphics.drawable.GradientDrawable.Orientation; import android.os.Handler; import android.os.Message; import android.text.Layout; import android.text.StaticLayout; import android.text.TextPaint; import android.util.AttributeSet; import android.view.GestureDetector; import android.view.GestureDetector.SimpleOnGestureListener; import android.view.MotionEvent; import android.view.View; import android.view.animation.Interpolator; import android.widget.Scroller;/*** WheelView 主對象*/ public class WheelView extends View {/** 滾動花費時間 Scrolling duration */private static final int SCROLLING_DURATION = 400;/** 最小的滾動值, 每次最少滾動一個單位 */private static final int MIN_DELTA_FOR_SCROLLING = 1;/** 當前條目中的文字顏色 */private static final int VALUE_TEXT_COLOR = 0xF0FF6347;/** 非當前條目的文字顏色 */private static final int ITEMS_TEXT_COLOR = 0xFF000000;/** 頂部和底部的陰影顏色 *///private static final int[] SHADOWS_COLORS = new int[] { 0xFF5436EE, 0x0012CEAE, 0x0012CEAE };private static final int[] SHADOWS_COLORS = new int[] { 0xFF111111, 0x00AAAAAA, 0x00AAAAAA };/** 額外的條目高度 Additional items height (is added to standard text item height) */private static final int ADDITIONAL_ITEM_HEIGHT = 15;/** 字體大小 */private static final int TEXT_SIZE = 24;/** 頂部 和 底部 條目的隱藏大小, * 如果是正數(shù) 會隱藏一部份, * 0 頂部 和 底部的字正好緊貼 邊緣, * 負數(shù)時 頂部和底部 與 字有一定間距 */private static final int ITEM_OFFSET = TEXT_SIZE / 5;/** Additional width for items layout */private static final int ADDITIONAL_ITEMS_SPACE = 10;/** Label offset */private static final int LABEL_OFFSET = 8;/** Left and right padding value */private static final int PADDING = 10;/** 默認的可顯示的條目數(shù) */private static final int DEF_VISIBLE_ITEMS = 5;/** WheelView 適配器 */private WheelAdapter adapter = null;/** 當前顯示的條目索引 */private int currentItem = 0;/** 條目寬度 */private int itemsWidth = 0;/** 標簽寬度 */private int labelWidth = 0;/** 可見的條目數(shù) */private int visibleItems = DEF_VISIBLE_ITEMS;/** 條目高度 */private int itemHeight = 0;/** 繪制普通條目畫筆 */private TextPaint itemsPaint;/** 繪制選中條目畫筆 */private TextPaint valuePaint;/** 普通條目布局* StaticLayout 布局用于控制 TextView 組件, 一般情況下不會直接使用該組件, * 除非你自定義一個組件 或者 想要直接調(diào)用 Canvas.drawText() 方法* */private StaticLayout itemsLayout;private StaticLayout labelLayout;/** 選中條目布局 */private StaticLayout valueLayout;/** 標簽 在選中條目的右邊出現(xiàn) */private String label;/** 選中條目的背景圖片 */private Drawable centerDrawable;/** 頂部陰影圖片 */private GradientDrawable topShadow;/** 底部陰影圖片 */private GradientDrawable bottomShadow;/** 是否在滾動 */private boolean isScrollingPerformed;/** 滾動的位置 */private int scrollingOffset;/** 手勢檢測器 */private GestureDetector gestureDetector;/** * Scroll 類封裝了滾動動作. * 開發(fā)者可以使用 Scroll 或者 Scroll 實現(xiàn)類 去收集產(chǎn)生一個滾動動畫所需要的數(shù)據(jù), 返回一個急沖滑動的手勢.* 該對象可以追蹤隨著時間推移滾動的偏移量, 但是這些對象不會自動向 View 對象提供這些位置.* 如果想要使?jié)L動動畫看起來比較平滑, 開發(fā)者需要在適當?shù)臅r機 獲取 和 使用新的坐標; * */private Scroller scroller;/** 之前所在的 y 軸位置 */private int lastScrollY;/** 是否循環(huán) */boolean isCyclic = false;/** 條目改變監(jiān)聽器集合 封裝了條目改變方法, 當條目改變時回調(diào) */private List<OnWheelChangedListener> changingListeners = new LinkedList<OnWheelChangedListener>();/** 條目滾動監(jiān)聽器集合, 該監(jiān)聽器封裝了 開始滾動方法, 結束滾動方法 */private List<OnWheelScrollListener> scrollingListeners = new LinkedList<OnWheelScrollListener>();/*** 構造方法*/public WheelView(Context context, AttributeSet attrs, int defStyle) {super(context, attrs, defStyle);initData(context);}/*** 構造方法*/public WheelView(Context context, AttributeSet attrs) {super(context, attrs);initData(context);}/*** 構造方法*/public WheelView(Context context) {super(context);initData(context);}/*** 初始化數(shù)據(jù)* * @param context* 上下文對象*/private void initData(Context context) {//創(chuàng)建一個手勢處理gestureDetector = new GestureDetector(context, gestureListener);/** 是否允許長按操作, * 如果設置為 true 用戶按下不松開, 會返回一個長按事件, * 如果設置為 false, 按下不松開滑動的話 會收到滾動事件.*/gestureDetector.setIsLongpressEnabled(false);//使用默認的 時間 和 插入器 創(chuàng)建一個滾動器scroller = new Scroller(context);}/*** 獲取該 WheelView 的適配器* * @return * 返回適配器*/public WheelAdapter getAdapter() {return adapter;}/*** 設置適配器* * @param adapter* 要設置的適配器*/public void setAdapter(WheelAdapter adapter) {this.adapter = adapter;invalidateLayouts();invalidate();}/*** 設置 Scroll 的插入器* * @param interpolator* the interpolator*/public void setInterpolator(Interpolator interpolator) {//強制停止?jié)L動scroller.forceFinished(true);//創(chuàng)建一個 Scroll 對象scroller = new Scroller(getContext(), interpolator);}/*** 獲取課件條目數(shù)* * @return the count of visible items*/public int getVisibleItems() {return visibleItems;}/*** 設置可見條目數(shù)* * @param count* the new count*/public void setVisibleItems(int count) {visibleItems = count;invalidate();}/*** 獲取標簽* * @return the label*/public String getLabel() {return label;}/*** 設置標簽* * @param newLabel* the label to set*/public void setLabel(String newLabel) {if (label == null || !label.equals(newLabel)) {label = newLabel;labelLayout = null;invalidate();}}/*** 添加 WheelView 選擇的元素改變監(jiān)聽器* * @param listener* the listener*/public void addChangingListener(OnWheelChangedListener listener) {changingListeners.add(listener);}/*** 移除 WheelView 元素改變監(jiān)聽器* * @param listener* the listener*/public void removeChangingListener(OnWheelChangedListener listener) {changingListeners.remove(listener);}/*** 回調(diào)元素改變監(jiān)聽器集合的元素改變監(jiān)聽器元素的元素改變方法* * @param oldValue* 舊的 WheelView選中的值* @param newValue* 新的 WheelView選中的值*/protected void notifyChangingListeners(int oldValue, int newValue) {for (OnWheelChangedListener listener : changingListeners) {listener.onChanged(this, oldValue, newValue);}}/*** 添加 WheelView 滾動監(jiān)聽器* * @param listener* the listener*/public void addScrollingListener(OnWheelScrollListener listener) {scrollingListeners.add(listener);}/*** 移除 WheelView 滾動監(jiān)聽器* * @param listener* the listener*/public void removeScrollingListener(OnWheelScrollListener listener) {scrollingListeners.remove(listener);}/*** 通知監(jiān)聽器開始滾動*/protected void notifyScrollingListenersAboutStart() {for (OnWheelScrollListener listener : scrollingListeners) {//回調(diào)開始滾動方法listener.onScrollingStarted(this);}}/*** 通知監(jiān)聽器結束滾動*/protected void notifyScrollingListenersAboutEnd() {for (OnWheelScrollListener listener : scrollingListeners) {//回調(diào)滾動結束方法listener.onScrollingFinished(this);}}/*** 獲取當前選中元素的索引* * @return * 當前元素索引*/public int getCurrentItem() {return currentItem;}/*** 設置當前元素的位置, 如果索引是錯誤的 不進行任何操作* -- 需要考慮該 WheelView 是否能循環(huán)* -- 根據(jù)是否需要滾動動畫來確定是 ①滾動到目的位置 還是 ②晴空所有條目然后重繪* * @param index* 要設置的元素索引值* @param animated* 動畫標志位*/public void setCurrentItem(int index, boolean animated) {//如果沒有適配器或者元素個數(shù)為0 直接返回if (adapter == null || adapter.getItemsCount() == 0) {return; // throw?}//目標索引小于 0 或者大于 元素索引最大值(個數(shù) -1)if (index < 0 || index >= adapter.getItemsCount()) {//入股WheelView 可循環(huán), 修正索引值, 如果不可循環(huán)直接返回if (isCyclic) {while (index < 0) {index += adapter.getItemsCount();}index %= adapter.getItemsCount();} else {return; // throw?}}//如果當前的索引不是傳入的 索引if (index != currentItem) {/** 如果需要動畫, 就滾動到目標位置* 如果不需要動畫, 重新設置布局*/if (animated) {/** 開始滾動, 每個元素滾動間隔 400 ms, 滾動次數(shù)是 目標索引值 減去 當前索引值, 這是滾動的真實方法*/scroll(index - currentItem, SCROLLING_DURATION);} else {//所有布局設置為 null, 滾動位置設置為 0invalidateLayouts();int old = currentItem;currentItem = index;//便利回調(diào)元素改變監(jiān)聽器集合中的監(jiān)聽器元素中的元素改變方法notifyChangingListeners(old, currentItem);//重繪invalidate();}}}/*** 設置當前選中的條目, 沒有動畫, 當索引出錯不做任何操作* * @param index* 要設置的索引*/public void setCurrentItem(int index) {setCurrentItem(index, false);}/*** 獲取 WheelView 是否可以循環(huán)* -- 如果可循環(huán) : 第一個之前是最后一個, 最后一個之后是第一個;* -- 如果不可循環(huán) : 到第一個就不能上翻, 最后一個不能下翻 * * @return*/public boolean isCyclic() {return isCyclic;}/*** 設置 WheelView 循環(huán)標志* * @param isCyclic* the flag to set*/public void setCyclic(boolean isCyclic) {this.isCyclic = isCyclic;invalidate();invalidateLayouts();}/*** 使布局無效* 將 選中條目 和 普通條目設置為 null, 滾動位置設置為0*/private void invalidateLayouts() {itemsLayout = null;valueLayout = null;scrollingOffset = 0;}/*** 初始化資源*/private void initResourcesIfNecessary() {/** 設置繪制普通條目的畫筆, 允許抗拒齒, 允許 fake-bold* 設置文字大小為 24*/if (itemsPaint == null) {itemsPaint = new TextPaint(Paint.ANTI_ALIAS_FLAG | Paint.FAKE_BOLD_TEXT_FLAG);itemsPaint.setTextSize(TEXT_SIZE);}/** 設置繪制選中條目的畫筆* 設置文字大小 24*/if (valuePaint == null) {valuePaint = new TextPaint(Paint.ANTI_ALIAS_FLAG | Paint.FAKE_BOLD_TEXT_FLAG | Paint.DITHER_FLAG);valuePaint.setTextSize(TEXT_SIZE);valuePaint.setShadowLayer(0.1f, 0, 0.1f, 0xFFC0C0C0);}//選中的條目背景if (centerDrawable == null) {centerDrawable = getContext().getResources().getDrawable(R.drawable.wheel_val);}//創(chuàng)建頂部陰影圖片if (topShadow == null) {/** 構造方法中傳入顏色漸變方向* 陰影顏色*/topShadow = new GradientDrawable(Orientation.TOP_BOTTOM, SHADOWS_COLORS);}//創(chuàng)建底部陰影圖片if (bottomShadow == null) {bottomShadow = new GradientDrawable(Orientation.BOTTOM_TOP, SHADOWS_COLORS);}/** 設置 View 組件的背景*/setBackgroundResource(R.drawable.wheel_bg);}/*** 計算布局期望的高度* * @param layout* 組件的布局的* @return * 布局需要的高度*/private int getDesiredHeight(Layout layout) {if (layout == null) {return 0;}/** 布局需要的高度是 條目個數(shù) * 可見條目數(shù) 減去 頂部和底部隱藏的一部份 減去 額外的條目高度*/int desired = getItemHeight() * visibleItems - ITEM_OFFSET * 2 - ADDITIONAL_ITEM_HEIGHT;// 將計算的布局高度 與 最小高度比較, 取最大值desired = Math.max(desired, getSuggestedMinimumHeight());return desired;}/*** 根據(jù)條目獲取字符串* * @param index* 條目索引* @return * 條目顯示的字符串*/private String getTextItem(int index) {if (adapter == null || adapter.getItemsCount() == 0) {return null;}//適配器顯示的字符串個數(shù)int count = adapter.getItemsCount();//考慮 index 小于 0 的情況if ((index < 0 || index >= count) && !isCyclic) {return null;} else {while (index < 0) {index = count + index;}}//index 大于 0index %= count;return adapter.getItem(index);}/*** 根據(jù)當前值創(chuàng)建 字符串* * @param useCurrentValue* 是否在滾動* @return the text* 生成的字符串*/private String buildText(boolean useCurrentValue) {//創(chuàng)建字符串容器StringBuilder itemsText = new StringBuilder();//計算出顯示的條目相對位置, 例如顯示 5個, 第 3 個是正中見選中的布局int addItems = visibleItems / 2 + 1;/** 遍歷顯示的條目* 獲取當前顯示條目 上下 各 addItems 個文本, 將該文本添加到顯示文本中去* 如果不是最后一個 都加上回車*/for (int i = currentItem - addItems; i <= currentItem + addItems; i++) {//如果在滾動if (useCurrentValue || i != currentItem) {String text = getTextItem(i);if (text != null) {itemsText.append(text);}}if (i < currentItem + addItems) {itemsText.append("\n");}}return itemsText.toString();}/*** 返回 條目的字符串* * @return * 條目最大寬度*/private int getMaxTextLength() {WheelAdapter adapter = getAdapter();if (adapter == null) {return 0;}//如果獲取的最大條目寬度不為 -1, 可以直接返回該條目寬度int adapterLength = adapter.getMaximumLength();if (adapterLength > 0) {return adapterLength;}String maxText = null;int addItems = visibleItems / 2;/** 遍歷當前顯示的條目, 獲取字符串長度最長的那個, 返回這個最長的字符串長度*/for (int i = Math.max(currentItem - addItems, 0); i < Math.min(currentItem + visibleItems,adapter.getItemsCount()); i++) {String text = adapter.getItem(i);if (text != null && (maxText == null || maxText.length() < text.length())) {maxText = text;}}return maxText != null ? maxText.length() : 0;}/*** 獲取每個條目的高度* * @return * 條目的高度*/private int getItemHeight() {//如果條目高度不為 0, 直接返回if (itemHeight != 0) {return itemHeight;//如果條目的高度為 0, 并且普通條目布局不為null, 條目個數(shù)大于 2 } else if (itemsLayout != null && itemsLayout.getLineCount() > 2) {/** itemsLayout.getLineTop(2) : 獲取頂部第二行上面的垂直(y軸)位置, 如果行數(shù)等于*/itemHeight = itemsLayout.getLineTop(2) - itemsLayout.getLineTop(1);return itemHeight;}//如果上面都不符合, 使用整體高度處以 顯示條目數(shù)return getHeight() / visibleItems;}/*** 計算寬度并創(chuàng)建文字布局* * @param widthSize* 輸入的布局寬度* @param mode* 布局模式* @return * 計算的寬度*/private int calculateLayoutWidth(int widthSize, int mode) {initResourcesIfNecessary();int width = widthSize;//獲取最長的條目顯示字符串字符個數(shù)int maxLength = getMaxTextLength();if (maxLength > 0) {/** 使用方法 FloatMath.ceil() 方法有以下警告* Use java.lang.Math#ceil instead of android.util.FloatMath#ceil() since it is faster as of API 8*///float textWidth = FloatMath.ceil(Layout.getDesiredWidth("0", itemsPaint));//向上取整 計算一個字符串寬度float textWidth = (float) Math.ceil(Layout.getDesiredWidth("0", itemsPaint));//獲取字符串總的寬度itemsWidth = (int) (maxLength * textWidth);} else {itemsWidth = 0;}//總寬度加上一些間距itemsWidth += ADDITIONAL_ITEMS_SPACE; // make it some more//計算 label 的長度labelWidth = 0;if (label != null && label.length() > 0) {labelWidth = (int) Math.ceil(Layout.getDesiredWidth(label, valuePaint));//labelWidth = (int) FloatMath.ceil(Layout.getDesiredWidth(label, valuePaint));}boolean recalculate = false;//精準模式if (mode == MeasureSpec.EXACTLY) {//精準模式下, 寬度就是給定的寬度width = widthSize;recalculate = true;} else {//未定義模式width = itemsWidth + labelWidth + 2 * PADDING;if (labelWidth > 0) {width += LABEL_OFFSET;}// 獲取 ( 計算出來的寬度 與 最小寬度的 ) 最大值width = Math.max(width, getSuggestedMinimumWidth());//最大模式 如果 給定的寬度 小于 計算出來的寬度, 那么使用最小的寬度 ( 給定寬度 | 計算出來的寬度 )if (mode == MeasureSpec.AT_MOST && widthSize < width) {width = widthSize;recalculate = true;}}/** 重新計算寬度 , 如果寬度是給定的寬度, 不是我們計算出來的寬度, 需要重新進行計算* 重新計算的寬度是用于* * 計算 itemsWidth , 這個與返回的 寬度無關, 與創(chuàng)建布局有關*/if (recalculate) {int pureWidth = width - LABEL_OFFSET - 2 * PADDING;if (pureWidth <= 0) {itemsWidth = labelWidth = 0;}if (labelWidth > 0) {double newWidthItems = (double) itemsWidth * pureWidth / (itemsWidth + labelWidth);itemsWidth = (int) newWidthItems;labelWidth = pureWidth - itemsWidth;} else {itemsWidth = pureWidth + LABEL_OFFSET; // no label}}if (itemsWidth > 0) {//創(chuàng)建布局createLayouts(itemsWidth, labelWidth);}return width;}/*** 創(chuàng)建布局* * @param widthItems* 布局條目寬度* @param widthLabel* label 寬度*/private void createLayouts(int widthItems, int widthLabel) {/** 創(chuàng)建普通條目布局* 如果 普通條目布局 為 null 或者 普通條目布局的寬度 大于 傳入的寬度, 這時需要重新創(chuàng)建布局* 如果 普通條目布局存在, 并且其寬度小于傳入的寬度, 此時需要將*/if (itemsLayout == null || itemsLayout.getWidth() > widthItems) {/** android.text.StaticLayout.StaticLayout(* CharSequence source, TextPaint paint, * int width, Alignment align, * float spacingmult, float spacingadd, boolean includepad)* 傳入?yún)?shù)介紹 : * CharSequence source : 需要分行顯示的字符串* TextPaint paint : 繪制字符串的畫筆* int width : 條目的寬度* Alignment align : Layout 的對齊方式, ALIGN_CENTER 居中對齊, ALIGN_NORMAL 左對齊, Alignment.ALIGN_OPPOSITE 右對齊* float spacingmult : 行間距, 1.5f 代表 1.5 倍字體高度* float spacingadd : 基礎行距上增加多少 , 真實行間距 等于 spacingmult 和 spacingadd 的和* boolean includepad : */itemsLayout = new StaticLayout(buildText(isScrollingPerformed), itemsPaint, widthItems,widthLabel > 0 ? Layout.Alignment.ALIGN_OPPOSITE : Layout.Alignment.ALIGN_CENTER, 1,ADDITIONAL_ITEM_HEIGHT, false);} else {//調(diào)用 Layout 內(nèi)置的方法 increaseWidthTo 將寬度提升到指定的寬度itemsLayout.increaseWidthTo(widthItems);}/** 創(chuàng)建選中條目*/if (!isScrollingPerformed && (valueLayout == null || valueLayout.getWidth() > widthItems)) {String text = getAdapter() != null ? getAdapter().getItem(currentItem) : null;valueLayout = new StaticLayout(text != null ? text : "", valuePaint, widthItems,widthLabel > 0 ? Layout.Alignment.ALIGN_OPPOSITE : Layout.Alignment.ALIGN_CENTER, 1,ADDITIONAL_ITEM_HEIGHT, false);} else if (isScrollingPerformed) {valueLayout = null;} else {valueLayout.increaseWidthTo(widthItems);}/** 創(chuàng)建標簽條目*/if (widthLabel > 0) {if (labelLayout == null || labelLayout.getWidth() > widthLabel) {labelLayout = new StaticLayout(label, valuePaint, widthLabel, Layout.Alignment.ALIGN_NORMAL, 1,ADDITIONAL_ITEM_HEIGHT, false);} else {labelLayout.increaseWidthTo(widthLabel);}}}/** 測量組件大小* (non-Javadoc)* @see android.view.View#onMeasure(int, int)*/@Overrideprotected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {//獲取寬度 和 高度的模式 和 大小int widthMode = MeasureSpec.getMode(widthMeasureSpec);int heightMode = MeasureSpec.getMode(heightMeasureSpec);int widthSize = MeasureSpec.getSize(widthMeasureSpec);int heightSize = MeasureSpec.getSize(heightMeasureSpec);//寬度就是 計算的布局的寬度int width = calculateLayoutWidth(widthSize, widthMode);int height;/** 精準模式* 精準模式下 高度就是精確的高度*/if (heightMode == MeasureSpec.EXACTLY) {height = heightSize;//未定義模式 和 最大模式} else {//未定義模式下 獲取布局需要的高度height = getDesiredHeight(itemsLayout);//最大模式下 獲取 布局高度 和 布局所需高度的最小值if (heightMode == MeasureSpec.AT_MOST) {height = Math.min(height, heightSize);}}//設置組件的寬和高setMeasuredDimension(width, height);}/** 繪制組件* (non-Javadoc)* @see android.view.View#onDraw(android.graphics.Canvas)*/@Overrideprotected void onDraw(Canvas canvas) {super.onDraw(canvas);//如果條目布局為 null, 就創(chuàng)建該布局if (itemsLayout == null) {/** 如果 條目寬度為0, 說明該寬度沒有計算, 先計算, 計算完之后會創(chuàng)建布局* 如果 條目寬度 大于 0, 說明已經(jīng)計算過寬度了, 直接創(chuàng)建布局*/if (itemsWidth == 0) {calculateLayoutWidth(getWidth(), MeasureSpec.EXACTLY);} else {//創(chuàng)建普通條目布局, 選中條目布局, 標簽條目布局createLayouts(itemsWidth, labelWidth);}}//如果條目寬度大于0if (itemsWidth > 0) {canvas.save();// 使用平移方法忽略 填充的空間 和 頂部底部隱藏的一部份條目canvas.translate(PADDING, -ITEM_OFFSET);//繪制普通條目drawItems(canvas);//繪制選中條目drawValue(canvas);canvas.restore();}//在中心位置繪制drawCenterRect(canvas);//繪制陰影drawShadows(canvas);}/*** Draws shadows on top and bottom of control* * @param canvas* the canvas for drawing*/private void drawShadows(Canvas canvas) {topShadow.setBounds(0, 0, getWidth(), getHeight() / visibleItems);topShadow.draw(canvas);bottomShadow.setBounds(0, getHeight() - getHeight() / visibleItems, getWidth(), getHeight());bottomShadow.draw(canvas);}/*** 繪制選中條目* * @param canvas* 畫布*/private void drawValue(Canvas canvas) {valuePaint.setColor(VALUE_TEXT_COLOR);//將當前 View 狀態(tài)屬性值 轉(zhuǎn)為整型集合, 賦值給 普通條目布局的繪制屬性valuePaint.drawableState = getDrawableState();Rect bounds = new Rect();//獲取選中條目布局的邊界itemsLayout.getLineBounds(visibleItems / 2, bounds);// 繪制標簽if (labelLayout != null) {canvas.save();canvas.translate(itemsLayout.getWidth() + LABEL_OFFSET, bounds.top);labelLayout.draw(canvas);canvas.restore();}// 繪制選中條目if (valueLayout != null) {canvas.save();canvas.translate(0, bounds.top + scrollingOffset);valueLayout.draw(canvas);canvas.restore();}}/*** 繪制普通條目* * @param canvas* 畫布*/private void drawItems(Canvas canvas) {canvas.save();//獲取 y 軸 定點高度int top = itemsLayout.getLineTop(1);canvas.translate(0, -top + scrollingOffset);//設置畫筆顏色itemsPaint.setColor(ITEMS_TEXT_COLOR);//將當前 View 狀態(tài)屬性值 轉(zhuǎn)為整型集合, 賦值給 普通條目布局的繪制屬性itemsPaint.drawableState = getDrawableState();//將布局繪制到畫布上itemsLayout.draw(canvas);canvas.restore();}/*** 繪制當前選中條目的背景圖片* * @param canvas* 畫布*/private void drawCenterRect(Canvas canvas) {int center = getHeight() / 2;int offset = getItemHeight() / 2;centerDrawable.setBounds(0, center - offset, getWidth(), center + offset);centerDrawable.draw(canvas);}/** 繼承自 View 的觸摸事件, 當出現(xiàn)觸摸事件的時候, 就會回調(diào)該方法* (non-Javadoc)* @see android.view.View#onTouchEvent(android.view.MotionEvent)*/@Overridepublic boolean onTouchEvent(MotionEvent event) {//獲取適配器WheelAdapter adapter = getAdapter();if (adapter == null) {return true;}/** gestureDetector.onTouchEvent(event) : 分析給定的動作, 如果可用, 調(diào)用 手勢檢測器的 onTouchEvent 方法* -- 參數(shù)解析 : ev , 觸摸事件* -- 返回值 : 如果手勢監(jiān)聽器成功執(zhí)行了該方法, 返回true, 如果執(zhí)行出現(xiàn)意外 返回 false;*/if (!gestureDetector.onTouchEvent(event) && event.getAction() == MotionEvent.ACTION_UP) {justify();}return true;}/*** 滾動 WheelView* * @param delta* 滾動的值*/private void doScroll(int delta) {scrollingOffset += delta;//計算滾動的條目數(shù), 使用滾動的值 處于 單個條目高度, 注意計算整數(shù)值int count = scrollingOffset / getItemHeight();/** pos 是滾動后的目標元素索引* 計算當前位置, 當前條目數(shù) 減去 滾動的條目數(shù)* 注意 滾動條目數(shù)可正 可負*/int pos = currentItem - count;//如果是可循環(huán)的, 并且條目數(shù)大于0if (isCyclic && adapter.getItemsCount() > 0) {//設置循環(huán), 如果位置小于0, 那么該位置就顯示最后一個元素while (pos < 0) {pos += adapter.getItemsCount();}//如果位置正無限大, 模條目數(shù) 取余pos %= adapter.getItemsCount();// (前提 : 不可循環(huán) 條目數(shù)大于0, 可循環(huán) 條目數(shù)小于0, 條目數(shù)小于0, 不可循環(huán)) , 如果滾動在執(zhí)行} else if (isScrollingPerformed) {//位置一旦小于0, 計算的位置就賦值為 0, 條目滾動數(shù)為0if (pos < 0) {count = currentItem;pos = 0;//位置大于條目數(shù)的時候, 當前位置等于(條目數(shù) - 1), 條目滾動數(shù)等于 當前位置 減去 (條目數(shù) - 1)} else if (pos >= adapter.getItemsCount()) {count = currentItem - adapter.getItemsCount() + 1;pos = adapter.getItemsCount() - 1;}} else {// fix positionpos = Math.max(pos, 0);pos = Math.min(pos, adapter.getItemsCount() - 1);}//滾動的高度int offset = scrollingOffset;/** 如果當前位置不是滾動后的目標位置, 就將當前位置設置為目標位置* 否則就重繪組件*/if (pos != currentItem) {setCurrentItem(pos, false);} else {//重繪組件invalidate();}// 將滾動后剩余的小數(shù)部分保存scrollingOffset = offset - count * getItemHeight();if (scrollingOffset > getHeight()) {scrollingOffset = scrollingOffset % getHeight() + getHeight();}}/*** 手勢監(jiān)聽器*/private SimpleOnGestureListener gestureListener = new SimpleOnGestureListener() {//按下操作public boolean onDown(MotionEvent e) {//如果滾動在執(zhí)行if (isScrollingPerformed) {//滾動強制停止, 按下的時候不能繼續(xù)滾動scroller.forceFinished(true);//清理信息clearMessages();return true;}return false;}/** 手勢監(jiān)聽器監(jiān)聽到 滾動操作后回調(diào)* * 參數(shù)解析 : * MotionEvent e1 : 觸發(fā)滾動時第一次按下的事件* MotionEvent e2 : 觸發(fā)當前滾動的移動事件* float distanceX : 自從上一次調(diào)用 該方法 到這一次 x 軸滾動的距離, * 注意不是 e1 到 e2 的距離, e1 到 e2 的距離是從開始滾動到現(xiàn)在的滾動距離* float distanceY : 自從上一次回調(diào)該方法到這一次 y 軸滾動的距離* * 返回值 : 如果事件成功觸發(fā), 執(zhí)行完了方法中的操作, 返回true, 否則返回 false * (non-Javadoc)* @see android.view.GestureDetector.SimpleOnGestureListener#onScroll(android.view.MotionEvent, android.view.MotionEvent, float, float)*/public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {//開始滾動, 并回調(diào)滾動監(jiān)聽器集合中監(jiān)聽器的 開始滾動方法startScrolling();doScroll((int) -distanceY);return true;}/** 當一個急沖手勢發(fā)生后 回調(diào)該方法, 會計算出該手勢在 x 軸 y 軸的速率* * 參數(shù)解析 : * -- MotionEvent e1 : 急沖動作的第一次觸摸事件;* -- MotionEvent e2 : 急沖動作的移動發(fā)生的時候的觸摸事件;* -- float velocityX : x 軸的速率* -- float velocityY : y 軸的速率* * 返回值 : 如果執(zhí)行完畢返回 true, 否則返回false, 這個就是自己定義的* * (non-Javadoc)* @see android.view.GestureDetector.SimpleOnGestureListener#onFling(android.view.MotionEvent, android.view.MotionEvent, float, float)*/public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {//計算上一次的 y 軸位置, 當前的條目高度 加上 剩余的 不夠一行高度的那部分lastScrollY = currentItem * getItemHeight() + scrollingOffset;//如果可以循環(huán)最大值是無限大, 不能循環(huán)就是條目數(shù)的高度值int maxY = isCyclic ? 0x7FFFFFFF : adapter.getItemsCount() * getItemHeight();int minY = isCyclic ? -maxY : 0;/** Scroll 開始根據(jù)一個急沖手勢滾動, 滾動的距離與初速度有關* 參數(shù)介紹 : * -- int startX : 開始時的 X軸位置* -- int startY : 開始時的 y軸位置* -- int velocityX : 急沖手勢的 x 軸的初速度, 單位 px/s* -- int velocityY : 急沖手勢的 y 軸的初速度, 單位 px/s* -- int minX : x 軸滾動的最小值* -- int maxX : x 軸滾動的最大值* -- int minY : y 軸滾動的最小值* -- int maxY : y 軸滾動的最大值*/scroller.fling(0, lastScrollY, 0, (int) -velocityY / 2, 0, 0, minY, maxY);setNextMessage(MESSAGE_SCROLL);return true;}};// Handler 中的 Message 信息/** 滾動信息 */private final int MESSAGE_SCROLL = 0;/** 調(diào)整信息 */private final int MESSAGE_JUSTIFY = 1;/*** 清空之前的 Handler 隊列, 發(fā)送下一個消息到 Handler 中* * @param message* 要發(fā)送的消息*/private void setNextMessage(int message) {//清空 Handler 隊列中的 what 消息clearMessages();//發(fā)送消息到 Handler 中animationHandler.sendEmptyMessage(message);}/*** 清空隊列中的信息*/private void clearMessages() {//刪除 Handler 執(zhí)行隊列中的滾動操作animationHandler.removeMessages(MESSAGE_SCROLL);animationHandler.removeMessages(MESSAGE_JUSTIFY);}/*** 動畫控制器* animation handler* * 可能會造成內(nèi)存泄露 : 添加注解 HandlerLeak* Handler 類應該應該為static類型，否則有可能造成泄露。* 在程序消息隊列中排隊的消息保持了對目標Handler類的應用。* 如果Handler是個內(nèi)部類，那 么它也會保持它所在的外部類的引用。* 為了避免泄露這個外部類，應該將Handler聲明為static嵌套類，并且使用對外部類的弱應用。*/@SuppressLint("HandlerLeak")private Handler animationHandler = new Handler() {public void handleMessage(Message msg) {//回調(diào)該方法獲取當前位置, 如果返回true, 說明動畫還沒有執(zhí)行完畢scroller.computeScrollOffset();//獲取當前 y 位置int currY = scroller.getCurrY();//獲取已經(jīng)滾動了的位置, 使用上一次位置 減去 當前位置int delta = lastScrollY - currY;lastScrollY = currY;if (delta != 0) {//改變值不為 0 , 繼續(xù)滾動doScroll(delta);}/** 如果滾動到了指定的位置, 滾動還沒有停止* 這時需要強制停止*/if (Math.abs(currY - scroller.getFinalY()) < MIN_DELTA_FOR_SCROLLING) {currY = scroller.getFinalY();scroller.forceFinished(true);}/** 如果滾動沒有停止* 再向 Handler 發(fā)送一個停止*/if (!scroller.isFinished()) {animationHandler.sendEmptyMessage(msg.what);} else if (msg.what == MESSAGE_SCROLL) {justify();} else {finishScrolling();}}};/*** 調(diào)整 WheelView*/private void justify() {if (adapter == null) {return;}//上一次的 y 軸的位置為 0lastScrollY = 0;int offset = scrollingOffset;int itemHeight = getItemHeight();/** 當滾動補償 大于 0, 說明還有沒有滾動的部分, needToIncrease 是 當前條目是否小于條目數(shù)* 如果 滾動補償不大于 0, needToIncrease 是當前條目是否大于 0*/boolean needToIncrease = offset > 0 ? currentItem < adapter.getItemsCount() : currentItem > 0;if ((isCyclic || needToIncrease) && Math.abs((float) offset) > (float) itemHeight / 2) {if (offset < 0)offset += itemHeight + MIN_DELTA_FOR_SCROLLING;elseoffset -= itemHeight + MIN_DELTA_FOR_SCROLLING;}if (Math.abs(offset) > MIN_DELTA_FOR_SCROLLING) {scroller.startScroll(0, 0, 0, offset, SCROLLING_DURATION);setNextMessage(MESSAGE_JUSTIFY);} else {finishScrolling();}}/*** WheelView 開始滾動*/private void startScrolling() {//如果沒有滾動, 將滾動狀態(tài) isScrollingPerformed 設為 trueif (!isScrollingPerformed) {isScrollingPerformed = true;//通知監(jiān)聽器開始滾動 回調(diào)所有的 滾動監(jiān)聽集合中 的 開始滾動方法notifyScrollingListenersAboutStart();}}/*** 結束滾動* 設置滾動狀態(tài)為 false, 回調(diào)滾動監(jiān)聽器的停止?jié)L動方法*/void finishScrolling() {if (isScrollingPerformed) {notifyScrollingListenersAboutEnd();isScrollingPerformed = false;}//設置布局無效invalidateLayouts();//重繪布局invalidate();}/*** 滾動 WheelView* * @param itemsToSkip* 滾動的元素個數(shù)* @param time* 每次滾動的間隔*/public void scroll(int itemsToScroll, int time) {//如果有滾動強制停止scroller.forceFinished(true);lastScrollY = scrollingOffset;int offset = itemsToScroll * getItemHeight();/** 給定 一個開始點, 滾動距離, 滾動間隔, 開始滾動* * 參數(shù)解析 : * 1. 開始的 x 軸位置* 2. 開始的 y 軸位置* 3. 要滾動 x 軸距離* 4. 要滾動 y 軸距離* 5. 滾動花費的時間*/scroller.startScroll(0, lastScrollY, 0, offset - lastScrollY, time);setNextMessage(MESSAGE_SCROLL);//設置開始滾動狀態(tài), 并回調(diào)滾動監(jiān)聽器方法startScrolling();}}

7. Activity 主界面?

package cn.org.octopus.wheelview;import android.app.Activity; import android.app.AlertDialog; import android.app.Fragment; import android.content.Context; import android.content.DialogInterface; import android.os.Bundle; import android.view.Gravity; import android.view.LayoutInflater; import android.view.Menu; import android.view.MenuItem; import android.view.View; import android.view.ViewGroup; import android.view.ViewGroup.LayoutParams; import android.widget.Button; import android.widget.LinearLayout; import cn.org.octopus.wheelview.widget.ArrayWheelAdapter; import cn.org.octopus.wheelview.widget.OnWheelChangedListener; import cn.org.octopus.wheelview.widget.OnWheelScrollListener; import cn.org.octopus.wheelview.widget.WheelView;public class MainActivity extends Activity{public static final String TAG = "octopus.activity";private static Button bt_click;public String province[] = new String[] { " 河北省 ", " 山西省 ", " 內(nèi)蒙古 ", " 遼寧省 ", " 吉林省 ", " 黑龍江 ", " 江蘇省 " };public String city[][] = new String[][] {new String[] {" 石家莊 ", "唐山", "秦皇島", "邯鄲", "邢臺", "保定", "張家口", "承德", "滄州", "廊坊", "衡水"},new String[] {"太原", "大同", "陽泉", "長治", "晉城", "朔州", "晉中", "運城", "忻州", "臨汾", "呂梁"},new String[] {"呼和浩特", "包頭", "烏海", "赤峰", "通遼", "鄂爾多斯", "呼倫貝爾", "巴彥淖爾", "烏蘭察布", "興安", "錫林郭勒", "阿拉善"},new String[] {"沈陽", "大連", "鞍山", "撫順", "本溪", "丹東", "錦州", "營口", "阜新", "遼陽", "盤錦", "鐵嶺", "朝陽", "葫蘆島"},new String[] {"長春", "吉林", "四平", "遼源", "通化", "白山", "松原", "白城", "延邊"},new String[] {"哈爾濱", "齊齊哈爾", "雞西", "鶴崗", "雙鴨山", "大慶", "伊春", "佳木斯", "七臺河", "牡丹江", "黑河", "綏化", "大興安嶺"},new String[] {"南京", "無錫", "徐州", "常州", "蘇州", "南通", "連云港", "淮安", "鹽城", "揚州", "鎮(zhèn)江", "泰州", "宿遷"} };@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);if (savedInstanceState == null) {getFragmentManager().beginTransaction().add(R.id.container, new PlaceholderFragment()).commit();}}/** 點擊事件*/public void onClick(View view) {showSelectDialog(this, "選擇地點", province, city);}private void showSelectDialog(Context context, String title, final String[] left, final String[][] right) {//創(chuàng)建對話框AlertDialog dialog = new AlertDialog.Builder(context).create();//為對話框設置標題dialog.setTitle(title);//創(chuàng)建對話框內(nèi)容, 創(chuàng)建一個 LinearLayout LinearLayout llContent = new LinearLayout(context);//將創(chuàng)建的 LinearLayout 設置成橫向的llContent.setOrientation(LinearLayout.HORIZONTAL);//創(chuàng)建 WheelView 組件final WheelView wheelLeft = new WheelView(context);//設置 WheelView 組件最多顯示 5 個元素wheelLeft.setVisibleItems(5);//設置 WheelView 元素是否循環(huán)滾動wheelLeft.setCyclic(false);//設置 WheelView 適配器wheelLeft.setAdapter(new ArrayWheelAdapter<String>(left));//設置右側的 WheelViewfinal WheelView wheelRight = new WheelView(context);//設置右側 WheelView 顯示個數(shù)wheelRight.setVisibleItems(5);//設置右側 WheelView 元素是否循環(huán)滾動wheelRight.setCyclic(true);//設置右側 WheelView 的元素適配器wheelRight.setAdapter(new ArrayWheelAdapter<String>(right[0]));//設置 LinearLayout 的布局參數(shù)LinearLayout.LayoutParams paramsLeft = new LinearLayout.LayoutParams(LayoutParams.WRAP_CONTENT,LayoutParams.WRAP_CONTENT, 4);paramsLeft.gravity = Gravity.LEFT;LinearLayout.LayoutParams paramsRight = new LinearLayout.LayoutParams(LayoutParams.WRAP_CONTENT,LayoutParams.WRAP_CONTENT, 6);paramsRight.gravity = Gravity.RIGHT;//將 WheelView 對象放到左側 LinearLayout 中l(wèi)lContent.addView(wheelLeft, paramsLeft);//將 WheelView 對象放到 右側 LinearLayout 中l(wèi)lContent.addView(wheelRight, paramsRight);//為左側的 WheelView 設置條目改變監(jiān)聽器wheelLeft.addChangingListener(new OnWheelChangedListener() {@Overridepublic void onChanged(WheelView wheel, int oldValue, int newValue) {//設置右側的 WheelView 的適配器wheelRight.setAdapter(new ArrayWheelAdapter<String>(right[newValue]));wheelRight.setCurrentItem(right[newValue].length / 2);}});wheelLeft.addScrollingListener(new OnWheelScrollListener() {@Overridepublic void onScrollingStarted(WheelView wheel) {// TODO Auto-generated method stub}@Overridepublic void onScrollingFinished(WheelView wheel) {// TODO Auto-generated method stub}});//設置對話框點擊事件 積極dialog.setButton(AlertDialog.BUTTON_POSITIVE, "確定", new DialogInterface.OnClickListener() {@Overridepublic void onClick(DialogInterface dialog, int which) {int leftPosition = wheelLeft.getCurrentItem();String vLeft = left[leftPosition];String vRight = right[leftPosition][wheelRight.getCurrentItem()];bt_click.setText(vLeft + "-" + vRight);dialog.dismiss();}});//設置對話框點擊事件 消極dialog.setButton(AlertDialog.BUTTON_NEGATIVE, "取消", new DialogInterface.OnClickListener() {@Overridepublic void onClick(DialogInterface dialog, int which) {dialog.dismiss();}});//將 LinearLayout 設置到 對話框中dialog.setView(llContent);//顯示對話框if (!dialog.isShowing()) {dialog.show();}}@Overridepublic 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;}@Overridepublic boolean onOptionsItemSelected(MenuItem item) {// Handle action bar item clicks here. The action bar will// automatically handle clicks on the Home/Up button, so long// as you specify a parent activity in AndroidManifest.xml.int id = item.getItemId();if (id == R.id.action_settings) {return true;}return super.onOptionsItemSelected(item);}/*** A placeholder fragment containing a simple view.*/public static class PlaceholderFragment extends Fragment {public PlaceholderFragment() {}@Overridepublic View onCreateView(LayoutInflater inflater, ViewGroup container,Bundle savedInstanceState) {View rootView = inflater.inflate(R.layout.fragment_main, container,false);bt_click = (Button)rootView.findViewById(R.id.bt_click);return rootView;}}}

博客地址?:?http://blog.csdn.net/shulianghan/article/details/41520569#t17

代碼下載?:?

--?GitHub?:?https://github.com/han1202012/WheelViewDemo.git?

--?CSDN?:?http://download.csdn.net/detail/han1202012/8208997?;

代碼下載?:?

--?GitHub?:?https://github.com/han1202012/WheelViewDemo.git?

--?CSDN?:?http://download.csdn.net/detail/han1202012/8208997?;

博客地址?:?http://blog.csdn.net/shulianghan/article/details/41520569#t17

代碼下載?:?

--?GitHub?:?https://github.com/han1202012/WheelViewDemo.git?

--?CSDN?:?http://download.csdn.net/detail/han1202012/8208997?;

博客地址?:?http://blog.csdn.net/shulianghan/article/details/41520569#t17

代碼下載?:?

--?GitHub?:?https://github.com/han1202012/WheelViewDemo.git?

--?CSDN?:?http://download.csdn.net/detail/han1202012/8208997?;

總結

以上是生活随笔為你收集整理的【Android 应用开发】 自定义组件 宽高适配方法, 手势监听器操作组件, 回调接口维护策略, 绘制方法分析 -- 基于 WheelView 组件分析自定义组件的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。