RadioButtonGroup

Paket	mx.controls
Klasse	public class RadioButtonGroup
Vererbung	RadioButtonGroup EventDispatcher Object
Implementiert	IMXMLObject

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Beginnend mit Flex 4.0 empfiehlt Adobe die Verwendung der Klasse spark.components.RadioButtonGroup als Alternative zu dieser Klasse.

Mit dem RadioButtonGroup-Steuerelement wird eine Gruppe von RadioButton-Steuerelementen definiert, die als ein sich gegenseitig ausschließendes Steuerelement auftreten; daher kann ein Benutzer nur jeweils ein RadioButton-Steuerelement auswählen. Das Gruppieren von RadioButton-Instanzen in einer RadioButtonGroup ist optional. In einer Gruppe können Sie beispielsweise eine einzige Ereignisprozedur auf einer Gruppe von Schaltflächen, anstatt auf jeder einzelnen Schaltfläche festlegen.

Die id-Eigenschaft wird benötigt, wenn der Name der Gruppe mithilfe des Tags <mx:RadioButtonGroup> definiert wird.

Das RadioButtonGroup-Steuerelement ist eine Unterklasse von EventDispatcher, nicht von UIComponent, und implementiert die IMXMLObject-Schnittstelle. Alle anderen visuellen Komponenten von Flex sind Unterklassen von UIComponent. Diese Klasse implementiert die IUIComponent-Schnittstelle. Das RadioButtonGroup-Steuerelement wird im Flex-Compiler unterstützt. Sie können das RadioButtonGroup-Steuerelement daher als untergeordnetes Element eines Flex-Containers verwenden, obwohl es IUIComponent nicht implementiert. Alle anderen untergeordneten Elemente des Containers müssen die IUIComponent-Schnittstelle implementieren.

Wenn Sie daher eine visuelle Komponente, die die IMXMLObject-Schnittstelle implementiert, als Unterklasse von EventDispatcher definieren, können Sie diese Komponente nicht als untergeordnetes Element eines Containers verwenden.

MXML-Syntax expanded

MXML-Syntax ausblenden

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"
  />

Beispiele anzeigen

Verwandte API-Elemente

mx.controls.RadioButton

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		enabled : Boolean Bestimmt, ob die Auswahl zulässig ist	RadioButtonGroup
		labelPlacement : String Position der RadioButton-Beschriftung relativ zum RadioButton-Symbol für die einzelnen Steuerelemente in der Gruppe.	RadioButtonGroup
		numRadioButtons : int [schreibgeschützt] Die Anzahl der RadioButtons in dieser RadioButtonGroup.	RadioButtonGroup
		selectedValue : Object Der Wert der value-Eigenschaft des ausgewählten RadioButton-Steuerelements in der Gruppe, falls ein anderer Wert als Null (Standardwert) eingestellt wurde.	RadioButtonGroup
		selection : RadioButton Enthält einen Verweis auf das aktuell ausgewählte RadioButton-Steuerelement in der Gruppe.	RadioButtonGroup

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		RadioButtonGroup(document:IFlexDisplayObject = null) Konstruktor.	RadioButtonGroup
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	EventDispatcher
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		getRadioButtonAt(index:int):RadioButton Gibt das RadioButton-Steuerelement an der angegebenen Indexposition zurück.	RadioButtonGroup
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		initialized(document:Object, id:String):void Implementierung der IMXMLObject.initialized()-Methode, um eine zurückgestellte Instanziierung zu unterstützen.	RadioButtonGroup
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
change	Wird ausgelöst, wenn der Wert des ausgewählten RadioButton-Steuerelements in dieser Gruppe geändert wird.	RadioButtonGroup
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
itemClick	Wird ausgelöst, wenn der Benutzer ein RadioButton-Steuerelement in der Gruppe aktiviert.	RadioButtonGroup

Eigenschaftendetails

enabled

Eigenschaft

enabled:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bestimmt, ob die Auswahl zulässig ist

Der Standardwert ist true.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das enabledChanged -Ereignis ausgelöst.

Implementierung
public function get enabled():Boolean
public function set enabled(value:Boolean):void

labelPlacement

Eigenschaft

labelPlacement:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Position der RadioButton-Beschriftung relativ zum RadioButton-Symbol für die einzelnen Steuerelemente in der Gruppe. Sie können diese Einstellung für die einzelnen Steuerelemente außer Kraft setzen.

Gültige Werte in MXML sind "right", "left", "bottom" und "top".

In ActionScript können Sie die folgenden Konstanten verwenden, um diese Eigenschaft festzulegen: ButtonLabelPlacement.RIGHT, ButtonLabelPlacement.LEFT, ButtonLabelPlacement.BOTTOM und ButtonLabelPlacement.TOP.

Der Standardwert ist "right".

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das labelPlacementChanged -Ereignis ausgelöst.

Implementierung
public function get labelPlacement():String
public function set labelPlacement(value:String):void

numRadioButtons

Eigenschaft

