Paketfl.controls
Klassepublic class ComboBox
VererbungComboBox Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Implementiert IFocusManagerComponent

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Die ComboBox-Komponente enthält eine Dropdownliste, in der ein Wert ausgewählt werden kann. Seine Funktion ist der des SELECT-Elements in HTML ähnlich. Die ComboBox-Komponente kann bearbeitbar sein; in diesem Fall kann der Benutzer Text, der nicht in der Liste steht, in den TextInput-Teil der ComboBox-Komponente eingeben.

Beispiele anzeigen

Siehe auch

List
TextInput


Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedaccessibilityProperties : AccessibilityProperties
Die aktuellen Eingabehilfenoptionen für dieses Anzeigeobjekt.
DisplayObject
 Inheritedalpha : Number
Gibt den Alphatransparenzwert des angegebenen Objekts an.
DisplayObject
 InheritedblendMode : String
Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll.
DisplayObject
 InheritedbuttonMode : Boolean
Legt den Schaltflächenmodus für dieses Sprite fest.
Sprite
 InheritedcacheAsBitmap : Boolean
Wird diese Eigenschaft auf "true" gesetzt, speichert Flash Player eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache.
DisplayObject
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcontextMenu : ContextMenu
Gibt das diesem Objekt zugeordnete Kontextmenü an.
InteractiveObject
  dataProvider : DataProvider
Ruft das Datenmodell der Elementenliste ab, die angezeigt werden soll, oder legt dieses fest.
ComboBox
 InheriteddoubleClickEnabled : Boolean
Gibt an, ob das Objekt doubleClick-Ereignisse empfängt.
InteractiveObject
  dropdown : List
[read-only] Ruft einen Verweis auf die List-Komponente ab, die die ComboBox-Komponente enthält.
ComboBox
  dropdownWidth : Number
Ruft die maximale Breite der Dropdown-Liste in Pixeln ab oder legt diese fest.
ComboBox
 InheriteddropTarget : DisplayObject
[read-only] Gibt das Anzeigeobjekt an, über das der Sprite gezogen wird oder auf dem der Sprite abgelegt wurde.
Sprite
  editable : Boolean
Ruft einen booleschen Wert ab, der angibt, ob die ComboBox-Komponente bearbeitet werden kann oder schreibgeschützt ist, oder legt diesen fest.
ComboBox
 Inheritedenabled : Boolean
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Komponente eine Benutzereingabe annehmen kann.
UIComponent
 Inheritedfilters : Array
Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält.
DisplayObject
 InheritedfocusEnabled : Boolean
Ruft einen booleschen Wert ab, der angibt, ob die Komponente den Fokus erhalten kann, wenn der Benutzer darauf klickt, oder legt diesen fest.
UIComponent
 InheritedfocusManager : IFocusManager
Ruft den FocusManager-Wert ab bzw. legt den FocusManager-Wert fest, der den Fokus für diese und gleichrangige Komponenten steuert.
UIComponent
 InheritedfocusRect : Object
Gibt an, ob für dieses Objekt ein Fokus-Rechteck angezeigt wird.
InteractiveObject
 Inheritedgraphics : Graphics
[read-only] Legt das Graphics-Objekt fest, das zu diesem Sprite gehört und für das Vektorzeichnungsbefehle zulässig sind.
Sprite
 Inheritedheight : Number
Ruft die Höhe der Komponente in Pixeln ab oder legt diese fest.
UIComponent
 InheritedhitArea : Sprite
Gibt als Kollisionsbereich für ein Sprite ein anderes Sprite an.
Sprite
  labelField : String
Ruft den Namen des Felds im dataProvider-Objekt ab, der als Beschriftung für das TextInput-Feld und die Dropdown-Liste angezeigt werden soll, oder legt diesen Namen fest.
ComboBox
  labelFunction : Function
Ruft die Funktion ab bzw. legt die Funktion fest, die zum Abrufen der Beschriftung für das Element verwendet wird.
ComboBox
  length : int
[read-only] Ruft die Anzahl der Elemente in der Liste ab.
ComboBox
 InheritedloaderInfo : LoaderInfo
[read-only] Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört.
DisplayObject
 Inheritedmask : DisplayObject
Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert.
DisplayObject
 InheritedmouseChildren : Boolean
Bestimmt, ob die dem Objekt untergeordneten Objekte per Maus aktivierbar sind.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Gibt an, ob dieses Objekt Meldungen von der Maus empfängt.
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
Ruft einen Wert ab, der angibt, ob die Komponente den Fokus erhalten kann, wenn der Benutzer darauf klickt, oder legt diesen fest.
UIComponent
 InheritedmouseX : Number
[read-only] Gibt die x-Koordinate der Mausposition in Pixel an.
DisplayObject
 InheritedmouseY : Number
[read-only] Gibt die y-Koordinate der Mausposition in Pixel an.
DisplayObject
 Inheritedname : String
Gibt den Instanznamen des Anzeigeobjekts an.
DisplayObject
 InheritednumChildren : int
[read-only] Liefert die Anzahl der Objekte, die diesem Objekt untergeordnet sind.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält.
DisplayObject
  prompt : String
Ruft die Aufforderung für die ComboBox-Komponente ab oder legt diese fest.
ComboBox
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
  restrict : String
Ruft die maximale Anzahl von Zeichen ab, die ein Benutzer in einem Textfeld eingeben kann, oder legt diese fest.
ComboBox
 Inheritedroot : DisplayObject
[read-only] Bei einem Anzeigeobjekt in einer geladenen SWF-Datei ist die root-Eigenschaft das oberste Anzeigeobjekt in dem Teil der Baumstruktur der Anzeigeliste, der diese SWF-Datei repräsentiert.
DisplayObject
 Inheritedrotation : Number
Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an.
DisplayObject
  rowCount : uint
Ruft die Höchstanzahl der Spalten ab, die in der Dropdown-Liste ohne Bildlaufleiste angezeigt werden kann, oder legt diese fest.
ComboBox
 Inheritedscale9Grid : Rectangle
Das aktuell verwendete Skalierungsraster.
DisplayObject
 InheritedscaleX : Number
Multipliziert die aktuelle Breite der Komponente mit einem Skalierungsfaktor.
UIComponent
 InheritedscaleY : Number
Multipliziert die aktuelle Höhe der Komponente mit einem Skalierungsfaktor.
UIComponent
 InheritedscrollRect : Rectangle
Die Begrenzungen des Bildlaufrechtecks für das Anzeigeobjekt.
DisplayObject
  selectedIndex : int
Ruft den Index des Elements ab, das aus einer Liste mit Einzelauswahl ausgewählt wurde, oder legt diesen fest.
ComboBox
  selectedItem : Object
Ruft den Wert des in der Dropdown-Liste ausgewählten Elements ab oder legt diesen fest.
ComboBox
  selectedLabel : String
[read-only] Ruft den im TextInput-Teil der ComboBox-Komponente angezeigten String ab.
ComboBox
 InheritedsoundTransform : SoundTransform
Steuert den Sound innerhalb dieses Sprites.
Sprite
 Inheritedstage : Stage
[read-only] Die Bühne des Anzeigeobjekts.
DisplayObject
 InheritedtabChildren : Boolean
Bestimmt, ob die dem Objekt untergeordneten Objekte per Tabulatortaste aktivierbar sind.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet.
InteractiveObject
 InheritedtabIndex : int
Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an.
InteractiveObject
  text : String
Ruft den Text ab bzw. legt den Text fest, den as Textfeld einer bearbeitbaren ComboBox-Komponente enthält.
ComboBox
  textField : TextInput
[read-only] Ruft einen Verweis auf die TextInput-Komponente ab, die die ComboBox-Komponente enthält.
ComboBox
 InheritedtextSnapshot : TextSnapshot
[read-only] Liefert ein TextSnapshot-Objekt für diese DisplayObjectContainer-Instanz.
DisplayObjectContainer
 Inheritedtransform : Transform
Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören.
DisplayObject
 InheriteduseHandCursor : Boolean
Ein boolescher Wert, der angibt, ob der Handcursor angezeigt werden soll, wenn die Maus über ein Sprite-Objekt geführt wird, dessen buttonMode-Eigenschaft auf "true" gesetzt ist.
Sprite
  value : String
[read-only] Ruft die Bezeichnung eines Elements in einer bearbeitbaren ComboBox-Komponente ab.
ComboBox
 Inheritedversion : String = "3.0.0.15"
Die Versionsnummer der Komponenten.
UIComponent
 Inheritedvisible : Boolean
Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob die Komponenteninstanz sichtbar ist.
UIComponent
 Inheritedwidth : Number
Ruft die Breite der Komponente in Pixeln ab oder legt diese fest.
UIComponent
 Inheritedx : Number
Ruft die X-Koordinate ab, die die Position der Komponente auf der X-Achse innerhalb des übergeordneten Containers angibt.
UIComponent
 Inheritedy : Number
Ruft die Y-Koordinate ab, die die Position der Komponente auf der Y-Achse innerhalb des übergeordneten Containers angibt.
UIComponent
Öffentliche Methoden
 MethodeDefiniert von
  
Erstellt eine neue Instanz der ComboBox-Komponente.
ComboBox
 Inherited
Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu.
DisplayObjectContainer
 Inherited
Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu.
DisplayObjectContainer
 Inherited
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 Element am Ende der Elementenliste hinzu.
ComboBox
  
addItemAt(item:Object, index:uint):void
Fügt der Liste an der angegebenen Indexposition ein Element hinzu.
ComboBox
 Inherited
Gibt an, ob aufgrund der Sicherheitseinschränkungen irgendwelche Anzeigeobjekte aus der Liste ausgeschlossen werden, die beim Aufrufen der DisplayObjectContainer.getObjectsUnderPoint()-Methode mit dem angegebenen point-Punkt zurückgegeben wird.
DisplayObjectContainer
 Inherited
Löscht eine Stileigenschaft aus dieser Komponenteninstanz.
UIComponent
  
Schließt die Dropdownliste.
ComboBox
 Inherited
Ermittelt, ob das angegebene Anzeigeobjekt der DisplayObjectContainer-Instanz oder der Instanz selbst untergeordnet ist.
DisplayObjectContainer
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Blendet die Fokusanzeige auf dieser Komponente ein oder aus.
UIComponent
 Inherited
Leitet einen unmittelbaren Erstellungsvorgang ein, ohne sämtliche Elemente wie bei "invalidateNow" zu entwerten.
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert.
DisplayObject
 Inherited
Gibt die untergeordnete Anzeigeobjektinstanz zurück, die sich an der angegebenen Indexposition befindet.
DisplayObjectContainer
 Inherited
