Android 中文 API （25） —— ZoomControls

前言

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

 

声明

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

　　　　博客园：http://www.cnblogs.com/

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

 

正文

　　一、结构

　　　　public class ZoomControls extends LinearLayout

 

           java.lang.Object

                  android.view.View

                        android.view.ViewGroup

                                     android.widget.LinearLayout

                                              android.widget.ZoomControls

 

　　二、概述

　　　　

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

 

　　三、 公共方法

         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.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更多用法的线索:)