numRadioButtons:int [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Anzahl der RadioButtons in dieser RadioButtonGroup.

Der Standardwert ist "undefined".

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das numRadioButtonsChanged -Ereignis ausgelöst.

Implementierung
public function get numRadioButtons():int

selectedValue

Eigenschaft

selectedValue:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der Wert der value-Eigenschaft des ausgewählten RadioButton-Steuerelements in der Gruppe, falls ein anderer Wert alsNull (Standardwert) eingestellt wurde. Andernfalls ist selectedValue der Wert der label-Eigenschaft des ausgewählten RadioButton. Ist kein RadioButton ausgewählt, hat diese Eigenschaft den Wert null.

Wenn Sie einen Wert für selectedValue festlegen, wählt Flex das RadioButton-Steuerelement aus, dessen value- oder label-Eigenschaft diesem Wert entspricht.

Der Standardwert ist null.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das valueCommit -Ereignis ausgelöst.

Implementierung
public function get selectedValue():Object
public function set selectedValue(value:Object):void

selection

Eigenschaft

selection:RadioButton

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Enthält einen Verweis auf das aktuell ausgewählte RadioButton-Steuerelement in der Gruppe. Auf diese Eigenschaft können Sie nur in ActionScript zugreifen, in MXML kann sie nicht festgelegt werden. Wenn Sie für diese Eigenschaft den Wertnull festlegen, wird das momentan ausgewählte RadioButton-Steuerelement deaktiviert.

Der Standardwert ist null.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das valueCommit -Ereignis ausgelöst.

Implementierung
public function get selection():RadioButton
public function set selection(value:RadioButton):void

Konstruktordetails

()

Konstruktor

public function RadioButtonGroup(document:IFlexDisplayObject = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Parameter

document:IFlexDisplayObject (default = null) — In einfachen Fällen, in denen eine Klasse EventDispatcher erweitert, sollte der document-Parameter nicht verwendet werden.

Verwandte API-Elemente

flash.events.EventDispatcher

Methodendetails

getRadioButtonAt

()

Methode

public function getRadioButtonAt(index:int):RadioButton

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt das RadioButton-Steuerelement an der angegebenen Indexposition zurück.

Parameter

index:int — Die Indexposition des RadioButton-Steuerelements im RadioButtonGroup-Steuerelement, in dem die Indexposition des ersten Steuerelements 0 ist.

Rückgabewerte

RadioButton — Das angegebene RadioButton-Steuerelement.

initialized

()

Methode

public function initialized(document:Object, id:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Implementierung der IMXMLObject.initialized()-Methode zur Unterstützung verzögerter Instanziierung.

Parameter

	`document:Object` — Das MXML-Dokument, das dieses Objekt erstellt hat.

	`id:String` — Der vom Dokument für den Verweis auf dieses Objekt verwendete Bezeichner. Ist das Objekt eine verschachtelte Eigenschaft des Dokuments, nimmt`id` den Wert Null an.

Verwandte API-Elemente

mx.core.IMXMLObject

Ereignisdetails

change

Ereignis

Ereignisobjekttyp: flash.events.Event
Eigenschaft Event.type = flash.events.Event.CHANGE

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird ausgelöst, wenn der Wert des ausgewählten RadioButton-Steuerelements in dieser Gruppe geändert wird.

Die Event.CHANGE-Konstante definiert den Wert der type-Eigenschaft eines change-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`true`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Objekt, dessen Wert geändert wurde. Das unter `target` angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft `currentTarget` können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.

itemClick

Ereignis

Ereignisobjekttyp: mx.events.ItemClickEvent
Eigenschaft ItemClickEvent.type = mx.events.ItemClickEvent.ITEM_CLICK

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird ausgelöst, wenn der Benutzer ein RadioButton-Steuerelement in der Gruppe aktiviert. Sie können außerdem eine Prozedur für einzelne RadioButton-Steuerelemente festlegen.

Die ItemClickEvent.ITEM_CLICK-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein itemClick-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`cancelable`	false
`currentTarget`	Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise `myButton.addEventListener()` zur Registrierung eines Ereignis-Listeners verwenden, weist `currentTarget` den Wert „myButton“ auf.
`index`	Die Indexposition des Navigationselements, auf das geklickt wurde.
`item`	Das Objekt im Datenprovider des Navigationselements, auf das geklickt wurde.
`label`	Die Beschriftung des Navigationselements, auf das geklickt wurde.
`relatedObject`	Das untergeordnete Objekt, durch das das Ereignis generiert wurde.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die `currentTarget`-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

Beispiele Verwendung dieses Beispiels

RadioButtonGroupExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate Halo RadioButtonGroup control. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/mx">

    <fx:Script>
        <![CDATA[
            import mx.controls.Alert;
            import  mx.events.ItemClickEvent;
        
            // Event handler function to display the selected button
            // in a Halo Alert control.
            private function handleCard(evt:ItemClickEvent):void {
                switch (evt.currentTarget.selectedValue) {
                    case "AmEx":
                        Alert.show("You selected American Express");
                        break;
                    case "MC":
                        Alert.show("You selected MasterCard");
                        break;
                    case "Visa":
                        Alert.show("You selected Visa");
                        break;
                }
            }
        ]]>
    </fx:Script>

    <fx:Declarations>
        <mx:RadioButtonGroup id="cardtype" itemClick="handleCard(event);"/>
    </fx:Declarations>

    <s:Panel title="Halo RadioButtonGroup Control Example"
            width="75%" height="75%" 
            horizontalCenter="0" verticalCenter="0">
        <s:VGroup left="10" right="10" top="10" bottom="10">
            <s:Label width="100%" color="blue" 
                    text="Select a type of credit card."/>

            <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" />
        </s:VGroup>
    </s:Panel>

</s:Application>

Rechtliche Hinweise | Onlinedatenschutzerklärung

RadioButtonGroup - AS3 Flex

Klassen x

enabled

labelPlacement

numRadioButtons

selectedValue

selection