Android 中文 API （25） —— ZoomControls

前言

　　本章内容是android.widget.ZoomControls，译为缩放控件，翻译来自jiahuibin，再次感谢jiahuibin ！期待你一块儿参与Android API 的中文翻译，联系我over140@gmail.com。
 

 

声明

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

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

　　　　Android中文翻译组：http://www.cnblogs.com/over140/  

 

正文

　　1、结构

　　　　public class ZoomControls extends LinearLayout

 

 

           java.lang.Object

                  android.view.View

                        android.view.ViewGroup

                                     android.widget.LinearLayout

                                              android.widget.ZoomControls

 

　　2、概述

　　　　

　　　　ZoomControls显示一个简单的设置来控制缩放并回调已注册的事件。

 

　　3、 公共方法
 

 

         public boolean hasFocus ()

         若是这个视图得到了焦点就返回真。

         　　返回值

               　　若是这个视图得到了焦点就返回真。

 

         public void hide ()

         这个方法能够将zoomControl视图隐藏起来，不显示。

 

         public boolean onTouchEvent (MotionEvent event)

    　  这个方法处理触摸屏移动事件。

              　　参数

                     　　event该移动事件.

              　　返回值

                     　　若是是true，该事件是触摸，反之返回false。

 

         public void setIsZoomInEnabled (boolean isEnabled)

         这个方法能够设置放大按钮是否可用。

　　　　　　参数

                    　　　　isEnabled 若是是true，放大按钮可用，反之不可用（按钮变成灰色）。

 

         public void setIsZoomOutEnabled (boolean isEnabled)

         这个方法能够设置缩小按钮是否可用。

       　　参数

                    isEnabled  若是是true缩小按钮可用，反之不可用（按钮变成灰色）。

 

         public void setOnZoomInClickListener (View.OnClickListener listener)

         注册放大监听器

                  参数

Listener 点击放大按钮事件触发的事件。（译者注：为OnClickListener的实例，能够复写onClick方法，里面为具体的响应动做。我感受这个方法还有下面的方法是本类的重点，咱们能够在里面实现相应的动做，来响应咱们的事件。）

 

         public void setOnZoomOutClickListener (View.OnClickListener listener)

         注册缩小监听器

         　　参数

　　Listener点击缩小按钮事件触发的事件。（译者注：为OnClickListener的实例，能够复写onClick方法，里面为具体的响应动做。）

 

         public void setZoomSpeed (long speed)

　设置缩放速度。

         　　参数

              　　Speed 缩放速度

 

         public void show ()  

         　 这个方法和hide方法对应，用来显示ZoomControl。 

 

　　4、 补充
 

　　　　4.1　　文章连接

　　　　　　[荐]Android控件之ZoomControls缩放控件

　　　　　　地图时让ZoomContrls一直显示

　　　　　　[荐]ZoomControls在Google Map中的使用

 

　　　　4.2　　示例代码（译者声明：这个代码部分思路来源于网络上一个博客，谨以此来解释，特此声明。）

　　　　　　4.2.1　　java文件

public   class  ZoomCotroltest  extends  Activity { 

        @Override 
         protected   void  onCreate(Bundle savedInstanceState) {
                 super .onCreate(savedInstanceState); 
                 this .setContentView(R.layout.main); 

                setTitle( " ZoomControls " ); 

                ZoomControls zoomControls  =  (ZoomControls)  this .findViewById(R.id.zoomControls);
                zoomControls.hide();
                zoomControls.show();
                 //  setOnZoomInClickListener() - 响应单击放大按钮的事件 
                zoomControls.setIsZoomInEnabled( true );
                zoomControls.setIsZoomOutEnabled( true );
                zoomControls.setOnZoomInClickListener( new  OnClickListener() { 
                         public   void  onClick(View v) { 
                                Toast.makeText(ZoomCotroltest. this ,  " 单击了放大按钮 " , Toast.LENGTH_SHORT).show(); 
                        } 
                }); 
                 
                 //  setOnZoomOutClickListener() - 响应单击缩小按钮的事件 
                zoomControls.setOnZoomOutClickListener( new  OnClickListener() { 
                         public   void  onClick(View v) { 
                                Toast.makeText(ZoomCotroltest. this ,  " 单击了缩小按钮 " , Toast.LENGTH_SHORT).show();         
                        } 
                }); 

        } 
}

　　　　　　4.2.2　　xml文件

<? xml version="1.0" encoding="utf-8" ?>  
< LinearLayout  xmlns:android ="http://schemas.android.com/apk/res/android"  
        android:orientation ="vertical"  android:layout_width ="fill_parent"  
        android:layout_height ="fill_parent" >  
         <!--  
                放大/缩小按钮控件 
         -->  
         < ZoomControls  android:id ="@+id/zoomControls"  
                android:layout_width ="wrap_content"  
                android:layout_height ="wrap_content" >
         </ ZoomControls >  
</ LinearLayout >

　　　　　　4.2.3　　代码下载

　　　　　　　　/Files/over140/2010/10/demo_ZoomControls.rar

 

结束
 

　　 感谢jiahuibin辛勤的翻译并提供完整的截图和示例代码，欢迎你们提供ZoomControls更多用法的线索:)