Gibt das untergeordnete Anzeigeobjekt für den angegebenen Namen zurück.
DisplayObjectContainer
 Inherited
Gibt die Indexposition einer untergeordneten DisplayObject-Instanz zurück.
DisplayObjectContainer
 Inherited
Ruft das Objekt ab, das derzeit den Fokus hat.
UIComponent
  
Ruft das Element an der angegebenen Indexposition ab.
ComboBox
 Inherited
Gibt ein Array an Objekten zurück, die unter dem angegebenen Punkt liegen und dieser DisplayObjectContainer-Instanz untergeordnet sind (auch über mehrere Unterordnungsstufen hinweg).
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Gibt ein Rechteck zurück, das die Begrenzung des Anzeigeobjekts (ohne etwaige Striche oder Formen) definiert, und zwar aufgrund des vom Parameter "targetCoordinateSpace" definierten Koordinatensystems.
DisplayObject
 Inherited
Ruft eine Stileigenschaft ab, die in der Stilkette der Komponente festgelegt ist.
UIComponent
  
[static] Ruft die Standardstilmatrix der aktuellen Komponente ab.
ComboBox
 Inherited
Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts.
DisplayObject
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Wertet das Anzeigeobjekt aus, um festzustellen, ob es das Anzeigeobjekt "obj" überdeckt oder schneidet.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter "x" und "y" festgelegten Punkt überdeckt oder schneidet.
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
Entwertet eine Eigenschaft und erstellt die Komponente im nächsten Bild neu, sofern nicht anderweitig festgelegt.
UIComponent
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
Ruft den String ab, den der Renderer für das angegebene Datenobjekt auf der Grundlage der labelField- und labelFunction-Eigenschaften anzeigt.
ComboBox
 Inherited
Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten.
DisplayObject
 Inherited
[static] Führt Stile aus mehreren Klassen in einem Objekt zusammen.
UIComponent
 Inherited
Verschiebt die Komponente innerhalb der übergeordneten Komponente an die angegebene Position.
UIComponent
  
Öffnet die Dropdownliste.
ComboBox
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
Entfernt alle Elemente aus der Liste.
ComboBox
 Inherited
Entfernt die angegebene untergeordnete DisplayObject-Instanz aus der Child-Liste der DisplayObjectContainer-Instanz.
DisplayObjectContainer
 Inherited
Entfernt ein untergeordnetes Anzeigeobjekt aus der angegebenen Indexposition in der Child-Liste des Anzeigeobjekt-Containers.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
  
Entfernt das angegebene Element aus der Liste.
ComboBox
  
Entfernt das Element an der angegebenen Indexposition.
ComboBox
  
Ersetzt das Element an der angegebenen Indexposition durch ein anderes Element.
ComboBox
 Inherited
Ändert die Position eines vorhandenen untergeordneten Objekts im Anzeigeobjekt-Container.
DisplayObjectContainer
 Inherited
Legt den Fokus auf diese Komponente.
UIComponent
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
setSize(width:Number, height:Number):void
Legt eine bestimmte Breite und Höhe für die Komponente fest.
UIComponent
 Inherited
setStyle(style:String, value:Object):void
Legt eine Stileigenschaft für diese Komponenteninstanz fest.
UIComponent
  
sortItems(... sortArgs):*
Sortiert die Elemente im aktuellen Datenprovider.
ComboBox
  
sortItemsOn(field:String, options:Object = null):*
Sortiert die Elemente im aktuellen Datenprovider nach einem oder mehreren Feldern.
ComboBox
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Ermöglicht es Benutzern, das angegebene Sprite mit einer Ziehoperation zu verschieben.
Sprite
 Inherited
Beendet die startDrag()-Methode.
Sprite
 Inherited
Kehrt die z-Reihenfolge (von vorne nach hinten) der beiden angegebenen untergeordneten Objekte um.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Kehrt die z-Reihenfolge (von vorne nach hinten) der untergeordneten Objekte an den beiden angegebenen Indexpositionen in der Child-Liste um.
DisplayObjectContainer
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Die Eigenschaften und das Layout des Objekts werden geprüft und aktualisiert. Das Objekt wird ggf. neu erstellt.
UIComponent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner vorangegangenen Elementen ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 EreignisÜbersicht Definiert von
 Inherited Wird ausgelöst, wenn Flash Player den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited Wird ausgelöst, wenn ein Objekt der Anzeigeliste hinzugefügt wird.DisplayObject
 Inherited Wird ausgelöst, wenn ein Anzeigeobjekt der Anzeigeliste für die Bühne hinzugefügt wird. Dies erfolgt entweder direkt oder über das Hinzufügen einer Unterstruktur, die das Anzeigeobjekt enthält.DisplayObject
   Wird ausgelöst, wenn der Benutzer die Auswahl in der ComboBox-Komponente ändert oder im Textfeld einer bearbeitbaren ComboBox-Komponente eine Taste drückt.ComboBox
 Inherited Wird ausgelöst, wenn ein Benutzer die Haupttaste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und wieder loslässt.InteractiveObject
   Wird ausgelöst, wenn die Dropdown-Liste geschlossen wird.ComboBox
 Inherited Wird ausgelöst, wenn Flash Player den Betriebssystemfokus verliert und inaktiv wird.EventDispatcher
 Inherited Wird ausgelöst, wenn der Benutzer die Haupttaste des Zeigegeräts zweimal schnell hintereinander über dem gleichen InteractiveObject-Objekt drückt und das doubleClickEnabled-Flag des Objekts "true" lautet.InteractiveObject
   Wird ausgelöst, wenn die editable-Eigenschaft auf "true" gesetzt wurde und der Benutzer bei der Texteingabe im bearbeitbaren Textfeld die Eingabetaste drückt.ComboBox
 Inherited Wird ausgelöst, wenn der Abspielkopf ein neues Bild erreicht.DisplayObject
 Inherited Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus erhalten hat.InteractiveObject
 Inherited Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus verloren hat.InteractiveObject
 Inherited Wird ausgelöst, wenn die Sichtbarkeit der Komponente von sichtbar zu unsichtbar wechselt.UIComponent
   Wird ausgelöst, wenn der Benutzer den Mauszeiger von einem Element in der Komponente wegbewegt.ComboBox
   Wird ausgelöst, wenn der Benutzer den Mauszeiger zu einem Element in der Komponente bewegt.ComboBox
 Inherited Wird ausgelöst, wenn der Benutzer eine Taste drückt.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe der Tastatur zu ändern.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer eine Taste loslässt.InteractiveObject
 Inherited Wird ausgelöst, wenn im Flash Player-Fenster die Taste des Zeigegeräts über einer InteractiveObject-Instanz gedrückt wird.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe eines Zeigegeräts zu ändern.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer das Zeigegerät bewegt, während es sich auf einer InteractiveObject-Instanz befindet.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt.InteractiveObject
 Inherited Wird ausgelöst, wenn das Zeigegerät im Flash Player-Fenster über eine InteractiveObject-Instanz bewegt wird.InteractiveObject
 Inherited Wird ausgelöst, wenn im Flash Player-Fenster die Taste des Zeigegeräts über einer InteractiveObject-Instanz losgelassen wird.InteractiveObject
 Inherited Wird ausgelöst, wenn ein Mausrad im Flash Player-Fenster über einer InteractiveObject-Instanz betätigt wird.InteractiveObject
 Inherited Wird nach dem Verschieben einer Komponente ausgelöst.UIComponent
   Wird ausgelöst, wenn der Benutzer auf die Dropdown-Schaltfläche klickt, um die Dropdown-Liste einzublenden.ComboBox
 Inherited Wird ausgelöst, wenn ein Objekt aus der Anzeigeliste entfernt werden soll.DisplayObject
 Inherited Wird ausgelöst, wenn ein Anzeigeobjekt aus der Anzeigeliste entfernt werden soll. Dies erfolgt entweder direkt oder über das Entfernen einer Unterstruktur, die das Anzeigeobjekt enthält.DisplayObject
 Inherited Wird ausgelöst, wenn die Anzeigeliste aktualisiert und neu gezeichnet werden soll.DisplayObject
 Inherited Wird ausgelöst, wenn die Größe der Komponente geändert wird.UIComponent
 Inherited Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt.InteractiveObject
 Inherited Wird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt.InteractiveObject
   Wird ausgelöst, wenn der Benutzer in der Dropdownliste der ComboBox-Komponente einen Bildlauf durchführt.ComboBox
 Inherited Wird ausgelöst, wenn die Sichtbarkeit der Komponente von unsichtbar zu sichtbar wechselt.UIComponent
 Inherited Wird ausgelöst, wenn sich der Wert des tabChildren-Flags des Objekts ändert.InteractiveObject
 Inherited Wird ausgelöst, wenn sich das tabEnabled-Flag des Objekts ändert.InteractiveObject
 Inherited Wird ausgelöst, wenn sich der Wert der tabIndex-Eigenschaft des Objekts ändert.InteractiveObject
Stile
 Stil Beschreibung Definiert von
  
buttonWidth
Typ: Number   Format: Length
Der Leerraum, der den rechten Rand der Komponente vom Text, der das ausgewählte Element darstellt, trennt in Pixel. Die Schaltfläche ist Teil der Hintergrundskin. Der Standardwert lautet 24.
ComboBox
  
cellRenderer
Typ: Class
Die Klasse, die den Cellrenderer für jedes Element der Komponente bereitstellt. Der Standardwert lautet fl.controls.listClasses.CellRenderer.
ComboBox
  
contentPadding
Typ: Number   Format: Length
Zellauffüllung zwischen dem Inhalt (Komponente und Bildlaufleiste) und dem äußeren Rand des Hintergrunds in Pixel. Der Standardwert lautet 3.
ComboBox
  
disabledAlpha
Typ: Class
Der Alpha-Wert, auf den die Liste gesetzt wird, wenn die Eigenschaft enabled den Wert false hat. Der Standardwert lautet 0.5.
ComboBox
  
disabledSkin
Typ: Class
Der Name der Klasse, die den Hintergrund bereitstellt, der in der ComboBox-Komponente angezeigt wird, wenn die enabled-Eigenschaft der Komponente den Wert false hat. Der Standardwert lautet ComboBox_disabledSkin.
ComboBox
 Inherited Typ: flash.text.TextFormat
Das TextFormat-Objekt, das verwendet wird, um die Komponentenbezeichnung wiederzugeben, wenn die Schaltfläche deaktiviert ist.
UIComponent
  
downArrowDisabledSkin
Typ: Class
Name der Klasse, die als Skin für die Schaltfläche mit dem Pfeil nach unten der Bildlaufleiste verwendet wird, wenn sie deaktiviert ist. Wenn Sie die Skin entweder grafisch oder programmgesteuert ändern, sollten Sie sicherstellen, dass die neue Skin dieselbe Höhe (für horizontale Bildlaufleisten) bzw. Breite (für vertikale Bildlaufleisten) wie die Spur hat. Der Standardwert lautet ScrollArrowDown_disabledSkin.
ComboBox
  
