Paket | fl.controls |
Klasse | public class RadioButtonGroup |
Vererbung | RadioButtonGroup EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
name : String [schreibgeschützt]
Ruft den Namen des Optionsfelds ab. | RadioButtonGroup | ||
numRadioButtons : int [schreibgeschützt]
Ruft die Anzahl von Optionsfeldern in dieser Optionsfeldgruppe ab. | RadioButtonGroup | ||
selectedData : Object
Ruft die value-Eigenschaft des ausgewählten Optionsfelds ab oder legt diese fest. | RadioButtonGroup | ||
selection : RadioButton
Ruft einen Verweis auf das aktuell in der Optionsfeldgruppe ausgewählte Optionsfeld ab oder legt diesen fest. | RadioButtonGroup |
Methode | Definiert von | ||
---|---|---|---|
RadioButtonGroup(name:String)
Erstellt eine neue RadioButtonGroup-Instanz. | 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 | ||
Fügt ein Optionsfeld zum internen Optionsfeld-Array hinzu, mit dem die Indizierung der Optionsfeldgruppe vorgenommen wird, damit in einer Gruppe nur ein Optionsfeld ausgewählt werden kann. | RadioButtonGroup | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
[statisch]
Ruft einen Verweis auf die aktuelle Optionsfeldgruppe ab. | RadioButtonGroup | ||
Ruft die RadioButton-Komponente an der angegebenen Indexposition ab. | RadioButtonGroup | ||
Gibt die Indexposition der angegebenen RadioButton-Instanz 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 | ||
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 | ||
Entfernt die RadioButton-Instanz aus der internen Optionsfeldliste. | RadioButtonGroup | ||
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 sich die in einer Gruppe ausgewählte RadioButton-Instanz ändert. | RadioButtonGroup | |||
Wird ausgelöst, wenn auf eine RadioButton-Instanz geklickt wird. | RadioButtonGroup | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher |
name | Eigenschaft |
numRadioButtons | Eigenschaft |
selectedData | Eigenschaft |
selectedData:Object
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft die Eigenschaft value
des ausgewählten Optionsfelds ab oder legt diese fest. Falls kein Optionsfeld ausgewählt ist, gilt für diese Eigenschaft der Wert null
.
Implementierung
public function get selectedData():Object
public function set selectedData(value:Object):void
Beispiel ( Verwendung dieses Beispiels )
change
-Ereignisse überwacht:
import fl.controls.RadioButton; import fl.controls.RadioButtonGroup; var myRadioGroup:RadioButtonGroup = new RadioButtonGroup("options"); myRadioGroup.addEventListener(Event.CHANGE, changeHandler); var radio1:RadioButton = new RadioButton(); radio1.label = "Option A"; radio1.value = "optionA"; radio1.group = myRadioGroup; radio1.move(10, 10); addChild(radio1); var radio2:RadioButton = new RadioButton(); radio2.label = "Option B"; radio2.value = "optionB"; radio2.group = myRadioGroup; radio2.move(10, 30); addChild(radio2); var radio3:RadioButton = new RadioButton(); radio3.label = "Option C"; radio3.value = "optionC"; radio3.group = myRadioGroup; radio3.move(10, 50); addChild(radio3); function changeHandler(event:Event):void { var rbg:RadioButtonGroup = event.target as RadioButtonGroup; if (rbg.selectedData != null) { trace(rbg.selectedData); } else { trace("no value specified."); } }
selection | Eigenschaft |
selection:RadioButton
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft einen Verweis auf das aktuell in der Optionsfeldgruppe ausgewählte Optionsfeld ab oder legt diesen fest.
Implementierung
public function get selection():RadioButton
public function set selection(value:RadioButton):void
Beispiel ( Verwendung dieses Beispiels )
import fl.controls.RadioButton; import fl.controls.RadioButtonGroup; var radioGroup:RadioButtonGroup = new RadioButtonGroup("rbg"); radioGroup.addEventListener(Event.CHANGE, changeHandler); var radio1:RadioButton = new RadioButton(); radio1.group = radioGroup; radio1.label = "Option A"; radio1.value = 1; radio1.move(10, 10); addChild(radio1); var radio2:RadioButton = new RadioButton(); radio2.group = radioGroup; radio2.label = "Option B"; radio2.value = 2; radio2.move(10, 30); addChild(radio2); function changeHandler(event:Event):void { var rg:RadioButtonGroup = event.currentTarget as RadioButtonGroup; trace("change:", rg.selection.label, "(" + rg.selectedData + ")"); }
RadioButtonGroup | () | Konstruktor |
public function RadioButtonGroup(name:String)
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Erstellt eine neue RadioButtonGroup-Instanz. Dies geschieht in der Regel automatisch, wenn ein Optionsfeld instanziiert wird.
Parametername:String — Der Name der Optionsfeldgruppe.
|
addRadioButton | () | Methode |
public function addRadioButton(radioButton:RadioButton):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Fügt ein Optionsfeld zum internen Optionsfeld-Array hinzu, mit dem die Indizierung der Optionsfeldgruppe vorgenommen wird, damit in einer Gruppe nur ein Optionsfeld ausgewählt werden kann. Diese Methode wird automatisch von Optionsfeldern verwendet, kann aber auch manuell verwendet werden, um ein bestimmtes Optionsfeld explizit zu einer Gruppe hinzuzufügen.
Parameter
radioButton:RadioButton — Die RadioButton-Instanz, die zur aktuellen Optionsfeldgruppe hinzugefügt werden soll.
|
getGroup | () | Methode |
public static function getGroup(name:String):RadioButtonGroup
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft einen Verweis auf die aktuelle Optionsfeldgruppe ab.
Parameter
name:String — Der Name der Gruppe, für die eine Referenz abgerufen werden soll.
|
RadioButtonGroup — Eine Referenz auf die angegebene RadioButtonGroup-Instanz.
|
Beispiel ( Verwendung dieses Beispiels )
import fl.controls.RadioButton; import fl.controls.RadioButtonGroup; var rbg1:RadioButtonGroup = new RadioButtonGroup("group1"); var rb1:RadioButton = new RadioButton(); rb1.label = "Choice A"; rb1.group = rbg1; rb1.move(10, 10); rb1.addEventListener(MouseEvent.CLICK, announceCurrentGroup); addChild(rb1); var rb2:RadioButton = new RadioButton(); rb2.label = "Choice B"; rb2.group = rbg1; rb2.move(10, 30); rb2.addEventListener(MouseEvent.CLICK, announceCurrentGroup); addChild(rb2); function announceCurrentGroup(e:MouseEvent):void { var group:RadioButtonGroup = RadioButtonGroup.getGroup("group1"); trace("The currently selected radio button is: " + group.selection.label); }
getRadioButtonAt | () | Methode |
public function getRadioButtonAt(index:int):RadioButton
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft die RadioButton-Komponente an der angegebenen Indexposition ab.
Parameter
index:int — Die Indexposition der RadioButton-Komponente in der RadioButtonGroup-Komponente, wobei die Indexposition der ersten Komponente 0 ist.
|
RadioButton — Die angegebene RadioButton-Komponente.
|
Auslöser
RangeError — Der angegebene Index ist kleiner als 0 oder größer gleich der Länge des Datenproviders.
|
getRadioButtonIndex | () | Methode |
public function getRadioButtonIndex(radioButton:RadioButton):int
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Gibt die Indexposition der angegebenen RadioButton-Instanz zurück.
Parameter
radioButton:RadioButton — Die in der RadioButton-Gruppe zu suchende RadioButton-Instanz.
|
int — Die Indexposition der angegebenen RadioButton-Komponente oder -1, wenn die angegebene RadioButton-Komponente nicht gefunden wurde.
|
removeRadioButton | () | Methode |
public function removeRadioButton(radioButton:RadioButton):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Entfernt die RadioButton-Instanz aus der internen Optionsfeldliste.
Parameter
radioButton:RadioButton — Zu entfernende RadioButton-Instanz.
|
change | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.CHANGE
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Wird ausgelöst, wenn sich die in einer Gruppe ausgewählte RadioButton-Instanz ändert.
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. |
Beispiel ( Verwendung dieses Beispiels )
change
-Ereignisse der Optionsfeldgruppen hinzugefügt:
import fl.controls.RadioButton; import fl.controls.RadioButtonGroup; var myRadioGroup:RadioButtonGroup = new RadioButtonGroup("options"); myRadioGroup.addEventListener(Event.CHANGE, changeHandler); var radio1:RadioButton = new RadioButton(); radio1.label = "Option A"; radio1.group = myRadioGroup; radio1.move(10, 10); addChild(radio1); var radio2:RadioButton = new RadioButton(); radio2.label = "Option B"; radio2.group = myRadioGroup; radio2.move(10, 30); addChild(radio2); var radio3:RadioButton = new RadioButton(); radio3.label = "Option C"; radio3.group = myRadioGroup; radio3.move(10, 50); addChild(radio3); function changeHandler(event:Event):void { var rg:RadioButtonGroup = event.target as RadioButtonGroup; switch (rg.selection) { case radio1: trace("radio1"); break; case radio2: trace("radio2"); break; case radio3: trace("radio3"); break; } }
click | Ereignis |
flash.events.MouseEvent
Eigenschaft MouseEvent.type =
flash.events.MouseEvent.CLICK
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Wird ausgelöst, wenn auf eine RadioButton-Instanz geklickt wird.
Definiert den Wert der Eigenschafttype
eines click
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
altKey | true , wenn die Alt-Taste aktiv ist (Windows). |
bubbles | true |
buttonDown | Für Klick-Ereignisse ist dieser Wert immer false . |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
commandKey | true unter Mac OS, falls die Befehlstaste aktiviert ist; false , wenn sie deaktiviert ist. Unter Windows immer false |
controlKey | true , wenn die Strg- oder Ctrl-Taste aktiv ist; false , wenn sie nicht aktiv ist. |
ctrlKey | true unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
localX | Die horizontale Koordinate, bei der das Ereignis relativ zum Sprite, in dem es enthalten ist, aufgetreten ist, wenn die Maussperre deaktiviert ist. |
localY | Die vertikale Koordinate, bei der das Ereignis relativ zum Sprite, in dem es enthalten ist, aufgetreten ist, wenn die Maussperre deaktiviert ist. |
movementX | Die Änderung an der horizontalen Koordinate der Mausposition seit dem letzten Mausereignis, wenn die Maussperre aktiviert ist. |
movementY | Die Änderung an der vertikalen Koordinate der Mausposition seit dem letzten Mausereignis, wenn die Maussperre aktiviert ist. |
shiftKey | true , wenn die Umschalttaste aktiv ist; false , wenn sie nicht aktiv ist. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
target | Die InteractiveObject-Instanz unter dem Zeigegerät. 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. |
- Fügen Sie die RadioButton- und Label-Komponenten Ihrer Bibliothek hinzu.
- Speichern Sie diesen Code unter „RadioButtonGroupExample.as“ im gleichen Verzeichnis wie die FLA-Datei.
- Legen Sie für „DocumentClass“ in der FLA-Datei „RadioButtonGroupExample“ fest.
package { import flash.text.TextFieldAutoSize; import flash.display.Sprite; import flash.events.Event; import fl.controls.RadioButton; import fl.controls.RadioButtonGroup; import fl.controls.Label; public class RadioButtonGroupExample extends Sprite { private var padding:uint = 10; private var currHeight:uint = 0; private var verticalSpacing:uint = 30; private var posX:uint; private var reportLabel:Label; public function RadioButtonGroupExample() { setupRadioButtons(); } private function setupRadioButtons():void { reportLabel = new Label(); reportLabel.move(10,150); reportLabel.autoSize = TextFieldAutoSize.LEFT; reportLabel.text = "Select a Radio Button"; addChild(reportLabel); createRadioButtonGroup("1st Group"); createRadioButtonGroup("2nd Group"); createRadioButtonGroup("3rd Group"); createRadioButtonGroup("4th Group"); } private function createRadioButtonGroup(name:String):void { var rbg:RadioButtonGroup = new RadioButtonGroup(name); rbg.addEventListener(Event.CHANGE, announceChange); createRadioButton("1st Button", rbg, posX); createRadioButton("2nd Button", rbg, posX); createRadioButton("3rd Button", rbg, posX); createRadioButton("4th Button", rbg, posX); posX += 125; currHeight = 0; } private function createRadioButton(rbLabel:String,rbg:RadioButtonGroup,posX:uint):void { var rb:RadioButton = new RadioButton(); rb.group = rbg; rb.label = rbLabel; rb.move(posX, padding + currHeight); addChild(rb); currHeight += verticalSpacing; } private function announceChange(e:Event):void { var rbg:RadioButtonGroup = e.target as RadioButtonGroup; var rb:RadioButton = rbg.selection; reportLabel.text = rbg.name + " has selected " + rb.label; } } }
Tue Jun 12 2018, 10:04 AM Z