Android 中文 API （25） —— ZoomControls

正文

　　一、結構

　　　　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一直顯示

 

　　　　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　　代碼下載

　　　　　　　　demo_ZoomControls.rar

 

結束
 

　　 感謝jiahuibin辛勤的翻譯並提供完整的截圖和示例代碼，歡迎大家提供ZoomControls更多用法的線索:)
 

轉自：http://www.cnblogs.com/over140/archive/2010/11/03/1867716.html