downArrowDownSkin
Typ: Class
Name der Klasse, die als Skin für die Schaltfläche mit dem Pfeil nach unten der Bildlaufleiste verwendet wird, wenn auf die Pfeil-Schaltfläche geklickt wird. Wenn Sie die Skin entweder grafisch oder programmgesteuert ändern, sollten Sie sicherstellen, dass die neue Skin dieselbe Höhe (für horizontale Bildlaufleisten) bzw. Breite (für vertikale Bildlaufleisten) wie die Spur hat. Der Standardwert lautet ScrollArrowDown_downSkin.
ComboBox
  
downArrowOverSkin
Typ: Class
Name der Klasse, die als Skin für die Schaltfläche mit dem Pfeil nach unten der Bildlaufleiste verwendet wird, wenn sich der Mauszeiger über der Pfeil-Schaltfläche befindet. Wenn Sie die Skin entweder grafisch oder programmgesteuert ändern, sollten Sie sicherstellen, dass die neue Skin dieselbe Höhe (für horizontale Bildlaufleisten) bzw. Breite (für vertikale Bildlaufleisten) wie die Spur hat. Der Standardwert lautet ScrollArrowDown_overSkin.
ComboBox
  
downArrowUpSkin
Typ: Class
Name der Klasse, die als Skin für die Schaltfläche mit dem Pfeil nach unten der Bildlaufleiste verwendet wird. Wenn Sie die Skin entweder grafisch oder programmgesteuert ändern, sollten Sie sicherstellen, dass die neue Skin dieselbe Höhe (für horizontale Bildlaufleisten) bzw. Breite (für vertikale Bildlaufleisten) wie die Spur hat. Der Standardwert lautet ScrollArrowDown_upSkin.
ComboBox
  
downSkin
Typ: Class
Der Name der Klasse, die den Hintergrund bereitstellt, der in der ComboBox-Komponente angezeigt wird, wenn die Maustaste gedrückt wird. Der Standardwert lautet ComboBox_downSkin.
ComboBox
  
embedFonts
Typ: Boolean
Gibt an, ob eingebettete Schriftkonturen für die Wiedergabe des Textfelds verwendet werden sollen. Wenn dieser Wert auf true gesetzt ist, wird das Textfeld in Flash Player mit eingebetteten Schriftkonturen dargestellt. Wenn dieser Wert auf false gesetzt ist, wird das Textfeld in Flash Player mit Geräteschriftarten dargestellt.

Wenn Sie die Eigenschaft embedFonts für ein Textfeld auf true setzen, müssen Sie für diesen Text mit der Eigenschaft font eines auf das Textfeld angewendeten TextFormat-Objekts eine Schriftart angeben. Wenn die angegebene Schriftart nicht in der SWF-Datei eingebettet ist, wird der Text nicht angezeigt.

Der Standardwert lautet false.
ComboBox
 Inherited Typ: Number   Format: Length
Die Zellauffüllung, die die äußeren Grenzen der Komponente von den äußeren Rändern der Fokusanzeige trennt, in Pixel.
UIComponent
 Inherited Typ: Class
Die Skin, die für die Anzeige von Fokusanzeigen verwendet wird.
UIComponent
  
overSkin
Typ: Class
Der Name der Klasse, die den Hintergrund bereitstellt, der in der ComboBox-Komponente angezeigt wird, wenn der Mauszeiger sich darüber befindet. Der Standardwert lautet ComboBox_overSkin.
ComboBox
  
repeatDelay
Typ: Number   Format: Time
Die Anzahl der Millisekunden, die nach dem ersten Auslösen des buttonDown-Ereignisses gewartet werden soll, bevor ein zweites buttonDown-Ereignis ausgelöst wird. Der Standardwert lautet 500.
ComboBox
  
repeatInterval
Typ: Number   Format: Time
Das Intervall in Millisekunden zwischen buttonDown-Ereignissen, die nach der Verzögerung, die durch den repeatDelay-Stil festgelegt wird, ausgelöst werden. Der Standardwert lautet 35.
ComboBox
 Inherited Typ: flash.text.TextFormat
Das TextFormat-Objekt, das für die Wiedergabe der Komponentenbezeichnung verwendet wird.
UIComponent
  
textPadding
Typ: Number   Format: Length
Der Leerraum, der den Rand vom Text, der das ausgewählte Element darstellt, trennt in Pixel. Der Standardwert lautet 3.
ComboBox
  
thumbArrowUpSkin
Typ: Class
Name der Klasse, die als Skin für den Schieber der Bildlaufleiste verwendet wird. Der Standardwert lautet ScrollThumb_upSkin.
ComboBox
  
thumbDisabledSkin
Typ: Class
Die Skin, die verwendet wird, um den deaktivierten Zustand des Schiebers anzuzeigen. Der Standardwert lautet ScrollThumb_upSkin.
ComboBox
  
thumbDownSkin
Typ: Class
Name der Klasse, die als Skin für den Schieber der Bildlaufleiste verwendet wird, wenn auf den Schieber geklickt wird. Der Standardwert lautet ScrollThumb_downSkin.
ComboBox
  
thumbIcon
Typ: Class
Name der Klasse, die als Symbol für den Schieber der Bildlaufleiste verwendet wird. Der Standardwert lautet ScrollBar_thumbIcon.
ComboBox
  
thumbOverSkin
Typ: Class
Name der Klasse, die als Skin für den Schieber der Bildlaufleiste verwendet wird, wenn sich der Mauszeiger über dem Schieber befindet. Der Standardwert lautet ScrollThumb_overSkin.
ComboBox
  
trackDisabledSkin
Typ: Class
Die Skin, die verwendet wird, um eine deaktivierte Spur anzuzeigen. Der Standardwert lautet ScrollTrack_Skin.
ComboBox
  
trackDownSkin
Typ: Class
Die Skin, die verwendet wird, um den Down-Zustand einer deaktivierten Skin anzuzeigen. Der Standardwert lautet ScrollTrack_Skin.
ComboBox
  
trackOverSkin
Typ: Class
Die Skin, die verwendet wird, um den mouseover-Zustand der Bildlaufspur anzuzeigen. Der Standardwert lautet ScrollTrack_Skin.
ComboBox
  
trackUpSkin
Typ: Class
Die Skin, die verwendet wird, um den mouseup-Zustand der Bildlaufspur anzuzeigen. Der Standardwert lautet ScrollTrack_Skin.
ComboBox
  
upArrowDisabledSkin
Typ: Class
Name der Klasse, die als Skin für die Schaltfläche mit dem Pfeil nach oben der Bildlaufleiste verwendet wird, wenn sie deaktiviert ist. Wenn Sie die Skin entweder grafisch oder programmgesteuert ändern, sollten Sie sicherstellen, dass die neue Skin dieselbe Höhe (für horizontale Bildlaufleisten) bzw. Breite (für vertikale Bildlaufleisten) wie die Spur hat. Der Standardwert lautet ScrollArrowUp_disabledSkin.
ComboBox
  
upArrowDownSkin
Typ: Class
Name der Klasse, die als Skin für die Schaltfläche mit dem Pfeil nach oben der Bildlaufleiste verwendet wird, wenn auf die Pfeil-Schaltfläche geklickt wird. Wenn Sie die Skin entweder grafisch oder programmgesteuert ändern, sollten Sie sicherstellen, dass die neue Skin dieselbe Höhe (für horizontale Bildlaufleisten) bzw. Breite (für vertikale Bildlaufleisten) wie die Spur hat. Der Standardwert lautet ScrollArrowUp_downSkin.
ComboBox
  
upArrowOverSkin
Typ: Class
Name der Klasse, die als Skin für die Schaltfläche mit dem Pfeil nach oben der Bildlaufleiste verwendet wird, wenn sich der Mauszeiger über der Pfeil-Schaltfläche befindet. Wenn Sie die Skin entweder grafisch oder programmgesteuert ändern, sollten Sie sicherstellen, dass die neue Skin dieselbe Höhe (für horizontale Bildlaufleisten) bzw. Breite (für vertikale Bildlaufleisten) wie die Spur hat. Der Standardwert lautet ScrollArrowUp_overSkin.
ComboBox
  
upArrowUpSkin
Typ: Class
Name der Klasse, die als Skin für die Schaltfläche mit dem Pfeil nach oben der Bildlaufleiste verwendet wird. Wenn Sie die Skin entweder grafisch oder programmgesteuert ändern, sollten Sie sicherstellen, dass die neue Skin dieselbe Höhe (für horizontale Bildlaufleisten) bzw. Breite (für vertikale Bildlaufleisten) wie die Spur hat. Der Standardwert lautet ScrollArrowUp_upSkin.
ComboBox
  
upSkin
Typ: Class
Der Name der Klasse, die den Hintergrund für die ComboBox-Komponente bereitstellt. Der Standardwert lautet ComboBox_upSkin.
ComboBox
Eigenschaftsdetail
dataProviderEigenschaft
dataProvider:DataProvider  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft das Datenmodell der Elementenliste ab, die angezeigt werden soll, oder legt dieses fest. Ein Datenprovider kann von mehreren listenbasierten Komponenten gemeinsam genutzt werden. Änderungen an dem Datenprovider stehen sofort sämtlichen Komponenten, die ihn als Datenquelle nutzen, zur Verfügung.


Implementierung
    public function get dataProvider():DataProvider
    public function set dataProvider(value:DataProvider):void

Siehe auch


Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie den Datenprovider für eine ComboBox-Komponente festlegen. Bei einer Aktualisierung des Datenproviders wird auch die ComboBox-Komponente aktualisiert.

import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();

var cb:ComboBox = new ComboBox();
cb.dataProvider = dp;
addChild(cb);

var counter = 0;
var t:Timer = new Timer(500);
t.addEventListener(TimerEvent.TIMER,addAnotherItem);
t.start();

function addAnotherItem(e:TimerEvent = null):void {
    dp.addItem( { label: "Item " + counter++ } );
}
dropdownEigenschaft 
dropdown:List  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft einen Verweis auf die List-Komponente ab, die die ComboBox-Komponente enthält. Die List-Unterkomponente wird nicht in der ComboBox-Komponente instanziiert, bevor sie angezeigt wird. Diese Liste wird jedoch beim Zugriff auf die Eigenschaft dropdown erstellt.


Implementierung
    public function get dropdown():List
