Android 中文 API （18） —— AbsSeekBar

前言

　　本章内容是android.widget.AbsSeekBar，翻译来自madgoat ，欢迎你们访问他的博客：http://madgoat.cn/，再次感谢 madgoat ！期待你一块儿参与Android API 的中文翻译，联系我over140@gmail.com。
 

 

声明

　　欢迎转载，但请保留文章原始出处:)
 

　　　　madgoat：http://madgoat.cn/

　　　　农民伯伯：http://over140.blog.51cto.com/

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

 

版本

　　Android 2.2 r1  
 

 

正文

　　1、结构
 

　　public abstract class AbsSeekBar extends ProgressBar
 

 

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

 

　　2、类概述

　　　　　　

　　　　此类为抽象类。供拖动条SeekBar和评分条RatingBar继承。

 

　　3、 公共方法
 

　　　　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)时：

 

　　　　　　　　　　

 

　　4、 受保护方法
 

　　　　protected boolean verifyDrawable (Drawable who)

　　若是你的视图子类显示他本身的可视化对象，他将要重写此方法而且为了显示可绘制返回true。此操做容许进行绘制时有动画效果。

　　确认当重写从方法时，需调用父类相应方法。（注：即记得调用super.verifyDrawable(who)）

　　参数

　　who           需判断的可绘制对象（Drawable）。若是是你要显示的对象，返回True，不然返回调用父类的结果。         

　　返回值

　　　　　　　　若是可绘制对象（Drawable）已经在视图中显示，返回True不然返回false。而且此处不容许使用动画。　　　　

 

　　5、 下载
 

　　　　5.1　　PDF下载

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

　　　　5.2　　小图标下载

　　　　　　

 

结束
 

　　madgoat两天时间翻了三篇，如今已经又领了四篇，他告诉我他如今是边学边翻，这也是我鼓励新入门的朋友积极加入的缘由，由于这不单单是翻译，再次感谢他的分享  :)