ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.managers 

PopUpManager  - AS3 Flex

Paketmx.managers
Klassepublic class PopUpManager
VererbungPopUpManager Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die PopUpManager-Singleton-Klasse erstellt neue Fenster auf oberster Ebene und platziert oder entfernt diese Fenster von der Ebene über allen anderen sichtbaren Fenster. Eine Beschreibung der Ebenenanordnung finden Sie im Abschnitt zum SystemManager. Sie wird für Popup-Dialogfelder, Menüs und Dropdownlisten in dem Combobox-Steuerelement und ähnlichen Komponenten verwendet.

Der PopUpManager bietet auch Modalität. Fenster unter einem Popup können beispielsweise keine Mausereignisse erhalten und wenn der Benutzer mit der Maus außerhalb des Fensters klickt, wird ein Ereignis ausgelöst. Der Entwickler hat dabei die Auswahl zwischen dem Schließen des Fensters oder einer Warnungsmeldung.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
Öffentliche Methoden
 MethodeDefiniert von
  
addPopUp(window:IFlexDisplayObject, parent:DisplayObject, modal:Boolean = false, childList:String = null, moduleFactory:IFlexModuleFactory = null):void
[statisch] Blendet ein Fenster auf oberster Ebene ein.
PopUpManager
  
[statisch] Stellt sicher, dass ein Popupfenster über anderen Objekten in der Liste der untergeordneten Elemente steht. Der SystemManager führt dies automatisch aus, wenn das Popup ein Fenster auf oberster Ebene ist und Rollover erfolgt. In allen anderen Fällen müssen Sie selbst dafür sorgen.
PopUpManager
  
[statisch] Zentriert ein Popupfenster über dem Fenster, das zum Aufrufen der createPopUp()- oder addPopUp()-Methode verwendet wurde.
PopUpManager
  
createPopUp(parent:DisplayObject, className:Class, modal:Boolean = false, childList:String = null, moduleFactory:IFlexModuleFactory = null):IFlexDisplayObject
[statisch] Erstellt ein Fenster auf oberster Ebene und platziert darüber andere Fenster in der z-Reihenfolge.
PopUpManager
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
[statisch] Entfernt ein Popupfenster, das von der createPopUp()- oder addPopUp()-Methode erstellt wurde.
PopUpManager
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Methodendetails

addPopUp

()Methode
public static function addPopUp(window:IFlexDisplayObject, parent:DisplayObject, modal:Boolean = false, childList:String = null, moduleFactory:IFlexModuleFactory = null):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Blendet ein Fenster auf oberster Ebene ein. Es ist empfehlenswert removePopUp() aufzurufen, um Popups zu entfernen, die mit der addPopUp()-Methode erstellt wurden. Implementiert die Klasse den IFocusManagerContainer, dann hat das Fenster einen eigenen FocusManager. Wenn der Benutzer also die Tabulatortaste verwendet, um zwischen den Steuerelementen zu navigieren, wird nur auf die Steuerelemente im Fenster zugegriffen.

Beispiel

var tw:TitleWindow = new TitleWindow();
        tw.title = "My Title";
        mx.managers.PopUpManager.addPopUp(tw, pnl, false);

Erstellt ein Popupfenster mit der tw-Instanz der TitleWindow-Klasse und pnl als Sprite, um die Position des Popup zu bestimmen. Ist als nicht modales Fenster definiert.

Parameter

window:IFlexDisplayObject — Das einzublendende IFlexDisplayObject.
 
parent:DisplayObject — DisplayObject, mit dem festgelegt wird, welche SystemManager-Ebenen verwendet werden und optional der Referenzpunkt zum Zentrieren des neuen Fensters auf oberster Ebene. Es muss sich nicht um das übergeordnete Element des Popup handeln, da der SystemManager allen Popups übergeordnet ist.
 
modal:Boolean (default = false) — Bei true ist das Fenster modal. Das bedeutet, dass der Benutzer erst mit anderen Popups interagieren kann, nachdem das Fenster geschlossen wurde.
 
childList:String (default = null) — Die Liste der untergeordneten Elemente, der das Popup hinzugefügt werden soll. Entweder PopUpManagerChildList.APPLICATION, PopUpManagerChildList.POPUP oder PopUpManagerChildList.PARENT (Standard).
 
