パッケージmx.controls
public class RadioButtonGroup
継承RadioButtonGroup Inheritance EventDispatcher Inheritance Object
実装IMXMLObject

RadioButtonGroup コントロールは、1 つの相互排他的コントロールとして機能する RadioButton コントロールのグループを定義します。RadioButton コントロールは一度に 1 つしか選択できません。<mx:RadioButtonGroup> タグを使用してグループの名前を定義するには、id プロパティが必要です。

MXML シンタックスexpandedMXML シンタックスの非表示

<mx:RadioButtonGroup> タグはそのスーパークラスのすべてのタグ属性を継承し、次のタグ属性を追加します。

 <mx:RadioButtonGroup プロパティ enabled="true|false" id="デフォルト値なし" labelPlacement="right|left|top|bottom"
  
イベント change="デフォルト値なし" itemClick="デフォルト値なし" /> 

例の表示

関連項目

mx.controls.RadioButton
RadioButton コントロール


パブリックプロパティ
 プロパティ定義
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  enabled : Boolean
選択が可能かどうかを判別します。
RadioButtonGroup
  labelPlacement : String
グループ内の各コントロールの RadioButton アイコンを基準にした RadioButton ラベルの位置です。
RadioButtonGroup
  numRadioButtons : int
[read-only] この RadioButtonGroup に属する RadioButton の数です。
RadioButtonGroup
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  selectedValue : Object
null (デフォルト値) 以外の値が設定されている場合、グループから選択された RadioButton コントロールの value プロパティの値です。
RadioButtonGroup
  selection : RadioButton
グループ内で現在選択されている RadioButton コントロールへの参照を格納します。
RadioButtonGroup
パブリックメソッド
 メソッド定義
  RadioButtonGroup(document:IFlexDisplayObject = null)
コンストラクタ。
RadioButtonGroup
 InheritedaddEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 InheriteddispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
EventDispatcher
  getRadioButtonAt(index:int):RadioButton
指定されたインデックス位置にある RadioButton コントロールを返します。
RadioButtonGroup
 InheritedhasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 InheritedhasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
  initialized(document:Object, id:String):void
遅延インスタンス化をサポートする IMXMLObject.initialized() メソッドの実装です。
RadioButtonGroup
 InheritedisPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 InheritedpropertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙可能かどうかを示します。
Object
 InheritedremoveEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 InheritedsetPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 InheritedtoString():String
指定されたオブジェクトのストリング表現を返します。
Object
 InheritedvalueOf():Object
指定されたオブジェクトのプリミティブ値を返します。
Object
 InheritedwillTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント一覧定義
  change このグループ内で選択された RadioButton コントロールの値が変化したときに送出されます。RadioButtonGroup
  itemClick ユーザーがグループ内の RadioButton コントロールを選択したときに送出されます。RadioButtonGroup
プロパティの詳細
enabledプロパティ
enabled:Boolean  [read-write]

選択が可能かどうかを判別します。

デフォルト値true.

このプロパティはデータバインディングのソースとして使用できます。

実装
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
labelPlacementプロパティ 
labelPlacement:String  [read-write]

グループ内の各コントロールの RadioButton アイコンを基準にした RadioButton ラベルの位置です。この設定はコントロールごとにオーバーライドできます。

MXML での有効な値は、"right""left""bottom"、および "top" です。

ActionScript では、次の定数を使用してこのプロパティを設定します。このプロパティとは、ButtonLabelPlacement.RIGHTButtonLabelPlacement.LEFTButtonLabelPlacement.BOTTOM、および ButtonLabelPlacement.TOP です。

デフォルト値"right".

このプロパティはデータバインディングのソースとして使用できます。

実装
    public function get labelPlacement():String
    public function set labelPlacement(value:String):void
numRadioButtonsプロパティ 
numRadioButtons:int  [read-only]

この RadioButtonGroup に属する RadioButton の数です。

デフォルト値"undefined".

実装
    public function get numRadioButtons():int
selectedValueプロパティ 
selectedValue:Object  [read-write]

null (デフォルト値) 以外の値が設定されている場合、グループから選択された RadioButton コントロールの value プロパティの値です。それ以外の場合は、選択された RadioButton の label プロパティの値は selectedValue です。RadioButton が選択されていない場合、このプロパティは null です。

