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.view.View

        android.widget.ImageView

                    android.widget.ImageButton

             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 的翻译工作,由于是自由供稿,且只有我这边强迫自己每周一篇,翻译速度有限,再次呼吁更多朋友一起参与!!无论你的英语水平如何,哪怕是借助翻译工具,只要用心翻译,起码自己看得懂、并贴心的附上图片和代码,就能够帮得上大家,那么这样的文章和翻译稿就有价值,诚挚的期待你的加入!

posted @ 2010-09-30 10:40  农民伯伯  阅读(6157)  评论(0编辑  收藏  举报