dropdownWidthEigenschaft 
dropdownWidth:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft die maximale Breite der Dropdown-Liste in Pixeln ab oder legt diese fest. Der Standardwert dieser Eigenschaft ist die Breite der ComboBox-Komponente (die Breite der TextInput-Instanz plus die Breite der BaseButton-Instanz).

Der Standardwert lautet 100.


Implementierung
    public function get dropdownWidth():Number
    public function set dropdownWidth(value:Number):void

Beispiel

Im folgenden Beispiel wird eine ComboBox-Komponenteninstanz erstellt und ihre Eigenschaft columnWidth entsprechend dem Wert einer Slider-Komponente eingestellt:

import fl.controls.ComboBox;
import fl.controls.Slider;
import fl.events.SliderEvent;

var mySlider:Slider = new Slider();
mySlider.minimum = 50;
mySlider.maximum = 150;
mySlider.liveDragging = true;
mySlider.snapInterval = 5;
mySlider.tickInterval = 10;
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
mySlider.move(10, 10);
addChild(mySlider);

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item A"});
myComboBox.addItem({label:"Item B"});
myComboBox.move(10, 30);
addChild(myComboBox);

mySlider.value = myComboBox.dropdownWidth;

function changeHandler(event:SliderEvent):void {
    myComboBox.dropdownWidth = event.value;
}

Im folgenden Beispiel wird eine ComboBox-Komponenteninstanz erstellt und ihre Eigenschaft drowpdownWidth entsprechend der Textlänge in der Dropdown-Liste eingestellt:

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"The quick brown fox"});
myComboBox.addItem({label:"Lorem ipsum"});
myComboBox.addItem({label:"Little Miss Muffet"});
myComboBox.addItem({label:"Goldilocks and the three bears"});
myComboBox.addItem({label:"Jack and Jill"});
myComboBox.move(10, 30);
addChild(myComboBox);

var maxLength:Number = 0;
var i:uint;
for (i = 0; i < myComboBox.length; i++) {
    myComboBox.selectedIndex = i;
    myComboBox.drawNow();
    var currText:String = myComboBox.text;
    var currWidth:Number = myComboBox.textField.textWidth;
    maxLength = Math.max(currWidth, maxLength);
    trace(currText, currWidth, maxLength);
}

myComboBox.selectedIndex = -1;
myComboBox.dropdownWidth = maxLength + 20;
myComboBox.open();
editableEigenschaft 
editable:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft einen booleschen Wert ab, der angibt, ob die ComboBox-Komponente bearbeitet werden kann oder schreibgeschützt ist, oder legt diesen fest. Der Wert true gibt an, dass die ComboBox-Komponente bearbeitet werden kann, der Wert false, dass sie nicht bearbeitet werden kann.

Bei bearbeitbaren ComboBox-Komponenten können auch Werte in das Textfeld eingegeben werden, die nicht in der Dropdown-Liste enthalten sind. Das Textfeld enthält den Text des Elements in der Liste. Wenn eine ComboBox-Komponente nicht bearbeitet werden kann, können Sie keinen Text in das Textfeld eingeben.

Der Standardwert lautet false.


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

Beispiel

Im folgenden Beispiel wird eine neue bearbeitbare ComboBox-Instanz erstellt, welche beim Auslösen des enter-Ereignisses benutzerdefinierte Elemente zum Datenprovider hinzufügt:

import fl.controls.ComboBox;
import fl.data.DataProvider;
import fl.events.ComponentEvent;

var dp:DataProvider = new DataProvider();

var myComboBox:ComboBox = new ComboBox;
myComboBox.dataProvider = dp;
myComboBox.editable = true;
myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler);
myComboBox.move(10, 10);
addChild(myComboBox);

function enterHandler(event:ComponentEvent):void {
    var myCB:ComboBox = event.currentTarget as ComboBox;
    dp.addItem({label:myCB.text});
    myCB.text = "";
    myCB.sortItemsOn("label", Array.CASEINSENSITIVE);
}
labelFieldEigenschaft 
labelField:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft den Namen des Felds im dataProvider-Objekt ab, der als Beschriftung für das TextInput-Feld und die Dropdown-Liste angezeigt werden soll, oder legt diesen Namen fest.

Standardmäßig wird von der Komponente die Eigenschaft label der einzelnen dataProvider-Elemente angezeigt. Wenn die dataProvider-Elemente jedoch keine Eigenschaft label enthalten, können Sie für die Eigenschaft labelField festlegen, dass eine andere Eigenschaft verwendet wird.

Hinweis: Die Eigenschaft labelField wird nicht verwendet, wenn die Eigenschaft labelFunction für eine Rückruf-Funktion festgelegt ist.

Der Standardwert lautet "label".


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

Siehe auch


Beispiel

Im folgenden Beispiel wird eine ComboBox-Komponente erstellt und die Eigenschaft labelField für die Einstellung eines benutzerdefinierten Bezeichnungsfelds eingestellt:

import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({firstName:"Jane", lastName:"Doe"}); 
dp.addItem({firstName:"Bill", lastName:"Smith"});
dp.addItem({firstName:"Tim", lastName:"Jones"});
dp.sortOn(["firstName","lastName"]);

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.labelField = "firstName";
myComboBox.move(10, 10);
addChild(myComboBox);
labelFunctionEigenschaft 
labelFunction:Function  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft die Funktion ab bzw. legt die Funktion fest, die zum Abrufen der Beschriftung für das Element verwendet wird.

Standardmäßig wird von der Komponente die Eigenschaft label für dataProvider-Elemente angezeigt. Einige Datensätze enthalten unter Umständen kein label-Feld oder kein Feld, dessen Wert ohne Bearbeitung als Beschriftung verwendet werden kann. So speichert beispielsweise ein bestimmter Datensatz vollständige Namen, verwaltet diese jedoch in den Feldern lastName und firstName. In diesem Fall kann die Eigenschaft zum Festlegen einer Callback-Funktion verwendet werden, die die Felder lastName und firstName in einen anzuzeigenden vollständigen Namenszeichensatz verkettet.

Hinweis: Die Eigenschaft labelField wird nicht verwendet, wenn die Eigenschaft labelFunction für eine Rückruf-Funktion festgelegt ist.


Implementierung
    public function get labelFunction():Function
    public function set labelFunction(value:Function):void

Siehe auch


Beispiel

In diesem Beispiel wird die labelFunction-Eigenschaft einer Liste auf eine Funktion eingestellt, welche den String für eine Anzeige in allen Zellen formatiert:
import fl.data.DataProvider;
import fl.controls.List;

var myDataProvider:DataProvider = new DataProvider();
myDataProvider.addItem({name:"User A", price:0.43});
myDataProvider.addItem({name:"User B", price:0.34});

var users:List = new List();
users.dataProvider = myDataProvider;
users.labelFunction = myLabelFunction;
addChild(users);

function myLabelFunction(item:Object):String {
    return  item.name + " ($" + item.price.toFixed(2) + ")";
}

Im folgenden Beispiel wird eine ComboBox-Komponente erstellt und die Eigenschaft labelField für die Einstellung eines benutzerdefinierten Bezeichnungsfelds eingestellt:

import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({firstName:"Jane", lastName:"Doe"}); 
dp.addItem({firstName:"Bill", lastName:"Smith"});
dp.addItem({firstName:"Tim", lastName:"Jones"});
dp.sortOn(["lastName", "firstName"]);

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.labelFunction = nameLabelFunction;
myComboBox.move(10, 10);
addChild(myComboBox);

function nameLabelFunction(item:Object):String {
    return item.lastName + ", " + item.firstName;
}
lengthEigenschaft 
length:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft die Anzahl der Elemente in der Liste ab. Diese Eigenschaft gilt für die List-Komponente, kann aber auch von einer ComboBox-Instanz aufgerufen werden.

Der Standardwert lautet 0.


Implementierung
    public function get length():int

Siehe auch


Beispiel

Im folgenden Beispiel wird eine ComboBox-Komponente erstellt und ihre rowCount-Eigenschaft entsprechend der in der ComboBox-Komponente enthaltenen Anzahl von Elementen eingestellt:

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item A"});
myComboBox.addItem({label:"Item B"});
myComboBox.addItem({label:"Item C"});
myComboBox.addItem({label:"Item D"});
myComboBox.addItem({label:"Item E"});
myComboBox.addItem({label:"Item F"});
myComboBox.rowCount = myComboBox.length / 2;
addChild(myComboBox);

Im folgenden Beispiel wird eine ComboBox-Komponente erstellt und ihre rowCount-Eigenschaft entsprechend der in der ComboBox-Komponente enthaltenen Anzahl von Elementen eingestellt:

import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({label:"Item A"});
dp.addItem({label:"Item B"});
dp.addItem({label:"Item C"});
dp.addItem({label:"Item D"});
dp.addItem({label:"Item E"});
dp.addItem({label:"Item F"});

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.rowCount = myComboBox.length / 2;
addChild(myComboBox);
promptEigenschaft 
prompt:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft die Aufforderung für die ComboBox-Komponente ab oder legt diese fest. Die Eingabeaufforderung ist ein String, der im TextInput-Teil des Kombinationsfelds angezeigt wird, wenn selectedIndex -1 ist. Für gewöhnlich ist dies ein String wie beispielsweise "Wählen Sie ...". Wenn keine Eingabeaufforderung festgelegt wird, setzt die ComboBox-Komponente die Eigenschaft selectedIndex auf 0 und zeigt das erste Element in der Eigenschaft dataProvider an.

Der Standardwert lautet "".


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

Beispiel

Im folgenden Beispiel wird eine ComboBox-Komponenteninstanz erstellt, ihre Eigenschaft prompt eingestellt und die Größe des Kombinationsfelds an die Breite des Aufforderungstextes angepasst:

import fl.controls.ComboBox;

var cbStyles:Object = ComboBox.getStyleDefinition();
var bW:Number = cbStyles.buttonWidth as Number

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Please select an option...";
myComboBox.addItem({label:"Option 1"});
myComboBox.addItem({label:"Option 2"});
myComboBox.drawNow();
myComboBox.width = myComboBox.textField.textWidth + 35;
myComboBox.dropdownWidth = myComboBox.width - bW;
myComboBox.move(10, 10);
addChild(myComboBox);

Im folgenden Beispiel wird eine ComboBox-Komponenteninstanz erstellt und ihre Eigenschaft prompt entsprechend der Anzahl von Elementen in ihrem Datenprovider eingestellt:

