Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: Recupero dati dal server...
Recupero dati dal server...
mx.managers 

PopUpManager  - AS3 Flex

Pacchettomx.managers
Classepublic class PopUpManager
EreditarietàPopUpManager Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

The PopUpManager singleton class creates new top-level windows and places or removes those windows from the layer on top of all other visible windows. See the SystemManager for a description of the layering. It is used for popup dialogs, menus, and dropdowns in the ComboBox control and in similar components.

The PopUpManager also provides modality, so that windows below the popup cannot receive mouse events, and also provides an event if the user clicks the mouse outside the window so the developer can choose to dismiss the window or warn the user.

Altri esempi

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
Metodi pubblici
 MetodoDefinito da
  
addPopUp(window:IFlexDisplayObject, parent:DisplayObject, modal:Boolean = false, childList:String = null, moduleFactory:IFlexModuleFactory = null):void
[statico] Pops up a top-level window.
PopUpManager
  
[statico] Makes sure a popup window is higher than other objects in its child list The SystemManager does this automatically if the popup is a top level window and is moused on, but otherwise you have to take care of this yourself.
PopUpManager
  
[statico] Centers a popup window over whatever window was used in the call to the createPopUp() or addPopUp() method.
PopUpManager
  
createPopUp(parent:DisplayObject, className:Class, modal:Boolean = false, childList:String = null, moduleFactory:IFlexModuleFactory = null):IFlexDisplayObject
[statico] Creates a top-level window and places it above other windows in the z-order.
PopUpManager
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
  
[statico] Removes a popup window popped up by the createPopUp() or addPopUp() method.
PopUpManager
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione dei metodi

addPopUp

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

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Pops up a top-level window. It is good practice to call removePopUp() to remove popups created by using the addPopUp() method. If the class implements IFocusManagerContainer, the window will have its own FocusManager so that, if the user uses the TAB key to navigate between controls, only the controls in the window will be accessed.

Example

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

Creates a popup window using the tw instance of the TitleWindow class and pnl as the Sprite for determining where to place the popup. It is defined to be a non-modal window.

Parametri

window:IFlexDisplayObject — The IFlexDisplayObject to be popped up.
 
parent:DisplayObject — DisplayObject to be used for determining which SystemManager's layers to use and optionally the reference point for centering the new top level window. It may not be the actual parent of the popup as all popups are parented by the SystemManager.
 
modal:Boolean (default = false) — If true, the window is modal which means that the user will not be able to interact with other popups until the window is removed.
 
childList:String (default = null) — The child list in which to add the pop-up. One of PopUpManagerChildList.APPLICATION, PopUpManagerChildList.POPUP, or PopUpManagerChildList.PARENT (default).
 
moduleFactory:IFlexModuleFactory (default = null) — The moduleFactory where this pop-up should look for its embedded fonts and style manager.

Elementi API correlati

bringToFront

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

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Makes sure a popup window is higher than other objects in its child list The SystemManager does this automatically if the popup is a top level window and is moused on, but otherwise you have to take care of this yourself.

Parametri

popUp:IFlexDisplayObject — IFlexDisplayObject representing the popup.

centerPopUp

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

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Centers a popup window over whatever window was used in the call to the createPopUp() or addPopUp() method.

Note that the position of the popup window may not change immediately after this call since Flex may wait to measure and layout the popup window before centering it.

Parametri

popUp:IFlexDisplayObject — IFlexDisplayObject representing the popup.

createPopUp

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

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Creates a top-level window and places it above other windows in the z-order. It is good practice to call the removePopUp() method to remove popups created by using the createPopUp() method. If the class implements IFocusManagerContainer, the window will have its own FocusManager so that, if the user uses the TAB key to navigate between controls, only the controls in the window will be accessed.

Example

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

Creates a popup window based on the TitleWindow class, using pnl as the MovieClip for determining where to place the popup. It is defined to be a non-modal window meaning that other windows can receive mouse events

Parametri

parent:DisplayObject — DisplayObject to be used for determining which SystemManager's layers to use and optionally the reference point for centering the new top level window. It may not be the actual parent of the popup as all popups are parented by the SystemManager.
 
className:Class — Class of object that is to be created for the popup. The class must implement IFlexDisplayObject.
 
modal:Boolean (default = false) — If true, the window is modal which means that the user will not be able to interact with other popups until the window is removed.
 
childList:String (default = null) — The child list in which to add the popup. One of PopUpManagerChildList.APPLICATION, PopUpManagerChildList.POPUP, or PopUpManagerChildList.PARENT (default).
 
moduleFactory:IFlexModuleFactory (default = null) — The moduleFactory where this pop-up should look for its embedded fonts and style manager.

Restituisce
IFlexDisplayObject — Reference to new top-level window.

Elementi API correlati

removePopUp

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

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Removes a popup window popped up by the createPopUp() or addPopUp() method.

Parametri

popUp:IFlexDisplayObject — The IFlexDisplayObject representing the popup window.





[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.