| 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 |
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
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <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"
/>
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 | ||
| 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 | ||
| 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 die RadioButton-Komponente 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 der ausgewählten RadioButton-Komponente 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 eine RadioButton-Komponente der Gruppe aktiviert. | RadioButtonGroup | |||
| Wird ausgelöst, wenn Werte programmgesteuert oder durch Benutzerinteraktion geändert werden. | RadioButtonGroup | |||
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):voidnumRadioButtons | 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():intselectedValue | 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):voidselection | 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):voidRadioButtonGroup | () | Konstruktor |
public function RadioButtonGroup(document:IFlexDisplayObject = null)| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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 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.
|
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
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, 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 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn der Wert der ausgewählten RadioButton-Komponente 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 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.
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. |
valueCommit | Ereignis |
mx.events.FlexEventEigenschaft 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.
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. |
<?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>
Tue Jun 12 2018, 10:04 AM Z