| 包 | mx.managers |
| 类 | public class PopUpManager |
| 继承 | PopUpManager Object |
PopUpManager 还可以提供模态,使弹出窗口下方的窗口无法接收鼠标事件;当用户在窗口外部单击鼠标时,它还可以提供一个事件,供开发人员选择退出窗口还是警告用户。
另请参见
| 方法 | 定义方 | ||
|---|---|---|---|
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 | ||
![]() |
指示对象是否已经定义了指定的属性。 | Object | |
![]() |
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
![]() |
指示指定的属性是否存在、是否可枚举。 | Object | |
[静态] 删除由 createPopUp() 或 addPopUp() 方法弹出的弹出窗口。 | PopUpManager | ||
![]() |
设置循环操作动态属性的可用性。 | Object | |
![]() |
返回指定对象的字符串表示形式。 | Object | |
![]() |
返回指定对象的原始值。 | 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.APPLICATION、PopUpManagerChildList.POPUP 或 PopUpManagerChildList.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.APPLICATION、PopUpManagerChildList.POPUP 或 PopUpManagerChildList.PARENT(默认)中的任意一项。
|
IFlexDisplayObject — 对新的顶级窗口的引用。 |
另请参见
| removePopUp | () | 方法 |
public static function removePopUp(popUp:IFlexDisplayObject):void
删除由 createPopUp() 或 addPopUp() 方法弹出的弹出窗口。
参数
popUp:IFlexDisplayObject — 表示弹出窗口的 IFlexDisplayObject。 |