Android 中文 API （29） —— CompoundButton

前言

　　本章內容是android.widget.CompoundButton，翻譯來自德羅德，再次感謝德羅德 ！期待你一塊兒參與Android API 的中文翻譯，聯繫我over140@gmail.com。
 

 

聲明

　　歡迎轉載，但請保留文章原始出處:)
 

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

　　　　Android中文翻譯組：http://www.cnblogs.com/over140/  

 

正文

　　1、結構

　　　　public abstract class CompoundButton extends Button implements Checkable

 

　　　　java.lang.Object
　　　　　　android.view.View
　　　　　　　　android.widget.TextView
　　　　　　　　　　android.widget.Button
　　　　　　　　　　　　android.widget.CompoundButton
 

 

　　2、概述

　　　　一個帶有選中/未選中狀態的按鈕。當按鈕按下或點中時自動改變狀態。

 

　　3、公共方法

 

         public boolean dispatchPopulateAccessibilityEvent (AccessibilityEvent event)

         在子視圖的構建時分派一個輔助事件。（譯者注：經過源碼能夠看出，視圖構建時設置其選中狀態。）

                   參數

                            event       事件

                   返回值

                            若是事件所有完成返回True。

 

         public boolean isChecked ()

         （譯者注：是否選中）

 

         public void onRestoreInstanceState (Parcelable state)

         容許視圖從新應用之前經過onSaveInstanceState()生成表明內部的狀態。這個函數決不調用一個空的狀態。

                   參數

                            state       返回之前調用onSaveInstanceState()保存下來的狀態。

 

         public Parcelable onSaveInstanceState ()

         容許視圖生成一個表明內部的狀態，之後可用於建立一個與之相同的新的實例。這種狀態應該只包含非持久或之後不可以重建的信息。例如，你決不存儲你當前在屏幕上的位置，由於這會在視圖的層面上從新計算放置一個新的實例。

         你能夠存儲到這裏的一些例子：一個文本框中當前光標的位置（但一般不是文字自己，文字一般保存在內容提供者(content provider)或其餘持久的儲存中），一個列表視圖中的當前選中項。

                   返回值

                            返回一個包含視圖當前狀態的Parcelable對象，或沒有什麼狀態保存時返回null。默認實現返回null。

 

         public boolean performClick ()

         若是視圖定義了OnClickListener監聽器，調用此方法來執行。

                   返回值

                            定義了的OnClickListener被調用返回True，不然返回False

 

         public void setButtonDrawable (Drawable d)

         給按鈕背景設置一個可繪製對象（如：圖像）

                   參數

                            d      用做背景的可繪製對象（如：圖像）

 

         public void setButtonDrawable (int resid)

         經過資源Id給按鈕背景設置一個圖像

                   參數

                            resid        做爲背景圖像的資源id

 

         public void setChecked (boolean checked)

         改變按鈕的選中狀態

                  參數

                            checked true選中，false非選中

 

         public void setOnCheckedChangeListener (CompoundButton.OnCheckedChangeListener listener)

         註冊一個在按鈕狀態發生改變時執行的回調函數

                   參數

                            listener  當選中狀態改變時調用的函數

 

         public void toggle ()

         改變選中狀態爲當前狀態的逆狀態

 

　　4、受保護方法

 

         protected void drawableStateChanged ()

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

確保在重載時中調用父類方法

 

         protected int[] onCreateDrawableState (int extraSpace)

         爲當前視圖生成新的可繪圖區狀態。這個方式當緩存的圖像繪圖區狀態肯定失效時經過視圖系統調用。你可使用getDrawableState()方法從新取得當前的狀態。

                   參數

                            extraSpace      若是爲非零，這是你應該返回的數組在你能夠存放你的狀態的額外條目的數量。

                   返回值

                            返回一個記錄着視圖中當前繪圖區狀態的數組

 

         protected void onDraw (Canvas canvas)

         實現你本身的繪製。

                   參數

                            canvas    在畫布上繪製背景

 

         protected boolean verifyDrawable (Drawable who)

         若是你的視圖子類顯示他本身的可視化對象，他將要重寫此方法而且爲了顯示可繪製返回true。此操做容許進行繪製時有動畫效果。

　　確認當重寫從方法時，需調用父類相應方法。

                   參數

                            who         需判斷的可繪製對象（Drawable）。若是是你要顯示的對象，返回True，不然返回調用父類的結果。

                   返回值

                            boolean 若是可繪製對象（Drawable）已經在視圖中顯示，返回True不然返回false。而且此處不容許使用動畫。 

 

結束
 

　　Android2.3即將發佈，翻譯組也將迅速跟進，已經翻譯或正在翻譯的將保持原有版本，新開始翻譯的將直接重新版本開始。