Android2.2 API 中文文档系列(9) —— ZoomButton
前言
本章翻译的是android.widget.ZoomButton,译为缩放按钮,实际意义不大,搜遍GOOGLE也找不到几个应用的例子,但是为了整个API文档的完整性,这里还是贴了出来。欢迎更多译者一起参与Android API 的中文翻译行动!我的邮箱over140@gmail.com。
声明
欢迎转载,但请保留文章原始出处:)
博客园:http://www.cnblogs.com
农民伯伯: http://www.cnblogs.com/over140/
正文
一、类结构
java.lang.Object
android.widget.ZoomButton
public class ZoomButton extends ImageButton implements View.OnLongClickListener
二、概述
缩放按钮,实际上是很普通的两个按钮,可以简单的理解为一个ImageButton加上一张缩放的图标。如下代码:
三、公共方法
public boolean dispatchUnhandledMove (View focused, int direction)
对于获得焦点的View,这个方法是捕获箭头事件最后的机会。这就是在获取焦点的View没有在内部处理、系统在要求的方向也不能找到一个新的View让其获得焦点时调用。
参数
focused 当前焦点View
direction焦点移动的方向。其中之一:FOCUS_UP, FOCUS_DOWN, FOCUS_LEFT和 FOCUS_RIGHT.
返回值
如果为true,将清除这个View未处理的事件。
(注:从源码中可看出ZoomButton覆盖了父类的该方法,在super之前调用了一下clearFocus,如下代码:
public boolean onKeyUp (int keyCode, KeyEvent event)
默认实现至KeyEvent.Callback.onKeyMultiple() :当点击执行时KEYCODE_DPAD_CENTER 或 KEYCODE_ENTER被释放。
参数
keyCode 按下按钮代表的键值,属于KeyEvent (注:KeyEvent的静态属性)。
event 该KeyEvent对象,定义按钮动作
返回值
如果您处理这一事件中,返回true。如果你想允许事件被下一个接收器处理,返回false。
public boolean onLongClick (View v)
当一个View被长按时调用。
参数
v 被长按的View。
返回值
如果返回true,这个回调在长按时被执行了,反之返回false.
public boolean onTouchEvent (MotionEvent event)
实现这个方法处理触摸屏移动事件。
参数
event 该移动事件.
返回值
如果是true,该事件是触摸,反之返回false。
public void setEnabled (boolean enabled)
设置这个View启用状态。
参数
enabled 设置true表示启用,反之表示禁用。
public void setZoomSpeed (long speed)
(注:单独使用无实际意义,可以用来存放临时数据)
四、下载
代码:/Files/over140/2010/9/magnify.rar
PDF:http://download.csdn.net/source/2727796
五、系列
Android2.2 API 中文文档系列(1) —— TextView
Android2.2 API 中文文档系列(2) —— EditText
Android2.2 API 中文文档系列(3) —— AccessibilityService
Android2.2 API 中文文档系列(4) —— Manifest
Android2.2 API 中文文档系列(5) —— View
Android2.2 API 中文文档系列(6) —— ImageView
Android2.2 API 中文文档系列(7) —— ImageButton
Android2.2 API 中文文档系列(8) —— QuickContactBadge
结束
感谢石头协助本章翻译,此外昨天和今天分别有两位译者加入,加我总共现在有5人在参加Android API 的翻译工作,由于是自由供稿,且只有我这边强迫自己每周一篇,翻译速度有限,再次呼吁更多朋友一起参与!!无论你的英语水平如何,哪怕是借助翻译工具,只要用心翻译,起码自己看得懂、并贴心的附上图片和代码,就能够帮得上大家,那么这样的文章和翻译稿就有价值,诚挚的期待你的加入!