RadioButtonGroup

Paket	spark.components
Klasse	public class RadioButtonGroup
Vererbung	RadioButtonGroup EventDispatcher Object
Implementiert	IMXMLObject

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Mit der RadioButtonGroup-Komponente wird eine Gruppe von RadioButton-Komponenten definiert, die jeweils als einzelne, die anderen Möglichkeiten ausschließende Komponente auftreten; daher kann der Benutzer nur jeweils eine RadioButton-Komponente auswählen. Die id-Eigenschaft wird benötigt, wenn der Name der Gruppe mithilfe des Tags <s:RadioButtonGroup> definiert wird. Alle zu dieser Gruppe hinzugefügten <s:RadioButton>-Komponenten erhalten diesen Gruppennamen.

Die RadioButtonGroup-Komponente ist eine Unterklasse von EventDispatcher, nicht von UIComponent, und implementiert die IMXMLObject-Schnittstelle. Alle anderen visuellen Komponenten von Flex implementieren die IVisualElement-Schnittstelle. Die RadioButtonGroup-Komponentendeklaration muss im Tag <Declarations> enthalten sein, da sie IVisualElement nicht zugewiesen werden kann.

Erstellen Sie einen Elementrenderer, um diese Komponente in einer listenbasierten Komponente wie beispielsweise einer Liste oder einem DataGrid zu verwenden. Weitere Informationen zum Erstellen eines Elementrenderers finden Sie unter Benutzerdefinierte Spark-Elementrenderer.

MXML-Syntax expanded

MXML-Syntax ausblenden

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

  <s:RadioButtonGroup
    Properties
    enabled="true"
    selectedValue="null"
    selection="null"
 
    Events
    change="No default"
    itemClick="No default"
    valueCommit="No default"
  />

Beispiele anzeigen

Verwandte API-Elemente

spark.components.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
		numRadioButtons : int [schreibgeschützt] Die Anzahl der RadioButtons in dieser RadioButtonGroup.	RadioButtonGroup
		selectedValue : Object Die value-Eigenschaft der ausgewählten RadioButton-Komponente in der Gruppe, falls ein Wert eingestellt wurde, ansonsten die label-Eigenschaft des ausgewählten RadioButton-Steuerelements.	RadioButtonGroup
		selection : RadioButton Enthält einen Verweis auf die aktuell ausgewählte RadioButton-Komponente 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 die RadioButton-Komponente 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 der ausgewählten RadioButton-Komponente 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 eine RadioButton-Komponente der Gruppe aktiviert.	RadioButtonGroup
valueCommit	Wird ausgelöst, wenn Werte programmgesteuert oder durch Benutzerinteraktion geändert werden.	RadioButtonGroup

Eigenschaftendetails

enabled

Eigenschaft

enabled:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Bestimmt, ob die Auswahl zulässig ist Beachten Sie, dass der zurückgegebene Wert nur den Wert widerspiegelt, der explizit für RadioButtonGroup festgelegt wurde, und keine anderen Werte, die für die einzelnen RadioButtons festgelegt wurden.

Der Standardwert ist true.

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

numRadioButtons

Eigenschaft

numRadioButtons:int [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Die Anzahl der RadioButtons in dieser RadioButtonGroup.

Der Standardwert ist "0".

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 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Die value-Eigenschaft der ausgewählten RadioButton-Komponente in der Gruppe, falls ein Wert eingestellt wurde, ansonsten die label-Eigenschaft des ausgewählten RadioButton-Steuerelements. Ist kein RadioButton ausgewählt, hat diese Eigenschaft den Wert null.

Wenn Sie einen Wert für selectedValue festlegen, wählt Flex die erste RadioButton-Komponente aus, deren 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 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Enthält einen Verweis auf die aktuell ausgewählte RadioButton-Komponente 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 Wert null festlegen, wird die momentan ausgewählte RadioButton-Komponente deaktiviert. Es wird kein change-Ereignis ausgelöst.

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 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

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 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Gibt die RadioButton-Komponente an der angegebenen Indexposition zurück.

Parameter

index:int — Die auf null basierende Indexposition des RadioButton-Steuerelements in der RadioButtonGroup.

Rückgabewerte

RadioButton — Die angegebene RadioButton-Komponente, wenn die Indexposition zwischen 0 und numRadioButtons - 1 liegt. Gibt null zurück, wenn die Indexposition ungültig ist.

Verwandte API-Elemente

numRadioButtons

initialized

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

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 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Wird ausgelöst, wenn der Wert der ausgewählten RadioButton-Komponente 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 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Wird ausgelöst, wenn der Benutzer eine RadioButton-Komponente der Gruppe aktiviert. Sie können außerdem eine Prozedur für einzelne RadioButton-Komponenten festlegen. Dieses Ereignis wird nur ausgelöst, wenn der Benutzer über die Maus mit den Optionsschaltern interagiert.

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.

valueCommit

Ereignis

Ereignisobjekttyp: mx.events.FlexEvent
Eigenschaft FlexEvent.type = mx.events.FlexEvent.VALUE_COMMIT

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Wird ausgelöst, wenn Werte programmgesteuert oder durch Benutzerinteraktion geändert werden.

Da dieses Ereignis durch eine programmgesteuerte Änderung ausgelöst wird, müssen Sie sicherstellen, dass keine valueCommit-Ereignisprozedur einen Wert ändert, der zu einem weiteren valueCommit-Ereignis führt. Beispiel: Ändern Sie die selectedValue-Eigenschaft oder die selection-Eigenschaft nicht in einer valueCommit-Ereignisprozedur.

Die FlexEvent.VALUE_COMMIT-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein valueCommit-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.
`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"?>
<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;
            
            private function handlePayment(event:ItemClickEvent):void {
                if (event.currentTarget.selectedValue == "check") {
                    Alert.show("You opted to pay by check."); 
                } else if (event.currentTarget.selectedValue == "credit") {
                    Alert.show("You opted to pay by credit card.");
                }
            }
        ]]>
    </fx:Script>
    
    <fx:Declarations>
        <s:RadioButtonGroup id="paymentType" itemClick="handlePayment(event);"/>
    </fx:Declarations>
    <s:VGroup paddingLeft="10" paddingTop="10">
        <s:RadioButton groupName="paymentType" 
                       id="payCheck" 
                       value="check" 
                       label="Pay by check" 
                       width="150"/>
        <s:RadioButton groupName="paymentType" 
                       id="payCredit" 
                       value="credit" 
                       label="Pay by credit card" 
                       width="150"/>
    </s:VGroup>
</s:Application>

Rechtliche Hinweise | Onlinedatenschutzerklärung

RadioButtonGroup - AS3 Flex

Klassen x

enabled

numRadioButtons

selectedValue

selection