用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
mx.managers 

PopUpManager  - AS3 Flex

mx.managers
public class PopUpManager
继承PopUpManager Inheritance Object

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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

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

相关 API 元素



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

addPopUp

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

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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

示例

var tw:TitleWindow = 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(默认)中的任意一项。
 
moduleFactory:IFlexModuleFactory (default = null) — 此弹出窗口应在其中查找其嵌入字体和样式管理器的 moduleFactory。

相关 API 元素

bringToFront

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

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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

参数

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

centerPopUp

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

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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

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

参数

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

createPopUp

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

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

创建一个顶级窗口,并按 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(默认)中的任意一项。
 
moduleFactory:IFlexModuleFactory (default = null) — 此弹出窗口应在其中查找其嵌入字体和样式管理器的 moduleFactory。

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

相关 API 元素

removePopUp

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

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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

参数

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





[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。