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