Android 中文 API （34） —— RadioGroup

前言

　　本章內容是android.widget.RadioGroup，翻譯來自"首當其衝"，再次感謝"首當其衝" ！歡迎你一塊兒參與Android API 的中文翻譯，聯繫我over140@gmail.com。
 

 

聲明

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

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

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

 

正文

　　1、結構

　　　　public class RadioGroup extends LinearLayout

 
 

java.lang.Object

　　android.view.View

      　　android.view.ViewGroup

            　　android.widget.LinearLayout

                  　　android.widget.RadioGroup

 

　　2、概述

　　　　
 

　　這個類用於建立一組按鈕之間相互排斥的單選按鈕組，在同一個單選按鈕組中勾選一個按鈕則會取消該組中其它已經勾選的按鈕的選中狀態。

　　　　初始狀態下，全部的單選按鈕都未勾選，雖然不能取消一個特定的單選按鈕的勾選狀態，但能夠經過單選按鈕組去消除它的勾選狀態，根據XML佈局文件中的單選按鈕的惟一ID去標識指定的選擇信息。

 

　　3、內部類
 

　　　　Class              RadioGroup.LayoutParams    

　　　　當WRAP_CONTENT（包裹內容）的子組件在XML文件中沒有指定相應的寬度和高度的話，可使用的佈局參數默認設置的默認設置

 

　　　　Interface         RadioGroup.OnCheckedChangeListener

　　　　當單選按鈕組中的單選按鈕的勾選狀態發生改變時，所要調用的回調函數的接口類

 

　　4、公共方法
 

public void addView (View child, int index, ViewGroup.LayoutParams params)

      使用指定的佈局參數添加一個子視圖

參數

                 child         所要添加的子視圖

index         將要添加子視圖的位置

params    所要添加的子視圖的佈局參數

                           

public void check (int id) 

        若是傳遞-1做爲指定的選擇標識符來清除單選按鈕組的勾選狀態，至關於調用clearCheck()操做

  參數

              　　id     該組中所要勾選的單選按鈕的惟一標識符（id）

              參見

              　　getCheckedRadioButtonId()

              　　clearCheck()

 

public void clearCheck () 

清除當前的選擇狀態，當選擇狀態被清除，則單選按鈕組裏面的全部單選按鈕將取消勾選狀態，getCheckedRadioButtonId()將返回null

              參見

              　　check(int)

              　　getCheckedRadioButtonId()

 

public RadioGroup.LayoutParams generateLayoutParams (AttributeSet attrs)   

基於提供的屬性集合返回一個新的佈局參數集合

參數

           　　attrs                   用於生成佈局參數的屬性

           返回值

           　　返回一個ViewGroup.LayoutParams或其子類的實例

 

public int getCheckedRadioButtonId ()  

返回該單選按鈕組中所選擇的單選按鈕的標識ID，若是沒有勾選則返回-1

              返回值

              　　返回該單選按鈕組中所選擇的單選按鈕的標識ID

              參見

              　　check(int)

   clearCheck()

 

public void setOnCheckedChangeListener (RadioGroup.OnCheckedChangeListener listener)

註冊一個當該單選按鈕組中的單選按鈕勾選狀態發生改變時所要調用的回調函數

參數

           　　listener    當單選按鈕勾選狀態發生改變時所要調用的回調函數

                           

public void setOnHierarchyChangeListener (ViewGroup.OnHierarchyChangeListener listener)

註冊一個當子內容添加到該視圖或者從該視圖中移除時所要調用的回調函數

參數

                            listener    當層次結構發生改變時所要調用的回調函數

 

　　5、受保護方法
 

protected LinearLayout.LayoutParams generateDefaultLayoutParams ()

當佈局爲垂直方向時，將返回一個寬度爲「填充父元素」(MATCH_PARENT)，高度爲「包裹內容」的佈局參數集合，若是爲水平方向時，將返回寬度爲「包裹內容」，高度爲「填充父元素」的佈局參數集合

(match_parent即爲fill_parent,public static final int FILL_PARENT/MATCH_PARENT = -1 )

      　　返回值

返回一個默認的佈局參數集合

 

protected void onFinishInflate ()

當視圖從XML中加載，且相應的子視圖被添加以後，調用該方法，

即便子類重寫了該方法，應該確保去調用父類的方法（一般放在方法在第一句），這樣才能完成相應的調用參數

     　　返回值

返回一個默認的佈局參數集合

 

　　6、補充
 

　　文章連接

　　Android基礎教程(七)之----單選項框RadioGroup的綜合應用

　　Android UI設計 RadioGroup單選按鈕用法

　　Android 小項目之--猜名字有獎！RadionButton 和RadionGroup應用（附源碼）

　　　　示例代碼