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

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

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 コントロール

パブリックプロパティ
 プロパティ定義
 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
パブリック Methods
 メソッド定義
  
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 がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
  
change
このグループ内で選択された RadioButton コントロールの値が変化したときに送出されます。RadioButtonGroup
 Inherited
deactivate
Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
  
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"、"center"、および "top" です。

ActionScript では、定数 ButtonLabelPlacement.RIGHT、ButtonLabelPlacement.LEFT、ButtonLabelPlacement.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 に設定すると、現在選択されている RadioButton コントロールの選択が解除されます。

デフォルト値ヌル (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 パラメータを使用しないでください。

関連項目

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
イベントの詳細
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;
    
// 選択されているボタンを Alert コントロールに表示する // イベントハンドラ関数です。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>



© 2004-2007 Adobe Systems Incorporated. All rights reserved.
2007.04.26, 午前 9:17, GMT-07:00