moduleFactory:IFlexModuleFactory (default = null) — Die moduleFactory, in der dieses Popup nach eingebetteten Schriftarten und dem Stilmanager suchen muss.

Verwandte API-Elemente

bringToFront

()Methode 
public static function bringToFront(popUp:IFlexDisplayObject):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Stellt sicher, dass ein Popupfenster über anderen Objekten in der Liste der untergeordneten Elemente steht. Der SystemManager führt dies automatisch aus, wenn das Popup ein Fenster auf oberster Ebene ist und Rollover erfolgt. In allen anderen Fällen müssen Sie selbst dafür sorgen.

Parameter

popUp:IFlexDisplayObject — IFlexDisplayObject, das das Popup darstellt.

centerPopUp

()Methode 
public static function centerPopUp(popUp:IFlexDisplayObject):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zentriert ein Popupfenster über dem Fenster, das zum Aufrufen der createPopUp()- oder addPopUp()-Methode verwendet wurde.

Beachten Sie, dass sich die Position des Popupfensters möglicherweise nicht sofort nach diesem Aufruf ändert, da Flex auf die Messung und das Layout des Popupfensters wartet.

Parameter

popUp:IFlexDisplayObject — IFlexDisplayObject, das das Popup darstellt.

createPopUp

()Methode 
public static function createPopUp(parent:DisplayObject, className:Class, modal:Boolean = false, childList:String = null, moduleFactory:IFlexModuleFactory = null):IFlexDisplayObject

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Erstellt ein Fenster auf oberster Ebene und platziert darüber andere Fenster in der z-Reihenfolge. Es ist empfehlenswert removePopUp() aufzurufen, um Popups zu entfernen, die mit der createPopUp-Methode erstellt wurden. Implementiert die Klasse den IFocusManagerContainer, dann hat das Fenster einen eigenen FocusManager. Wenn der Benutzer also die Tabulatortaste verwendet, um zwischen den Steuerelementen zu navigieren, wird nur auf die Steuerelemente im Fenster zugegriffen.

Beispiel

pop = mx.managers.PopUpManager.createPopUp(pnl, TitleWindow, false); 

Erstellt ein Popupfenster auf der Basis der TitleWindow-Klasse und durch Verwendung von pnl als MovieClip, um die Position des Popup zu bestimmen. Wird als nicht modales Fenster definiert. Das heißt, dass andere Fenster Mausereignisse enthalten können.

Parameter

parent:DisplayObject — DisplayObject, mit dem festgelegt wird, welche SystemManager-Ebenen verwendet werden und optional der Referenzpunkt zum Zentrieren des neuen Fensters auf oberster Ebene. Es muss sich nicht um das übergeordnete Element des Popup handeln, da der SystemManager allen Popups übergeordnet ist.
 
className:Class — Objektklasse, die für das Popup erstellt werden soll. Die Klasse muss IFlexDisplayObject implementieren.
 
modal:Boolean (default = false) — Bei true ist das Fenster modal. Das bedeutet, dass der Benutzer erst mit anderen Popups interagieren kann, nachdem das Fenster geschlossen wurde.
 
childList:String (default = null) — Die Liste der untergeordneten Elemente, der das Popup hinzugefügt werden soll. Entweder PopUpManagerChildList.APPLICATION, PopUpManagerChildList.POPUP oder PopUpManagerChildList.PARENT (Standard).
 
moduleFactory:IFlexModuleFactory (default = null) — Die moduleFactory, in der dieses Popup nach eingebetteten Schriftarten und dem Stilmanager suchen muss.

Rückgabewerte
IFlexDisplayObject — Verweis auf das neue Fenster auf oberster Ebene.

Verwandte API-Elemente

removePopUp

()Methode 
public static function removePopUp(popUp:IFlexDisplayObject):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Entfernt ein Popupfenster, das von der createPopUp()- oder addPopUp()-Methode erstellt wurde.

Parameter

popUp:IFlexDisplayObject — Das IFlexDisplayObject, von dem das Popupfenster dargestellt wird.





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.