Android 中文 API （34） —— RadioGroup

 

前言

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

 

聲明

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

　　　　部落格園：http://www.cnblogs.com/

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

 

本文

　　一、結構

　　　　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應用（附源碼）

　　　　範例程式碼