包 | 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。 |