selectedValue を設定すると、value プロパティまたは label プロパティがこの値に一致する RadioButton コントロールが選択されます。

デフォルト値null.

このプロパティはデータバインディングのソースとして使用できます。

実装
    public function get selectedValue():Object
    public function set selectedValue(value:Object):void
selectionプロパティ 
selection:RadioButton  [read-write]

グループ内で現在選択されている RadioButton コントロールへの参照を格納します。このプロパティには ActionScript からのみアクセスできます。MXML で設定することはできません。

デフォルト値null.

このプロパティはデータバインディングのソースとして使用できます。

実装
    public function get selection():RadioButton
    public function set selection(value:RadioButton):void
コンストラクタの詳細
RadioButtonGroup()コンストラクタ
public 関数 RadioButtonGroup(document:IFlexDisplayObject = null)

コンストラクタ。

パラメータ
document:IFlexDisplayObject (default = null) — クラスが単純に EventDispatcher を継承する場合は、document パラメータを使用しないでください。

関連項目

メソッドの詳細
getRadioButtonAt()メソッド
public function getRadioButtonAt(index:int):RadioButton

指定されたインデックス位置にある RadioButton コントロールを返します。

パラメータ
index:int — RadioButtonGroup コントロール内の RadioButton のインデックスです。最初のコントロールのインデックスは 0 です。

戻り値
RadioButton — 指定された RadioButton コントロールです。
initialized()メソッド 
public function initialized(document:Object, id:String):void

遅延インスタンス化をサポートする IMXMLObject.initialized() メソッドの実装です。

パラメータ
document:Object — このオブジェクトを作成した MXML ドキュメント
 
id:String — ドキュメントがこのオブジェクトを参照するために使用する識別子です。オブジェクトがドキュメントの deep プロパティである場合、id は null になります。

関連項目

イベントの詳細
changeevent 
イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.CHANGE

このグループ内で選択された RadioButton コントロールの値が変化したときに送出されます。

change イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblestrue
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
target値が変更されたオブジェクトです。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。
itemClickevent  
イベントオブジェクトの型: mx.events.ItemClickEvent
ItemClickEvent.type property = mx.events.ItemClickEvent.ITEM_CLICK

ユーザーがグループ内の RadioButton コントロールを選択したときに送出されます。各 RadioButton コントロールについてハンドラを設定することもできます。

ItemClickEvent.ITEM_CLICK 定数により、itemClick イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

プロパティ
bubblesfalse
cancelablefalse
currentTargetイベントを処理するイベントリスナーを定義するオブジェクト。たとえば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は "myButton" となります。
indexクリックされたナビゲーションアイテムのインデックスです。
itemクリックされたナビゲーションアイテムのデータプロバイダ内のアイテムです。
labelクリックされたナビゲーションアイテムのラベルです。
relatedObjectイベントを生成した子オブジェクトです。
targetイベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。
RadioButtonGroupExample
<?xml version="1.0"?>
<!-- Simple example to demonstrate RadioButtonGroup control. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Script>
        <![CDATA[
    
        import mx.controls.Alert;
        import  mx.events.ItemClickEvent;
    
        // Event handler function to display the selected button
        // in an Alert control.
        private function handleCard(event:ItemClickEvent):void {
            if (event.currentTarget.selectedValue == "AmEx") {
                    Alert.show("You selected American Express") 
            } 
            else {
                if (event.currentTarget.selectedValue == "MC") {
                    Alert.show("You selected MasterCard") 
                } 
                else {
                    Alert.show("You selected Visa") 
                }
            } 
        }
        ]]>
    </mx:Script>

    <mx:Panel title="RadioButtonGroup Control Example" height="75%" width="75%" 
        paddingTop="10" paddingLeft="10">
    
        <mx:Label width="100%" color="blue" 
            text="Select a type of credit card."/>

        <mx:RadioButtonGroup id="cardtype" itemClick="handleCard(event);"/>
        <mx:RadioButton groupName="cardtype" id="americanExpress" value="AmEx" 
            label="American Express" width="150" />
        <mx:RadioButton groupName="cardtype" id="masterCard" value="MC" 
            label="MasterCard" width="150" />
        <mx:RadioButton groupName="cardtype" id="visa" value="Visa" 
            label="Visa" width="150" />
        
    </mx:Panel>        
</mx:Application>




 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/2_jp/langref/mx/controls/RadioButtonGroup.html