import fl.controls.ComboBox;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({label:"Getting Started"});
dp.addItem({label:"New Features"});
dp.addItem({label:"ActionScript"});
dp.addItem({label:"Components"});
dp.sortOn("label", Array.CASEINSENSITIVE);

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Topics (" + dp.length + ")";
myComboBox.dataProvider = dp;
myComboBox.width = 150;
myComboBox.move(10, 10);
addChild(myComboBox);
restrictEigenschaft 
restrict:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft die maximale Anzahl von Zeichen ab, die ein Benutzer in einem Textfeld eingeben kann, oder legt diese fest. Weist die Eigenschaft restrict eine bestimmte Zeichenfolge als Wert auf, können nur diese Zeichen in das Textfeld eingegeben werden. Der String wird von links nach rechts gelesen. Wenn die Eigenschaft restrict auf null gesetzt ist, kann jedes beliebige Zeichen eingegeben werden. Wenn die Eigenschaft restrict einen leeren String ("") enthält, kann kein Zeichen eingegeben werden. Sie können mithilfe eines Bindestrichs (-) einen Zeichenbereich angeben. Mit dieser Eigenschaft werden nur Benutzereingaben eingeschränkt. Mit einem Skript kann jedes beliebige Zeichen in das Textfeld gestellt werden.

Der Standardwert lautet null.


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

Siehe auch


Beispiel

Im folgenden Beispiel wird eine bearbeitbare ComboBox-Komponente erstellt, die mithilfe der Eigenschaft restrict nur die Eingabe von hexadezimalen Farbwerten zulässt.

import fl.controls.ComboBox;
import fl.data.DataProvider;
import fl.events.ComponentEvent;

var dp:DataProvider = new DataProvider();

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.editable = true;
myComboBox.restrict = "0-9A-F";
myComboBox.textField.maxChars = 6;
myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler);
myComboBox.move(10, 10);
addChild(myComboBox);

function enterHandler(event:ComponentEvent):void {
    var colorStr:String = ComboBox(event.currentTarget).text;
    var colorNum:uint = uint("0x" + colorStr);
    dp.addItem({label:colorStr, value:colorNum});
    dp.sortOn("value", Array.NUMERIC);
    event.currentTarget.text = "";
}
rowCountEigenschaft 
rowCount:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft die Höchstanzahl der Spalten ab, die in der Dropdown-Liste ohne Bildlaufleiste angezeigt werden kann, oder legt diese fest. Falls die Anzahl der Elemente in der Dropdown-Liste diesen Wert überschreitet, wird die Listengröße angepasst und eine Bildlaufleiste angezeigt, falls erforderlich. Falls die Anzahl der Elemente in der Dropdown-Liste kleiner als dieser Wert ist, wird die Listengröße an die darin enthaltenen Elemente angepasst.

In diesem Punkt weicht das Verhalten von der List-Komponente ab, bei der immer die in der Eigenschaft rowCount festgelegte Zeilenanzahl angezeigt wird, auch wenn das Listenfeld dabei nicht vollständig von den Elementen ausgefüllt wird.

Der Standardwert lautet 5.


Implementierung
    public function get rowCount():uint
    public function set rowCount(value:uint):void

Siehe auch


Beispiel

Im folgenden Beispiel wird eine Slider-Komponente verwendet, um die Eigenschaft rowCount für eine ComboBox-Komponente einzustellen:

import fl.controls.ComboBox;
import fl.controls.Slider;
import fl.events.SliderEvent;

var numItems:uint = 8;

var mySlider:Slider = new Slider();
mySlider.tickInterval = 1;
mySlider.snapInterval = 1;
mySlider.minimum = 1;
mySlider.maximum = numItems;
mySlider.liveDragging = true;
mySlider.move(10, 10);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

var myComboBox:ComboBox = new ComboBox();
myComboBox.move(10, 30);
addChild(myComboBox);

var i:uint;
for (i = 0; i < numItems; i++) {
    myComboBox.addItem({label:"Item " + i});
}

function changeHandler(event:SliderEvent):void {
    myComboBox.rowCount = event.value;
}
selectedIndexEigenschaft 
selectedIndex:int  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft den Index des Elements ab, das aus einer Liste mit Einzelauswahl ausgewählt wurde, oder legt diesen fest. Eine Liste mit Einzelauswahl ist eine Liste, aus der nur jeweils ein Element ausgewählt werden kann.

Der Wert -1 gibt an, dass kein Element ausgewählt ist. Falls mehrere Elemente ausgewählt werden, entspricht der Wert dem Index des Elements, das zuletzt in der Gruppe ausgewählter Elemente ausgewählt wurde.

Wenn ActionScript zum Festlegen dieser Eigenschaft verwendet wird, wird das Element an der angegebenen Indexposition durch die aktuelle Auswahl ersetzt. Wenn die Auswahl programmgesteuert geändert wird, wird kein change-Ereignisobjekt ausgelöst.

Der Standardwert lautet 0.


Implementierung
    public function get selectedIndex():int
    public function set selectedIndex(value:int):void

Siehe auch


Beispiel

Im folgenden Beispiel wird eine Slider-Komponente verwendet, um die Eigenschaft selectedIndex der ComboBox-Komponenteninstanz einzustellen:

import fl.controls.ComboBox;
import fl.controls.Slider;
import fl.data.DataProvider;
import fl.events.SliderEvent;

var items:XML = <items>
        <item label="Item 1" />
        <item label="Item 2" />
        <item label="Item 3" />
        <item label="Item 4" />
    </items>;

var dp:DataProvider = new DataProvider(items);

var mySlider:Slider = new Slider();
mySlider.liveDragging = true;
mySlider.tickInterval = 1;
mySlider.snapInterval = 1;
mySlider.minimum = 0;
mySlider.maximum = dp.length - 1;
mySlider.width = 100;
mySlider.move(10, 10);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.move(10, 30);
addChild(myComboBox);

function changeHandler(event:SliderEvent):void {
    myComboBox.selectedIndex = event.value;
}

Im folgenden Beispiel wird eine ComboBox-Komponente erstellt und der Wert ihrer selectedIndex-Eigenschaft in einer Bezeichnung auf der Bühne angezeigt:

import fl.controls.ComboBox;
import fl.controls.Label;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Please select an item...";
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.addItem({label:"Item 4"});
myComboBox.width = 150;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myComboBox);

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "selectedIndex:" + myComboBox.selectedIndex;
myLabel.move(myComboBox.x + myComboBox.width + 10, myComboBox.y);
addChild(myLabel);

function changeHandler(event:Event):void {
    myLabel.text = "selectedIndex:" + myComboBox.selectedIndex;
}
selectedItemEigenschaft 
selectedItem:Object  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft den Wert des in der Dropdown-Liste ausgewählten Elements ab oder legt diesen fest. Falls der Benutzer Text in das Textfeld einer bearbeitbaren ComboBox-Komponente eingibt, ist die Eigenschaft selectedItem auf undefined gesetzt. Diese Eigenschaften enthält nur einen Wert, wenn der Benutzer ein Element auswählt oder wenn ActionScript zur Auswahl eines Elements aus der Dropdownliste verwendet wird. Falls die ComboBox-Komponente nicht bearbeitet werden kann, gilt immer der Wert der Eigenschaft selectedItem. Falls die Dropdownliste einer bearbeitbaren ComboBox-Komponente keine Elemente enthält, ist der Wert dieser Eigenschaft null.

Der Standardwert lautet null.


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

Siehe auch


Beispiel

Im folgenden Beispiel wird eine Button-Komponente verwendet, um Elemente aus einer ComboBox-Komponente zu einer List-Komponente zu kopieren:

import fl.controls.Button;
import fl.controls.ComboBox;
import fl.controls.List;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select an item";
myComboBox.addItem({label:"Item A"});
myComboBox.addItem({label:"Item B"});
myComboBox.addItem({label:"Item C"});
myComboBox.move(10, 10);
addChild(myComboBox);

var myButton:Button = new Button();
myButton.label = "Copy";
myButton.move(myComboBox.x + myComboBox.width + 10, myComboBox.y);
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myButton);

var myList:List = new List();
myList.rowCount = myList.length;
myList.selectable = false;
myList.move(myComboBox.x, myComboBox.y + myComboBox.height + 10);
addChild(myList);

function clickHandler(event:MouseEvent):void {
    if (myComboBox.selectedIndex > -1) {
        myList.addItem(myComboBox.selectedItem);
        myList.rowCount = myList.length;
    }
}

Im folgenden Beispiel werden zwei Label-Komponenten verwendet, um das aktuell ausgewählte Element in einer ComboBox-Komponente anzuzeigen:

import fl.controls.ComboBox;
import fl.controls.Label;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select a user:";
myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); 
myComboBox.addItem({firstName:"Bill", lastName:"Smith"});
myComboBox.addItem({firstName:"Tim", lastName:"Jones"});
myComboBox.labelFunction = nameLabelFunction;
myComboBox.width = 120;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myComboBox);

var firstNameLabel:Label = new Label();
firstNameLabel.text = "";
firstNameLabel.autoSize = TextFieldAutoSize.LEFT;
firstNameLabel.move(myComboBox.x, myComboBox.y + myComboBox.height);
addChild(firstNameLabel);

var lastNameLabel:Label = new Label();
lastNameLabel.text = "";
lastNameLabel.autoSize = TextFieldAutoSize.LEFT;
lastNameLabel.move(firstNameLabel.x, firstNameLabel.y + firstNameLabel.height);
addChild(lastNameLabel);

function changeHandler(event:Event):void {
    var cb:ComboBox = event.currentTarget as ComboBox;
    var item:Object = cb.selectedItem;
    if (cb.selectedIndex > -1) {
        firstNameLabel.text = item.firstName;
        lastNameLabel.text = item.lastName;
    }
}

function nameLabelFunction(item:Object):String {
    return item.lastName + ", " + item.firstName;
}
selectedLabelEigenschaft 
selectedLabel:String  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft den im TextInput-Teil der ComboBox-Komponente angezeigten String ab. Dieser Wert wird anhand von Daten unter Verwendung der Eigenschaft labelField oder labelFunction berechnet.


Implementierung
    public function get selectedLabel():String

Siehe auch


Beispiel

Im folgenden Beispiel wird eine Label-Komponente verwendet, um die Eigenschaft selectedLabel für eine ComboBox-Komponente anzuzeigen:

import fl.controls.ComboBox;
import fl.controls.Label;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select a user:";
myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); 
myComboBox.addItem({firstName:"Bill", lastName:"Smith"});
myComboBox.addItem({firstName:"Tim", lastName:"Jones"});
myComboBox.labelFunction = nameLabelFunction;
myComboBox.width = 120;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myComboBox);

var myLabel:Label = new Label();
myLabel.text = "";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myComboBox.x, myComboBox.y + myComboBox.height);
addChild(myLabel);

function changeHandler(event:Event):void {
    var cb:ComboBox = event.currentTarget as ComboBox;
    myLabel.text = "selectedLabel: " + cb.selectedLabel;
}

