| 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
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <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"
/>
Verwandte API-Elemente
| 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 | ||
| 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 | |
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
Gibt das RadioButton-Steuerelement an der angegebenen Indexposition zurück. | RadioButtonGroup | ||
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
Implementierung der IMXMLObject.initialized()-Methode, um eine zurückgestellte Instanziierung zu unterstützen. | RadioButtonGroup | ||
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | ||
| Wird ausgelöst, wenn der Wert des ausgewählten RadioButton-Steuerelements in dieser Gruppe geändert wird. | RadioButtonGroup | |||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
| Wird ausgelöst, wenn der Benutzer ein RadioButton-Steuerelement in der Gruppe aktiviert. | RadioButtonGroup | |||
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):voidlabelPlacement | 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):voidnumRadioButtons | 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():intselectedValue | 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):voidselection | 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):voidRadioButtonGroup | () | Konstruktor |
public function RadioButtonGroup(document:IFlexDisplayObject = null)| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
Parameterdocument:IFlexDisplayObject (default = null)document-Parameter nicht verwendet werden.
|
Verwandte API-Elemente
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.
|
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, nimmtid den Wert Null an.
|
Verwandte API-Elemente
change | Ereignis |
flash.events.EventEigenschaft 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.
DieEvent.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 |
mx.events.ItemClickEventEigenschaft 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.
DieItemClickEvent.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. |
<?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>
Tue Jun 12 2018, 10:04 AM Z