Android API 中文（13） —— ToggleButton

版本

　　Android 2.2 r1
 

 

正文

　　一、結構
 

 

　　　　public class ToggleButton extends CompoundButton

 

　　　　java.lang.Object

   　　　　↳        android.view.View

         　　　　↳        android.widget.TextView

                　　　　↳        android.widget.Button

                       　　　　↳        android.widget.CompoundButton

                              　　　　↳        android.widget.ToggleButton

 

 

　　二、 類概述
 

　　　　

　　　　通過一個帶有亮度指示同時默認文本為“ON”或“OFF”的按鈕顯示選中/未選中狀態。

 

　　三、XML屬性

屬性名稱

描述

android:disabledAlpha

設置按鈕在禁用時透明度。

 

 

android:textOff

未選中時按鈕的文本

android:textOn

選中時按鈕的文本

 

　　四、公共方法

 

         public CharSequence getTextOff ()

         返回按鈕未選中時的文本。

                   返回值

                            文本

 

         public CharSequence getTextOn ()

         返回按鈕選中時的文本。

                   返回值

                            文本

 

         public void setBackgroundDrawable (Drawable d)

         設置指定的可繪制（譯者注：如圖片）為背景，或刪除背景。如果讓背景有邊距，這個視圖的邊距就是背景的邊距。然而，當背景被刪除時，這個視圖的邊距不能被觸摸。如果需要設置邊距，請使用方法setPadding(int, int, int, int)。

（譯者注：如果設置刪除背景整個就不顯示了，此外設置背景後選中和被選中的圖片也不顯示了，如下圖： ，實現代碼：

 

）

                   參數

                            d      設置可繪制（譯者注：如圖片）為背景，或設置為空刪除背景。

 

         public void setChecked (boolean checked)

         改變按鈕的選中狀態。

                   參數

                            checked true讓按鈕選中，false讓按鈕不選中

 

         public void setTextOff (CharSequence textOff)

         設置按鈕未選中時顯示的文本。

                   參數

                            textOff    文本

 

         public void setTextOn (CharSequence textOn)

         設置按鈕選中時顯示的文本。

                   參數

                            textOn    文本

 

 

　　五、受保護方法

 

         protected void drawableStateChanged ()

         在視圖狀態的變化影響到所顯示可繪制的狀態時調用這個方法。

         確保在覆蓋時中調用父類方法（譯者注：super. drawableStateChanged ()）。

 

         protected void onFinishInflate ()

         XML文件加載視圖完成時調用。這個函數在加載的最後階段被調用，所有的子視圖已經被添加。

         即使子類重寫了onFinishInflate方法，也應該始終確保調用父類方法（譯者注：super. onFinishInflate()），使系統能夠調用。 

 

轉自：http://www.cnblogs.com/over140/archive/2010/10/11/1847597.html