function nameLabelFunction(item:Object):String {
    return item.lastName + ", " + item.firstName;
}
textEigenschaft 
text:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft den Text ab bzw. legt den Text fest, den das Textfeld einer bearbeitbaren ComboBox-Komponente enthält. Bei ComboBox-Komponenten, die nicht bearbeitet werden können, ist dieser Wert schreibgeschützt.

Der Standardwert lautet "".


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

Beispiel

Im folgenden Beispiel wird eine bearbeitbare ComboBox-Komponente erstellt, die den in eine TextArea-Komponenteninstanz eingegebenen Text anzeigt:

import fl.controls.ComboBox;
import fl.controls.TextArea;
import fl.events.ComponentEvent;

var myComboBox:ComboBox = new ComboBox();
myComboBox.editable = true;
myComboBox.addEventListener(TextEvent.TEXT_INPUT, textInputHandler);
myComboBox.addEventListener(ComponentEvent.ENTER, enterHandler);
myComboBox.width = 300;
myComboBox.move(10, 10);
addChild(myComboBox);

var myTextArea:TextArea = new TextArea();
myTextArea.wordWrap = false;
myTextArea.setSize(300, 200);
myTextArea.move(myComboBox.x, myComboBox.y + myComboBox.height + 10);
addChild(myTextArea)

function textInputHandler(event:TextEvent):void {
    myTextArea.appendText(event.type + ":\n");
    myTextArea.appendText("\t" + event.currentTarget.text + "\n");
    myTextArea.appendText("\t" + event.text + "\n");
    myTextArea.appendText("\n");
    
    autoScroll(myTextArea);
}

function enterHandler(event:ComponentEvent):void {
    myTextArea.appendText(event.type + ":\n");
    myTextArea.appendText("\t" + event.currentTarget.text + "\n");
    myTextArea.appendText("\n");
    autoScroll(myTextArea);
}

function autoScroll(ta:TextArea):void {
    ta.verticalScrollPosition = ta.maxVerticalScrollPosition;
}
textFieldEigenschaft 
textField:TextInput  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft einen Verweis auf die TextInput-Komponente ab, die die ComboBox-Komponente enthält. Verwenden Sie diese Eigenschaft, um auf die untergeordnete TextInput-Komponente zuzugreifen und diese zu bearbeiten. Sie können diese Eigenschaft verwenden, um die Auswahl im Textfeld zu ändern oder den Zeichensatz zu beschränken, der in das Textfeld eingegeben werden kann.


Implementierung
    public function get textField():TextInput

Beispiel

Im folgenden Beispiel wird eine bearbeitbare ComboBox-Komponente erstellt, die nur 8 Zeichen bei einer Eingabe zulässt:

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.editable = true;
myComboBox.textField.maxChars = 8;
myComboBox.move(10, 10);
addChild(myComboBox);

Im folgenden Beispiel wird eine ComboBox-Komponente erstellt und das Textformat für das eingebettete Textfeld eingestellt:

import fl.controls.ComboBox;

var comicSansTF:TextFormat = new TextFormat();
comicSansTF.font = "Comic Sans MS";

var myComboBox:ComboBox = new ComboBox();
myComboBox.textField.setStyle("textFormat", comicSansTF);
myComboBox.addItem({label:"Item A"});
myComboBox.addItem({label:"Item B"});
myComboBox.addItem({label:"Item C"});
myComboBox.addItem({label:"Item D"});
myComboBox.move(10, 10);
addChild(myComboBox);

Im folgenden Beispiel wird eine ComboBox-Komponenteninstanz erstellt und ein benutzerdefiniertes Textformat sowohl für das eingebettete Textfeld als auch für das Dropdown-Menü festgelegt:

import fl.controls.ComboBox;
import fl.data.DataProvider;

var myTextFormat:TextFormat = new TextFormat();
myTextFormat.font = "Comic Sans MS";
myTextFormat.color = 0xFF0000;

var fontArray:Array = Font.enumerateFonts(true);
fontArray.sortOn("fontName", Array.CASEINSENSITIVE);

var dp:DataProvider = new DataProvider(fontArray);

var myComboBox:ComboBox = new ComboBox();
myComboBox.dataProvider = dp;
myComboBox.dropdown.iconField = null;
myComboBox.labelField = "fontName";
myComboBox.textField.setStyle("textFormat", myTextFormat);
myComboBox.dropdown.setRendererStyle("textFormat", myTextFormat);
myComboBox.width = 200;
myComboBox.move(10, 10);
addChild(myComboBox);
valueEigenschaft 
value:String  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft die Bezeichnung eines Elements in einer bearbeitbaren ComboBox-Komponente ab. Bei ComboBox-Komponenten, die nicht bearbeitet werden können, ruft diese Eigenschaften die im Element enthaltenen Daten ab.


Implementierung
    public function get value():String

Beispiel

Im folgenden Beispiel wird eine Slider-Komponente verwendet, um die Eigenschaft value für eine bearbeitbare ComboBox-Komponente anzuzeigen:

import fl.controls.ComboBox;
import fl.controls.Label;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select a user:";
myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); 
myComboBox.addItem({firstName:"Bill", lastName:"Smith"});
myComboBox.addItem({firstName:"Tim", lastName:"Jones"});
myComboBox.labelFunction = nameLabelFunction;
myComboBox.width = 120;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
myComboBox.editable = true;
addChild(myComboBox);

var myLabel:Label = new Label();
myLabel.text = "";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myComboBox.x, myComboBox.y + myComboBox.height);
addChild(myLabel);

function changeHandler(event:Event):void {
    var cb:ComboBox = event.currentTarget as ComboBox;
    myLabel.text = "value: " + cb.value;
}

function nameLabelFunction(item:Object):String {
    var str:String;
    if (item == null) {
        str = myComboBox.value;
    } else {
        str = item.lastName + ", " + item.firstName;
    }
    return str;
}
Konstruktordetail
ComboBox()Konstruktor
public function ComboBox()

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Erstellt eine neue Instanz der ComboBox-Komponente.

Methodendetail
addItem()Methode
public function addItem(item:Object):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Fügt ein Element am Ende der Elementenliste hinzu.

Ein Element muss die Eigenschaften label und data enthalten. Elemente mit anderen Eigenschaften können jedoch auch zur Liste hinzugefügt werden. Standardmäßig wird die Eigenschaft label eines Elements zum Anzeigen der Beschriftung in der Zeile verwendet. Die Eigenschaft data wird zum Speichern von Daten in der Zeile verwendet.

Parameter

item:Object — Das Element, das dem Datenprovider hinzugefügt wird.

Siehe auch

addItemAt()Methode 
public function addItemAt(item:Object, index:uint):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Fügt der Liste an der angegebenen Indexposition ein Element hinzu. Die Indizes von Elemente an oder nach der angegebenen Indexposition werden um 1 erhöht.

Parameter

item:Object — Das Element, das zur Liste hinzugefügt wird.
 
index:uint — Die Indexposition, an der das Element hinzugefügt wird.

Siehe auch

close()Methode 
public function close():void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Schließt die Dropdownliste.

Hinweis: Wenn Sie diese Methode aufrufen, wird das Ereignis close ausgelöst. Wenn die ComboBox-Instanz bereits geschlossen ist, hat das Abrufen dieser Methode keinen Effekt.

Siehe auch


Beispiel

Im folgenden Beispiel wird eine ComboBox-Komponenteninstanz erstellt und die Sichtbarkeit des Dropdown-Menüs mithilfe der Methoden open() und close() umgeschaltet:

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.OPEN, openHandler);
myComboBox.addEventListener(Event.CLOSE, closeHandler);
addChild(myComboBox);

var isOpen:Boolean = false;

var timer:Timer = new Timer(1000);
timer.addEventListener(TimerEvent.TIMER, timerHandler);
timer.start();

function openHandler(event:Event):void {
    isOpen = true;
}

function closeHandler(event:Event):void {
    isOpen = false;
}

function timerHandler(event:TimerEvent):void {
    if (isOpen) {
        myComboBox.close();
    } else {
        myComboBox.open();
    }
}
getItemAt()Methode 
public function getItemAt(index:uint):Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft das Element an der angegebenen Indexposition ab.

Parameter

index:uint — Der Index des Elements, das abgerufen werden soll.

Rückgabewerte
Object — Das Objekt an der angegebenen Indexposition.

Beispiel

Im folgenden Beispiel wird eine ComboBox-Komponenteninstanz erstellt. Ferner wird eine for-Schleife sowie die Methode getItemAt() verwendet, um Elemente aus der ComboBox-Komponente in eine DataGrid-Komponente zu kopieren.

import fl.controls.ComboBox;
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1", price:0.34});
myComboBox.addItem({label:"Item 2", price:13.19});
myComboBox.addItem({label:"item 3", price:2.96});
myComboBox.addItem({label:"Item 4", price:3.49});
myComboBox.addItem({label:"Item 5", price:1.27});
myComboBox.move(10, 10);
addChild(myComboBox);

var indexCol:DataGridColumn = new DataGridColumn("index");
indexCol.headerText = "";
indexCol.sortOptions = Array.NUMERIC;

var labelCol:DataGridColumn = new DataGridColumn("label");
labelCol.sortOptions = Array.CASEINSENSITIVE;

var priceCol:DataGridColumn = new DataGridColumn("price");
priceCol.sortOptions = Array.NUMERIC;

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(indexCol);
myDataGrid.addColumn(labelCol);
myDataGrid.addColumn(priceCol);
myDataGrid.move(10, 40);
myDataGrid.rowCount = myComboBox.length;
myDataGrid.width = 180;
addChild(myDataGrid);

var i:uint;
var item:Object;
for (i = 0; i < myComboBox.length; i++) {
    item = myComboBox.getItemAt(i);
    myDataGrid.addItem({index:i, label:item.label, price:item.price});
}
getStyleDefinition()Methode 
public static function getStyleDefinition():Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft die Standardstilmatrix der aktuellen Komponente ab. Die Stilmatrix enthält den für die Komponente geeigneten Typ und hängt von dem Stil ab, der von der Komponente verwendet wird. Der Stil disabledTextFormat enthält beispielsweise den Wert null oder ein TextFormat-Objekt. Sie können diese Stile verwenden und setStyle() für die aktuelle Komponente aufrufen. Mit folgendem Code wird der Standardstil disabledTextFormat der angegebenen Komponente überschrieben:

componentInstance.setStyle("disabledTextFormat", new TextFormat());

Rückgabewerte
Object — Das standardmäßige Stilobjekt.

Siehe auch


Beispiel

