Android 中文 API （18） —— AbsSeekBar

前言

　　本章內容是android.widget.AbsSeekBar，翻譯來自madgoat ，歡迎大家訪問他的部落格：http://madgoat.cn/，再次感謝 madgoat ！期待你一起參與Android API 的中文翻譯，聯絡我over140@gmail.com。

 

聲明

　　歡迎轉載，但請保留文章原始出處:)

　　　　madgoat：http://madgoat.cn/

　　　　部落格園：http://www.cnblogs.com

　　　　農民伯伯： http://www.cnblogs.com/over140/

 

版本

　　Android 2.2 r1  

 

本文

　　一、結構

　　public abstract class AbsSeekBar extends ProgressBar

 

　　java.lang.Object
　　　　android.view.View
　　　　　　android.widget.ProgressBar
　　　　　　　　android.widget.AbsSeekBar

 

　　二、類概述

　　　　　　

　　　　此類為抽象類別。供拖動條SeekBar和評分條RatingBar繼承。

 

　　三、 公用方法

　　　　public int getKeyProgressIncrement ()

　　返回方向鍵改變後的進度值

　　預設情況下此值是根據最大值而得出的。

　　傳回值

　　　　　　當使用者按下方向鍵後減少或增加之後的進度值。這個進度值是正數。

 

　　　　public int getThumbOffset ()

　　參見

　　setThumbOffset(int)

 

　　　　public boolean onKeyDown (int keyCode, KeyEvent event)

　　　　預設實現KeyEvent.Callback.onKeyMultiple():如果視圖已啟用並且可點擊，當KEYCODE_DPAD_CENTER或者KEYCODE_ENTER被釋放時，執行按下（Down）此視圖的操作。

參數

keyCode   KeyEvent中用於表示按鍵被按下的識別碼

event        按鍵動作中定義的KeyEvent對象

傳回值

假如你已經處理了當前事件，返回true。假如你想繼續讓下一個事件接收者（receiver）處理，則返回false；

 

　　public boolean onTouchEvent (MotionEvent event)

　　　　實現這個方法來處理觸控螢幕幕引發的事件。

　　參數

　　event        動作事件

　　傳回值

　　如果事件已經處理返回True，否則返回false。

 

　　public void setKeyProgressIncrement (int increment)

　　　　設定使用方向鍵更改進度時每次的增加值（註：設定此值後，使用按鍵修改進度值時，每次增加或減少increment大小的幅度）

　　參數

　　increment       The amount to increment or decrement when the user presses the arrow keys.

　　increment         當使用者按下指示鍵時增加或減少的值

 

　　　　public synchronized void setMax (int max)

　　設定進度條的範圍，從0到max

　　參數

　　max           進度條的最大值

 

　　public void setThumb (Drawable thumb)

　　設定可繪製對象thumb為SeekBar中顯示的進度表的結束位置的圖案（註：例如）

 　　　　

　　如果thumb是一個有效可繪製對象（例如不是null值），那麼需要設定thumb的位移量為他的一半寬度（參見setThumbOffset(int)）

　　參數

　　thumb   可繪製對象

 

　　　　public void setThumbOffset (int thumbOffset)

　　設定thumb的位移量允許thumb擴充超出軌道的範圍

　　參數

　　thumbOffset    以像素為單位的位移量

                                     （註：例如，兩圖同樣取SeekBar的最大值）

　　預設Offset為thumb的一半時：

　　　　　　　　　　

　　setThumbOffset(0)時：

　　　　　　　　　　

 

　　四、 受保護方法

　　　　protected boolean verifyDrawable (Drawable who)

　　如果你的視圖子類顯示他自己的可視化對象，他將要重寫此方法並且為了顯示可繪製返回true。此操作允許進行繪製時有動畫效果。

　　確認當重寫從方法時，需調用父類相應方法。（註：即記得調用super.verifyDrawable(who)）

　　參數

　　who           需判斷的可繪製對象（Drawable）。如果是你要顯示的對象，返回True，否則返回調用父類的結果。         

　　傳回值

　　　　　　　　如果可繪製對象（Drawable）已經在視圖中顯示，返回True否則返回false。並且此處不允許使用動畫。　　　　

 

　　五、 下載

　　　　5.1　　PDF下載

　　　　　　CSDN：http://download.csdn.net/source/2781801

　　　　5.2　　小表徵圖下載

　　　　　　

 

結束

　　madgoat兩天時間翻了三篇，現在已經又領了四篇，他告訴我他現在是邊學邊翻，這也是我鼓勵新入門的朋友積極加入的原因，因為這不僅僅是翻譯，再次感謝他的分享