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

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

RadioButtonGroup コントロールは UIComponent ではなく EventDispatcher のサブクラスであり、IMXMLObject インターフェイスを実装します。他のすべての Flex のビジュアルコンポーネントは UIComponent のサブクラスであり、IUIComponent インターフェイスを実装します。Flex コンパイラには RadioButtonGroup コントロールのサポートが組み込まれているため、RadioButtonGroup コントロールを Flex コンテナの子として使用できます。ただし、IUIComponent は実装されません。他のすべてのコンテナの子では、IUIComponent インターフェイスを実装する必要があります。

そのため、ビジュアルコンポーネントを、IMXMLObject インターフェイスを実装する EventDispatcher のサブクラスとして定義しようとしても、それをコンテナの子として使用することはできません。

MXML のシンタックスexpandedMXML シンタックスを隠す

The <mx:RadioButtonGroup> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:RadioButtonGroup
    Properties
    enabled="true|false"      
    id="No default"
    labelPlacement="right|left|top|bottom"
  
    Events
    change="No default"
    itemClick="No default"
  />

例を表示

関連項目

mx.controls.RadioButton
RadioButton control

パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  enabled : Boolean
選択が可能かどうかを判別します。
RadioButtonGroup
  labelPlacement : String
グループ内の各コントロールの RadioButton アイコンを基準にした RadioButton ラベルの位置です。
RadioButtonGroup
  numRadioButtons : int
[読み取り専用] この RadioButtonGroup に属する RadioButton の数です。
RadioButtonGroup
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  selectedValue : Object
null（デフォルト値）以外の値が設定されている場合、グループから選択された RadioButton コントロールの value プロパティの値です。
RadioButtonGroup
  selection : RadioButton
グループ内で現在選択されている RadioButton コントロールへの参照を格納します。
RadioButtonGroup
パブリックメソッド
 メソッド定義元
  
RadioButtonGroup(document:IFlexDisplayObject = null)
コンストラクタです。
RadioButtonGroup
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
EventDispatcher
  
getRadioButtonAt(index:int):RadioButton
指定されたインデックス位置にある RadioButton コントロールを返します。
RadioButtonGroup
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
  
initialized(document:Object, id:String):void
遅延インスタンス化をサポートする IMXMLObject.initialized() メソッドの実装です。
RadioButtonGroup
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited
activate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
  
change
このグループ内で選択された RadioButton コントロールの値が変化したときに送出されます。RadioButtonGroup
 Inherited
deactivate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
  
itemClick
ユーザーがグループ内の RadioButton コントロールを選択したときに送出されます。RadioButtonGroup
プロパティの詳細
enabledプロパティ
enabled:Boolean

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

デフォルト値 : true.

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 enabledChanged イベントが送出されます。



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

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

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

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

デフォルト値 : "右".

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 labelPlacementChanged イベントが送出されます。



実装
    public function get labelPlacement():String
    public function set labelPlacement(value:String):void
numRadioButtonsプロパティ 
numRadioButtons:int  [読み取り専用]

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

デフォルト値 : "未定義".

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 numRadioButtonsChanged イベントが送出されます。



実装
    public function get numRadioButtons():int
selectedValueプロパティ 
selectedValue:Object

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

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

デフォルト値 : null.

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 valueCommit イベントが送出されます。



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

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

デフォルト値 : null.

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 valueCommit イベントが送出されます。



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

コンストラクタです。

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

関連項目

flash.events.EventDispatcher
メソッドの詳細
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 になります。

関連項目

mx.core.IMXMLObject
イベントの詳細
change イベント
イベントオブジェクトの型: flash.events.Event
プロパティ Event.type = flash.events.Event.CHANGE

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

Event.CHANGE 定数は、type プロパティ（change イベントオブジェクト）の値を定義します。

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

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

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

ItemClickEvent.ITEM_CLICK 定数は type プロパティ（itemClick イベント用イベントオブジェクトのプロパティ）の値を定義します。

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

プロパティ値
bubblesfalse
cancelablefalse
currentTargetイベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、currentTarget の値は myButton となります。
indexクリックされたナビゲーションアイテムのインデックスです。
itemクリックされたナビゲーションアイテムのデータプロバイダ内のアイテムです。
labelクリックされたナビゲーションアイテムのラベルです。
relatedObjectイベントを生成した子オブジェクトです。
targetイベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。
例 例の使用法
RadioButtonGroupExample.mxml
<?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>



© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

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

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