Im folgenden Beispiel wird ein Stilbrowser für mehrere Komponentenklassen erstellt:
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}
itemToLabel()Methode 
public function itemToLabel(item:Object):String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ruft den String ab, den der Renderer für das angegebene Datenobjekt auf der Grundlage der Eigenschaften labelField und labelFunction anzeigt.

Hinweis: Die Eigenschaft labelField wird nicht verwendet, wenn die Eigenschaft labelFunction für eine Rückruf-Funktion festgelegt ist.

Parameter

item:Object — Das darzustellende Objekt.

Rückgabewerte
String — Der auf der Grundlage der Daten anzuzeigende String.

Siehe auch

open()Methode 
public function open():void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Öffnet die Dropdownliste.

Hinweis: Wenn Sie diese Methode aufrufen, wird das Ereignis open ausgelöst. Wenn die ComboBox-Instanz bereits geöffnet ist, hat das Aufrufen dieser Methode keinen Effekt.

Siehe auch

removeAll()Methode 
public function removeAll():void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Entfernt alle Elemente aus der Liste.

Siehe auch


Beispiel

Im folgenden Beispiel wird eine Button-Komponenteninstanz verwendet, um die Elemente aus einer ComboBox-Komponente mithilfe der Methode removeAll() zu entfernen:

import fl.controls.Button;
import fl.controls.ComboBox;
import fl.controls.TextInput;

var greenTF:TextFormat;
var redTF:TextFormat;
var myTextInput:TextInput;
var addButton:Button;
var myComboBox:ComboBox;
var removeButton:Button;

greenTF = new TextFormat();
greenTF.color = 0x006600;

redTF = new TextFormat();
redTF.color = 0xFF0000;

myTextInput = new TextInput();
myTextInput.maxChars = 20;
myTextInput.restrict = "a-zA-Z";
myTextInput.move(10, 10);
addChild(myTextInput);

addButton = new Button();
addButton.label = "(+) Add";
addButton.setStyle("textFormat", greenTF);
addButton.move(120, 10);
addButton.addEventListener(MouseEvent.CLICK, addClickHandler);
addChild(addButton);

myComboBox = new ComboBox();
myComboBox.move(10, 40);
addChild(myComboBox);

removeButton = new Button();
removeButton.label = "(-) Remove All";
removeButton.setStyle("textFormat", redTF);
removeButton.move(120, 40);
removeButton.addEventListener(MouseEvent.CLICK, removeClickHandler);
addChild(removeButton);

function addClickHandler(event:MouseEvent):void {
    if (myTextInput.length > 0) {
        trace("adding item...");
        myComboBox.addItem({label:myTextInput.text});
        myComboBox.sortItemsOn("label", Array.CASEINSENSITIVE);
        myTextInput.text = "";
    }
}

function removeClickHandler(event:MouseEvent):void {
    trace("removing all items...");
    myComboBox.removeAll();
}
removeItem()Methode 
public function removeItem(item:Object):Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Entfernt das angegebene Element aus der Liste.

Parameter

item:Object — Das Element, das entfernt werden soll.

Rückgabewerte
Object — Das entfernte Element.

Siehe auch


Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie ein Element aus einer Liste entfernen, wenn Sie darauf geklickt haben:
import fl.controls.List;
import fl.events.ListEvent;

var myList:List = new List();
myList.addItem( { label: "Carrot" } );
myList.addItem( { label: "Turnip" } );
myList.addItem( { label: "Tomato" } );
myList.addItem( { label: "Blueberry" } );
myList.addEventListener(ListEvent.ITEM_CLICK,removeSelectedItem);
addChild(myList);

function removeSelectedItem(e:ListEvent):void {
    myList.removeItem(e.item);
}
removeItemAt()Methode 
public function removeItemAt(index:uint):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Entfernt das Element an der angegebenen Indexposition. Die Indexpositionen der Elemente, deren Indizes größer als der angegebene Index sind, rücken im Array um 1 weiter.

Bei dieser Methode handelt es sich um eine Methode der List-Komponente, die bei Instanzen der ComboBox-Komponente zur Verfügung steht.

Parameter

index:uint — Die Indexposition des zu entfernenden Elements.


Auslöser
RangeError — Der angegebene Index ist kleiner als 0 oder größer gleich der Länge des Datenproviders.

Siehe auch

replaceItemAt()Methode 
public function replaceItemAt(item:Object, index:uint):Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Ersetzt das Element an der angegebenen Indexposition durch ein anderes Element. Durch den Aufruf dieser Methode wird der Datenprovider der List-Komponente modifiziert. Falls der Datenprovider mit anderen Komponenten zusammen verwendet wird, werden die Daten in diesen Komponenten ebenfalls aktualisiert.

Parameter

item:Object — Das Element, das da Element an der angegebene Indexposition ersetzen soll.
 
index:uint — Die Indexposition des Elements, das ersetzt werden soll.

Rückgabewerte
Object — Das ersetzte Element.

Beispiel

Im folgenden Beispiel wird das aktuell in der ComboBox-Komponente ausgewählte Element mithilfe der Methode replaceItemAt() durch den Wert aus einer TextInput-Komponente ersetzt.

import fl.controls.Button;
import fl.controls.ComboBox;
import fl.controls.TextArea;
import fl.controls.TextInput;

var myComboBox:ComboBox = new ComboBox();
myComboBox.prompt = "Select a user...";
myComboBox.addItem({label:"Person 1"});
myComboBox.addItem({label:"Person 2"});
myComboBox.addItem({label:"Person 3"});
myComboBox.addItem({label:"Person 4"});
myComboBox.width = 150;
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myComboBox);

var myTextInput:TextInput = new TextInput();
myTextInput.restrict = "a-zA-Z0-9";
myTextInput.maxChars = 12;
myTextInput.move(10, 40);
addChild(myTextInput)

var myButton:Button = new Button();
myButton.label = "Replace item";
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
myButton.move(120, 40);
addChild(myButton);

var myTextArea:TextArea = new TextArea();
myTextArea.editable = false;
myTextArea.setSize(320, 240);
myTextArea.move(10, 70);
addChild(myTextArea);

function changeHandler(event:Event):void {
    myTextInput.text = myComboBox.selectedLabel;
}

function clickHandler(event:MouseEvent):void {
    var cIndex:int = myComboBox.selectedIndex;
    if (cIndex > -1) {
        var newItem:Object = {label:myTextInput.text};
        var oldItem:Object = myComboBox.replaceItemAt(newItem, cIndex);
        myComboBox.selectedIndex = cIndex;
        myTextArea.appendText("[index:" + cIndex + "] old:'" + oldItem.label +"', new:'" + newItem.label + "'\n");
        myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition;
    }
}
sortItems()Methode 
public function sortItems(... sortArgs):*

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Sortiert die Elemente im aktuellen Datenprovider. Bei dieser Methode erfolgt die Sortierung anhand der Unicode-Werte der Elemente. ASCII ist eine Untergruppe von Unicode.

Parameter

... sortArgs — Die Argumente, nach denen die Sortierung erfolgt.

Rückgabewerte
* — Der Wiedergabewert richtet sich danach, ob Parameter von dieser Methode ausgegeben werden. Weitere Informationen hierzu finden Sie im Abschnitt zur Methode Array.sortOn(). Hinweis: Bei dieser Methode wird 0 wiedergegeben, wenn der Parameter sortArgs auf Array.UNIQUESORT gesetzt ist.

Siehe auch


Beispiel

Im folgenden Beispiel werden die Elemente in einer ComboBox-Instanz entsprechend dem Bezeichnungstext der einzelnen Elemente sortiert. Die zu sortierenden Elemente werden an eine benutzerdefinierte Sortierfunktion mit der Bezeichnung upperCaseSort() übergeben, welche die label-Eigenschaften zweier Elemente vergleicht und einen booleschen Wert zurückgibt, der sich nach der Reihenfolge richtet, in der das Element angezeigt werden soll:
import fl.controls.ComboBox;

var cb:ComboBox = new ComboBox();
cb.addItem( { label: "Mercury" } );
cb.addItem( { label: "Venus" } );
cb.addItem( { label: "Earth" } );
cb.addItem( { label: "planet" } );
cb.sortItems(upperCaseSort);
addChild(cb);

function upperCaseSort(a:Object, b:Object):Boolean {
    return a.label.toUpperCase() > b.label.toUpperCase();
}
sortItemsOn()Methode 
public function sortItemsOn(field:String, options:Object = null):*

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Sortiert die Elemente im aktuellen Datenprovider nach einem oder mehreren Feldern.

Parameter

field:String — Das Feld, das sortiert wird.
 
options:Object (default = null) — Sortierargumente, die zum Überschreiben des Standardsortierverhaltens verwendet werden. Trennt zwei oder mehr Argumente mit dem bitweisen Operator OR (|).

Rückgabewerte
* — Der Wiedergabewert richtet sich danach, ob Parameter von dieser Methode ausgegeben werden. Weitere Informationen hierzu finden Sie im Abschnitt zur Methode Array.sortOn(). Hinweis: Bei dieser Methode wird 0 wiedergegeben, wenn der Parameter sortOption auf Array.UNIQUESORT gesetzt ist.

Siehe auch


Beispiel

Die folgenden Beispiele beruhen auf einer ComboBox-Instanz namens cb, die vier Elemente mit den Bezeichnungen "Apples", "Bananas", "cherries" und "Grapes" enthält:
import fl.controls.ComboBox;

var cb:ComboBox = new ComboBox();
addChild(cb);

// First, populate the ComboBox with the elements.
cb.addItem( { label: "Bananas" } );
cb.addItem( { label: "Apples" } );
cb.addItem( { label: "cherries" } );
cb.addItem( { label: "Grapes" } );

// The following statement sorts using the order parameter set to "ASC", 
// and results in a sort that places "cherries" at the bottom of the list 
// because the sort is case-sensitive.
cb.sortItemsOn("label", "ASC"); 
// resulting order: Apples, Bananas, Grapes, cherries

// The following statement sorts using the order parameter set to "DESC", 
// and results in a sort that places "cherries" at the top of the list 
// because the sort is case-sensitive.
cb.sortItemsOn("label", "DESC");
// resulting order: cherries, Grapes, Bananas, Apples

// The following statement sorts using the optionsFlag parameter set to 
// Array.CASEINSENSITIVE. Note that an ascending sort is the default setting.
cb.sortItemsOn("label", Array.CASEINSENSITIVE);
// resulting order: Apples, Bananas, cherries, Grapes

// The following statement sorts using the optionsFlag parameter set to 
// Array.CASEINSENSITIVE | Array.DESCENDING.
cb.sortItemsOn("label", Array.CASEINSENSITIVE | Array.DESCENDING);
// resulting order: Grapes, cherries, Bananas, Apples

