Android 中文 API （34） —— RadioGroup

正文

　　一、結構

　　　　public class RadioGroup extends LinearLayout

 
 

java.lang.Object

　　android.view.View

      　　android.view.ViewGroup

            　　android.widget.LinearLayout

                  　　android.widget.RadioGroup

 

　　二、概述

　　　　
 

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

　　　　初始狀態下，所有的單選按鈕都未勾選，雖然不能取消一個特定的單選按鈕的勾選狀態，但可以通過單選按鈕組去消除它的勾選狀態，根據XML布局文件中的單選按鈕的唯一ID去標識指定的選擇信息。

 

　　三、內部類
 

　　　　Class              RadioGroup.LayoutParams    

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

 

　　　　Interface         RadioGroup.OnCheckedChangeListener

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

 

　　四、公共方法
 

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    當層次結構發生改變時所要調用的回調函數

 

　　五、受保護方法
 

protected LinearLayout.LayoutParams generateDefaultLayoutParams ()

當布局為垂直方向時，將返回一個寬度為“填充父元素”(MATCH_PARENT)，高度為“包裹內容”的布局參數集合，如果為水平方向時，將返回寬度為“包裹內容”，高度為“填充父元素”的布局參數集合

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

      　　返回值

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

 

protected void onFinishInflate ()

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

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

     　　返回值

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

 

　　六、補充
 

　　文章鏈接

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

　　Android UI設計 RadioGroup單選按鈕用法

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

　　　　示例代碼

　　　　　　

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