mx.managers
public class PopUpManager
继承PopUpManager Inheritance Object

PopUpManager singleton 类用于创建新的顶级窗口,还可以在位于所有其它可见窗口上面的层次中放置或删除这些窗口。有关分层的说明,请参见 SystemManager。此类适用于 ComboBox 控件中的弹出对话框、菜单和下拉列表等类似组件。

PopUpManager 还可以提供模态,使弹出窗口下方的窗口无法接收鼠标事件;当用户在窗口外部单击鼠标时,它还可以提供一个事件,供开发人员选择退出窗口还是警告用户。

另请参见

PopUpManagerChildList
TitleWindow layout container


公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
公共方法
 方法定义方
  
addPopUp(window:IFlexDisplayObject, parent:DisplayObject, modal:Boolean = false, childList:String = null):void
[静态] 弹出顶级窗口。
PopUpManager
  
[静态] 请确保弹出窗口高于其子项列表中的其它对象。如果该弹出窗口是顶级窗口并且位于鼠标下,则 SystemManager 会自动将其设置为满足此要求;否则,您必须自行处理。
PopUpManager
  
[静态] 使位于调用 createPopUp() 或 addPopUp() 方法期间使用的任何窗口上面的弹出窗口居中显示。
PopUpManager
  
createPopUp(parent:DisplayObject, className:Class, modal:Boolean = false, childList:String = null):IFlexDisplayObject
[静态] 创建一个顶级窗口,并按 z 轴顺序将其置于其它窗口上方。
PopUpManager
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
  
[静态] 删除由 createPopUp() 或 addPopUp() 方法弹出的弹出窗口。
PopUpManager
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
方法详细信息
addPopUp()方法
public static function addPopUp(window:IFlexDisplayObject, parent:DisplayObject, modal:Boolean = false, childList:String = null):void

弹出顶级窗口。最好调用 removePopUp() 来删除使用 addPopUp() 方法创建的弹出窗口。如果该类实现了 IFocusManagerContainer,则该窗口将拥有自己的 FocusManager;因此,当用户使用 Tab 键在各个控件之间导航时,将只能访问此窗口中的控件。

示例

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

使用 TitleWindow 类的 tw 实例创建一个弹出窗口,并使用 pnl 作为 Sprite 来确定放置此弹出窗口的位置。此窗口将定义为非模态窗口。

参数

window:IFlexDisplayObject — 要弹出的 IFlexDisplayObject。
 
parent:DisplayObject — DisplayObject,用于确定要使用 SystemManager 的哪些层,以及(可选)确定居中新的顶级窗口所用的参考点。它可能并非弹出窗口的实际父项,因为所有弹出窗口都以 SystemManager 为父项。
 
modal:Boolean (default = false) — 如果为 true,则该窗口为模态窗口,也就是说在删除该窗口之前,用户将无法与其它弹出窗口交互。
 
childList:String (default = null) — 要将弹出窗口添加到其中的子项列表。PopUpManagerChildList.APPLICATIONPopUpManagerChildList.POPUPPopUpManagerChildList.PARENT(默认)中的任意一项。

另请参见

bringToFront()方法 
public static function bringToFront(popUp:IFlexDisplayObject):void

请确保弹出窗口高于其子项列表中的其它对象。如果该弹出窗口是顶级窗口并且位于鼠标下,则 SystemManager 会自动将其设置为满足此要求;否则,您必须自行处理。

参数

popUp:IFlexDisplayObject — 表示弹出窗口的 IFlexDisplayObject。

centerPopUp()方法 
public static function centerPopUp(popUp:IFlexDisplayObject):void

使位于调用 createPopUp()addPopUp() 方法期间使用的任何窗口上面的弹出窗口居中显示。

请注意,由于 Flex 可能会在居中弹出窗口前对其进行测量和布局,因此弹出窗口的位置可能不会在完成此调用后立即更改。

参数

popUp:IFlexDisplayObject — 表示弹出窗口的 IFlexDisplayObject。

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

创建一个顶级窗口,并按 z 轴顺序将其置于其它窗口上方。最好调用 removePopUp() 方法来删除使用 createPopUp() 方法创建的弹出窗口。如果该类实现了 IFocusManagerContainer,则该窗口将拥有自己的 FocusManager;因此,当用户使用 Tab 键在各个控件之间导航时,将只能访问此窗口中的控件。

示例

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

基于 TitleWindow 类创建一个弹出窗口,并使用 pnl 作为 MovieClip 来确定放置此弹出窗口的位置。此窗口将定义为非模态窗口,即其它窗口也可以接收鼠标事件

参数

parent:DisplayObject — DisplayObject,用于确定要使用 SystemManager 的哪些层,以及(可选)确定居中新的顶级窗口所用的参考点。它可能并非弹出窗口的实际父项,因为所有弹出窗口都以 SystemManager 为父项。
 
className:Class — 要为弹出窗口创建的对象的类。该类必须实现 IFlexDisplayObject。
 
modal:Boolean (default = false) — 如果为 true,则该窗口为模态窗口,也就是说在删除该窗口之前,用户将无法与其它弹出窗口交互。
 
childList:String (default = null) — 要将弹出窗口添加到的子项列表。PopUpManagerChildList.APPLICATIONPopUpManagerChildList.POPUPPopUpManagerChildList.PARENT(默认)中的任意一项。

返回
IFlexDisplayObject — 对新的顶级窗口的引用。

另请参见

removePopUp()方法 
public static function removePopUp(popUp:IFlexDisplayObject):void

删除由 createPopUp()addPopUp() 方法弹出的弹出窗口。

参数

popUp:IFlexDisplayObject — 表示弹出窗口的 IFlexDisplayObject。