Im folgenden Beispiel wird eine ComboBox-Komponente erstellt und die Elemente mithilfe der Methode sortItemsOn() sortiert:

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({firstName:"Jane", lastName:"Doe"}); 
myComboBox.addItem({firstName:"Bill", lastName:"Smith"});
myComboBox.addItem({firstName:"Tim", lastName:"Jones"});
myComboBox.sortItemsOn("lastName", Array.CASEINSENSITIVE);
myComboBox.labelFunction = nameLabelFunction;
myComboBox.move(10, 10);
addChild(myComboBox);

function nameLabelFunction(item:Object):String {
    return item.lastName + ", " + item.firstName;
}
Ereignisdetail
change Ereignis
Ereignisobjekttyp: flash.events.Event
Event.type property = flash.events.Event.CHANGE

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Wird ausgelöst, wenn der Benutzer die Auswahl in der ComboBox-Komponente ändert oder im Textfeld einer bearbeitbaren ComboBox-Komponente eine Taste drückt.

Definiert den Wert der Eigenschaft type eines change-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas 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.
close Ereignis  
Ereignisobjekttyp: flash.events.Event
Event.type property = flash.events.Event.CLOSE

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Wird ausgelöst, wenn die Dropdown-Liste geschlossen wird.

Definiert den Wert der Eigenschaft type eines close-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Objekt, dessen Verbindung geschlossen wurde.

Beispiel

Im folgenden Beispiel wird eine ComboBox-Komponenteninstanz erstellt und die Sichtbarkeit des Dropdown-Menüs mithilfe der Methoden open() und close() umgeschaltet:

import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.OPEN, openHandler);
myComboBox.addEventListener(Event.CLOSE, closeHandler);
addChild(myComboBox);

var isOpen:Boolean = false;

var timer:Timer = new Timer(1000);
timer.addEventListener(TimerEvent.TIMER, timerHandler);
timer.start();

function openHandler(event:Event):void {
    isOpen = true;
}

function closeHandler(event:Event):void {
    isOpen = false;
}

function timerHandler(event:TimerEvent):void {
    if (isOpen) {
        myComboBox.close();
    } else {
        myComboBox.open();
    }
}

Siehe auch

enter Ereignis  
Ereignisobjekttyp: fl.events.ComponentEvent
ComponentEvent.type property = fl.events.ComponentEvent.ENTER

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Wird ausgelöst, wenn die Eigenschaft editable auf true gesetzt ist und der Benutzer während der Eingabe in das bearbeitbare Textfeld die Eingabetaste drückt.

Definiert den Wert der Eigenschaft type eines enter-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse; es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft currentTarget, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.
itemRollOut Ereignis  
Ereignisobjekttyp: fl.events.ListEvent
ListEvent.type property = fl.events.ListEvent.ITEM_ROLL_OUT

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Wird ausgelöst, wenn der Benutzer den Mauszeiger von einem Element in der Komponente wegbewegt.

Definiert den Wert der Eigenschaft type eines itemRollOut-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse; es gibt kein Standardverhalten, das abgebrochen werden kann.
columnIndexDie auf null basierende Indexposition der Spalte mit dem Renderer.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
indexDie auf null basierende Indexposition des DataProvider mit dem Renderer.
itemEin Verweis auf die zum Renderer gehörenden Daten.
rowIndexDie auf null basierende Indexposition der Zeile mit dem Renderer.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft currentTarget, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.

Siehe auch

itemRollOver Ereignis  
Ereignisobjekttyp: fl.events.ListEvent
ListEvent.type property = fl.events.ListEvent.ITEM_ROLL_OVER

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Wird ausgelöst, wenn der Benutzer den Mauszeiger zu einem Element in der Komponente bewegt.

Definiert den Wert der Eigenschaft type eines itemRollOver-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse; es gibt kein Standardverhalten, das abgebrochen werden kann.
columnIndexDie auf null basierende Indexposition der Spalte mit dem Renderer.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
indexDie auf null basierende Indexposition des DataProvider mit dem Renderer.
itemEin Verweis auf die zum Renderer gehörenden Daten.
rowIndexDie auf null basierende Indexposition der Zeile mit dem Renderer.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft currentTarget, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.

Beispiel

Im folgenden Beispiel wird eine ComboBox-Komponente erstellt, die geöffnet wird, wenn der Benutzer den Mauszeiger über die Komponenteninstanz führt.

import fl.controls.ComboBox;
import fl.controls.TextArea;
import fl.events.ListEvent;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.move(10, 10);
myComboBox.addEventListener(Event.OPEN, openHandler);
myComboBox.addEventListener(Event.CLOSE, closeHandler);
myComboBox.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myComboBox.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOutHandler);
myComboBox.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler);
myComboBox.addEventListener(MouseEvent.ROLL_OUT, rollOutHandler);
myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OVER, dropdownRollOverHandler)
myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OUT, dropdownRollOutHandler);
addChild(myComboBox);

var myTextArea:TextArea = new TextArea();
myTextArea.editable = false;
myTextArea.setSize(320, 240);
myTextArea.move(120, 10);
addChild(myTextArea);

function openHandler(event:Event):void {
    logEvent("ComboBox open");
}

function closeHandler(event:Event):void {
    logEvent("ComboBox close");
}

function itemRollOverHandler(event:ListEvent):void {
    var rowIdx:uint = event.rowIndex as uint;
    logEvent("ComboBox itemRollOver: " + "`" + myComboBox.getItemAt(rowIdx).label + "`");
}

function itemRollOutHandler(event:ListEvent):void {
    var rowIdx:uint = event.rowIndex as uint;
    logEvent("ComboBox itemRollOut: " + "`" + myComboBox.getItemAt(rowIdx).label + "`");
}

function rollOverHandler(event:MouseEvent):void {
    logEvent("ComboBox rollOver");
    myComboBox.open();
}

function rollOutHandler(event:MouseEvent):void {
    logEvent("ComboBox rollOut");
    myComboBox.close();
}

function dropdownRollOverHandler(event:MouseEvent):void {
    logEvent("ComboBox.dropdown rollOver");
    // reopen ComboBox after it gets closed by the ComboBox rollOut event
    myComboBox.open();
}

function dropdownRollOutHandler(event:MouseEvent):void {
    logEvent("ComboBox.dropdown rollOut");
    myComboBox.close();
}

function logEvent(text:String):void {
    myTextArea.appendText(text + "\n");
    myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition;
}

Siehe auch

open Ereignis  
Ereignisobjekttyp: flash.events.Event
Event.type property = flash.events.Event.OPEN

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Wird ausgelöst, wenn der Benutzer auf die Dropdown-Schaltfläche klickt, um die Dropdown-Liste einzublenden. Wird auch ausgelöst, wenn der Benutzer auf das Textfeld klickt, falls die ComboBox-Komponente nicht bearbeitet werden kann.

Definiert den Wert der Eigenschaft type eines open-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Netzwerkobjekt, über das eine Verbindung geöffnet wurde.

Beispiel

Im folgenden Beispiel wird eine Button-Komponente erstellt, die die Dropdownliste einer ComboBox-Komponente mithilfe der Methode open() öffnet. Wenn der Benutzer den Mauszeiger nicht über der ComboBox oder ihrem Dropdown-Menü platziert, schließt sich das Drowdown-Menü nach 1 Sekunde.

import fl.controls.Button;
import fl.controls.ComboBox;

var myComboBox:ComboBox = new ComboBox();
myComboBox.addItem({label:"Item 1"});
myComboBox.addItem({label:"Item 2"});
myComboBox.addItem({label:"Item 3"});
myComboBox.move(10, 10);
myComboBox.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler);
myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler);
myComboBox.dropdown.addEventListener(MouseEvent.ROLL_OUT, rollOutHandler);
addChild(myComboBox);

var myButton:Button = new Button();
myButton.emphasized = true;
myButton.label = "open ComboBox";
myButton.move(120, 10);
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myButton);

var closeTimer:Timer = new Timer(1000, 1);
closeTimer.addEventListener(TimerEvent.TIMER_COMPLETE, timerCompleteHandler);

function clickHandler(event:MouseEvent):void {
    myComboBox.open();
    closeTimer.reset();
    closeTimer.start();
}

function timerCompleteHandler(event:TimerEvent):void {
    myComboBox.close();
}

function rollOverHandler(event:MouseEvent):void {
    closeTimer.stop();
}

function rollOutHandler(event:MouseEvent):void {
    myComboBox.close();
}

Siehe auch

scroll Ereignis  
Ereignisobjekttyp: fl.events.ScrollEvent
ScrollEvent.type property = fl.events.ScrollEvent.SCROLL

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9.0.28.0

Wird ausgelöst, wenn der Benutzer in der Dropdownliste der ComboBox-Komponente einen Bildlauf durchführt.

Definiert den Wert der Eigenschaft type eines scroll-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse; es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
delta1; ein Wert, der das Ausmaß des Bildlaufs angibt.
directionvertical; die ScrollBar-Richtung.
position0; die Position des Bildlauffelds, nachdem es bewegt wurde.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft currentTarget, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.
Beispiele Verwendung von Beispielen
ComboBoxExample.as

Bei diesem Beispiel wird gezeigt, wie Sie einen Listener für die Ereignisse einer ComboxBox-Instanz verwenden.

Gehen Sie wie folgt vor, um das Beispiel auszuführen:

  1. Ziehen Sie eine ComboBox-Komponente auf die Bühne, und nennen Sie diese cb.
  2. Speichern Sie diesen Code unter "ComboBoxExample.as" im gleichen Verzeichnis wie die FLA-Datei.
  3. Geben Sie "ComboBoxExample" als Dokumentklasse in der FLA-Datei an.
package 
{
    import fl.controls.ComboBox;
    import flash.display.Sprite
    import flash.events.Event;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    
    public class ComboBoxExample extends Sprite
    {
        private var tf:TextField;
        
        public function ComboBoxExample() {
            setupComboBox();
            setupTextField();
        }

        private function setupTextField():void {
            tf = new TextField();
            tf.x = 230;
            tf.y = 15;
            tf.autoSize = TextFieldAutoSize.LEFT;
            addChild(tf);
        }

        private function setupComboBox():void {
            cb.setSize(200, 22);
            cb.prompt = "Select a Credit Card";
            cb.addItem( { label: "MasterCard", data:1 } );
            cb.addItem( { label: "Visa", data:2 } );
            cb.addItem( { label: "American Express", data:3 } );
            cb.addEventListener(Event.CHANGE, cardSelected);            
        }

        private function cardSelected(e:Event):void {
            tf.text = "You have selected: "
            tf.appendText(cb.selectedItem.label);
        }
    }
}




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/fl/controls/ComboBox.html