ISystemManager - Adobe ActionScript® 3 (AS3 Flex) API 参考

包	mx.managers
接口	public interface ISystemManager extends IEventDispatcher , IChildList , IFlexModuleFactory
实现器	SystemManager, WindowedSystemManager

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个 ISystemManager 管理一个“应用程序窗口”。桌面上或浏览器中运行的每个应用程序中都有一个区域用于显示应用程序的可视部分。该区域可能是操作系统中的某个窗口，也可能是浏览器中的某个区域。这是一个不同于 mx.core.Application 实例的“应用程序窗口”，该实例是应用程序中的“顶级”主窗口。

每个应用程序都有一个 ISystemManager。如果应用程序窗口的大小发生更改（您无法在应用程序中更改其大小，只能通过与操作系统窗口或浏览器交互来进行更改），则 ISystemManager 会发送一个事件。它是应用程序中所有可显示项目（例如 mx.core.Application 主实例以及所有弹出窗口、工具提示、光标等）的父项。任何以 ISystemManager 为父项的对象都将被视为“顶级”窗口，就连工具提示和光标也是如此。

如果显示有多个 IFocusManagerContainer，并且用户正在与 IFocusManagerContainers 中的组件进行交互，则 ISystemManager 还可以在各顶级窗口之间切换焦点。

所有未显式捕获的键盘和鼠标活动对 ISystemManager 都是可见的，因此，可以使用它来监视本应由您监视的活动。

在将某个应用程序加载到另一个应用程序时，虽然仍会创建 ISystemManager，但是根据安全性和域规则，将不会使用它来管理“应用程序窗口”；而将作为加载它的 Loader 的 content，只是充当子应用程序的父级。

ISystemManager 可维护多个子项列表，工具提示、光标、弹出窗口各有一个列表。因此，它可以确保弹出窗口“浮”在主应用程序窗口上方，工具提示“浮”在弹出窗口上方，光标“浮”在工具提示上方。若要对 ISystemManager 检查 numChildren 属性或 getChildAt() 方法，则需要访问主应用程序窗口以及其他任何没有弹出的窗口。要获得所有窗口（包括弹出窗口、工具提示和光标）的列表，请使用 rawChildren 属性。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		allowDomainsInNewRSLs : Boolean 控制调用 allowDomain() 所允许的域是否也被调用后加载的 RSL 允许。	IFlexModuleFactory
		allowInsecureDomainsInNewRSLs : Boolean 控制调用 allowInsecureDomain() 所允许的域是否也被调用后加载的 RSL 允许。	IFlexModuleFactory
		cursorChildren : IChildList [只读] 使用此 ISystemManager 作为父项的自定义光标的列表。	ISystemManager
		document : Object 对文档对象的引用。	ISystemManager
		focusPane : Sprite 在各组件之间共享的单个 Sprite，用作绘图焦点的叠加层。	ISystemManager
		isProxy : Boolean [只读] 如果 ISystemManager 是代理而不是根类，则为 true。	ISystemManager
		loaderInfo : LoaderInfo [只读] 提供应用程序相关信息的 LoaderInfo 对象。	ISystemManager
		numChildren : int [只读] 此子级列表中的子项数。	IChildList
		numModalWindows : int 模式窗口的数量。	ISystemManager
		popUpChildren : IChildList [只读] 将使用此 ISystemManager 作为父项的最顶级窗口（弹出窗口）的列表。	ISystemManager
		preloadedRSLs : Dictionary [只读] 启动应用程序之前该 SystemManager 或 FlexModuleFactory 加载的 RSL。	IFlexModuleFactory
		rawChildren : IChildList [只读] 使用此 ISystemManager 作为父项的所有子项的列表。	ISystemManager
		screen : Rectangle [只读] 应用程序窗口的大小和位置。	ISystemManager
		stage : Stage [只读] 代表映射到此 SystemManager 中的应用程序窗口的 flash.display.Stage。	ISystemManager
		toolTipChildren : IChildList [只读] 将使用此 ISystemManager 作为父项的工具提示的列表。	ISystemManager
		topLevelSystemManager : ISystemManager [只读] 负责应用程序窗口的 ISystemManager。	ISystemManager

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		addChild(child:DisplayObject):DisplayObject 在此子项列表的末尾添加一个子 DisplayObject。	IChildList
		addChildAt(child:DisplayObject, index:int):DisplayObject 在此子级列表的指定索引处添加子 DisplayObject。	IChildList
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	IEventDispatcher
		addPreloadedRSL(loaderInfo:LoaderInfo, rsl:Vector.<RSLData>):void 将 RSL 添加到 preloadedRSLs 列表。	IFlexModuleFactory
		allowDomain(... domains):void 为与此 IFlexModuleFactory 关联的 SWF 以及与此 IFlexModuleFactory 预加载的 RSL 关联的所有 SWF 调用 Security.allowDomain() 方法。	IFlexModuleFactory
		allowInsecureDomain(... domains):void 为与此 IFlexModuleFactory 关联的 SWF 以及与此 IFlexModuleFactory 预加载的 RSL 关联的所有 SWF 调用 Security.allowInsecureDomain() 方法。	IFlexModuleFactory
		callInContext(fn:Function, thisArg:Object, argArray:Array, returns:Boolean = true):* 一种用于调用 IFlexModuleFactory 上下文中的方法的方法。	IFlexModuleFactory
		contains(child:DisplayObject):Boolean 确定 DisplayObject 是否在此子级列表中，或是否为此子级列表中的子项的后代。	IChildList
		create(... parameters):Object factory 方法，要求定义的实例是模块已知的。	IFlexModuleFactory
		deployMouseShields(deploy:Boolean):void 部署或删除鼠标盾。	ISystemManager
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	IEventDispatcher
		getChildAt(index:int):DisplayObject 获取此子级列表中指定索引处的子 DisplayObject。	IChildList
		getChildByName(name:String):DisplayObject 获取此子级列表中具有指定名称的子 DisplayObject。	IChildList
		getChildIndex(child:DisplayObject):int 获取此子级列表中特定子项的索引。	IChildList
		getDefinitionByName(name:String):Object 将给定的 String 转换为 Class 或数据包级的 Function。	ISystemManager
		getImplementation(interfaceName:String):Object 获取接口的实现。	IFlexModuleFactory
		getObjectsUnderPoint(point:Point):Array 返回位于子级列表中指定点下方的 DisplayObject 的数组。	IChildList
		getSandboxRoot():DisplayObject 获取此 SecurityDomain 中所有顶级系统管理器的根系统管理器。	ISystemManager
		getTopLevelRoot():DisplayObject 尝试获取位于主应用程序中的系统管理器。	ISystemManager
		getVisibleApplicationRect(bounds:Rectangle = null, skipToSandboxRoot:Boolean = false):Rectangle 获取所加载的应用程序在屏幕上对用户可见的范围。	ISystemManager
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	IEventDispatcher
		info():Object 返回包含模块已知的静态数据的键/值对块。	IFlexModuleFactory
		invalidateParentSizeAndDisplayList():void 尝试通知父 SWFLoader 应用程序的大小可能已更改。	ISystemManager
		isFontFaceEmbedded(tf:flash.text:TextFormat):Boolean 如果所需的字体已嵌入到此应用程序中，或已使用 Font.registerFont() 方法进行了全局注册，则返回 true。	ISystemManager
		isTopLevel():Boolean 如果此 ISystemManager 负责应用程序窗口，则返回 true；如果此应用程序已加载到其他应用程序中，则返回 false。	ISystemManager
		isTopLevelRoot():Boolean 测试此系统管理器是否为所有顶级系统管理器的根。	ISystemManager
		registerImplementation(interfaceName:String, impl:Object):void 注册接口的实现。	IFlexModuleFactory
		removeChild(child:DisplayObject):DisplayObject 从此子级列表中删除指定的子 DisplayObject。	IChildList
		removeChildAt(index:int):DisplayObject 从此子级列表中删除指定索引处的子 DisplayObject。	IChildList
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	IEventDispatcher
		setChildIndex(child:DisplayObject, newIndex:int):void 更改此子级列表中特定子项的索引。	IChildList
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	IEventDispatcher

属性详细信息

cursorChildren

属性

cursorChildren:IChildList [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

使用此 ISystemManager 作为父项的自定义光标的列表。

ISystemManager 包含各种类型的子项，例如应用程序、弹出窗口、顶级窗口、工具提示和自定义光标。您可以通过 cursorChildren 属性访问自定义光标。

IChildList 对象具有类似于 getChildAt() 的方法和类似于 numChildren 的属性。例如，cursorChildren.numChildren 可提供自定义光标数目（可以是 0，也可以是 1）；如果存在自定义光标，您可以将其当作 cursorChildren.getChildAt(0) 进行访问。

实现
public function get cursorChildren():IChildList

document

属性

document:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

对文档对象的引用。文档对象是位于 Flex 应用程序、MXML 组件或 AS 组件层次结构顶层的 Object。

实现
public function get document():Object
public function set document(value:Object):void

focusPane

属性

focusPane:Sprite

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在各组件之间共享的单个 Sprite，用作绘图焦点的叠加层。如果您有具有焦点的子项组件，则可以共享它；如果您是 IFocusManagerComponent，则不能共享它。

实现
public function get focusPane():Sprite
public function set focusPane(value:Sprite):void

isProxy

属性

isProxy:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果 ISystemManager 是代理而不是根类，则为 true。

实现
public function get isProxy():Boolean

loaderInfo

属性

loaderInfo:LoaderInfo [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

提供应用程序相关信息的 LoaderInfo 对象。

实现
public function get loaderInfo():LoaderInfo

numModalWindows

属性

numModalWindows:int

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

模式窗口的数量。

模式窗口不允许在其他窗口中单击，因为这通常会激活该窗口中的 FocusManager。PopUpManager 在创建和破坏模式窗口时会修改此计数。

实现
public function get numModalWindows():int
public function set numModalWindows(value:int):void

popUpChildren

属性

popUpChildren:IChildList [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将使用此 ISystemManager 作为父项的最顶级窗口（弹出窗口）的列表。

ISystemManager 包含各种类型的子项，例如应用程序、弹出窗口、工具提示和自定义光标。您可以通过 popUpChildren 属性访问最顶级窗口。

IChildList 对象具有类似于 getChildAt() 的方法和类似于 numChildren 的属性。例如，popUpChildren.numChildren 可提供最顶部窗口的数量，您可将最顶部窗口当作 popUpChildren.getChildAt(i) 进行访问。

实现
public function get popUpChildren():IChildList

rawChildren

属性

rawChildren:IChildList [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

使用此 ISystemManager 作为父项的所有子项的列表。

ISystemManager 包含各种类型的子项，例如应用程序、弹出窗口、工具提示和自定义光标。

IChildList 对象具有类似于 getChildAt() 的方法和类似于 numChildren 的属性。

实现
public function get rawChildren():IChildList

screen

属性

screen:Rectangle [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

应用程序窗口的大小和位置。Rectangle 对象包含 x、y、width 和 height 属性。矩形位于沙箱根坐标中。

实现
public function get screen():Rectangle

stage

属性

stage:Stage [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

代表映射到此 SystemManager 中的应用程序窗口的 flash.display.Stage。

实现
public function get stage():Stage

toolTipChildren

属性

toolTipChildren:IChildList [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将使用此 ISystemManager 作为父项的工具提示的列表。

ISystemManager 包含各种类型的子项，例如应用程序、弹出窗口、最顶部窗口、工具提示和自定义光标。

IChildList 对象具有类似于 getChildAt() 的方法和类似于 numChildren 的属性。例如，toolTipChildren.numChildren 可提供工具提示数目（可以是 0，也可以是 1）；如果存在工具提示，您可以将其当作 toolTipChildren.getChildAt(0) 进行访问。

实现
public function get toolTipChildren():IChildList

topLevelSystemManager

属性

topLevelSystemManager:ISystemManager [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

负责应用程序窗口的 ISystemManager。只要此应用程序尚未加载到其它应用程序中，这就是同一个 ISystemManager。

实现
public function get topLevelSystemManager():ISystemManager

方法详细信息

deployMouseShields

()

方法

public function deployMouseShields(deploy:Boolean):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

部署或删除鼠标盾。鼠标盾可以阻止不受信任的应用程序获得鼠标输入。之所以需要阻止鼠标输入，是因为在不受信任的应用程序上拖动时，一般不会收到任何鼠标移动事件。出于安全考虑，Flash Player 在穿越受信任/不受信任的边界时不发送事件。通过用鼠标盾（假设您是其父级）遮盖不受信任的应用程序，可以得到鼠标移动消息，而拖动操作可以发挥预期的作用。

参数

deploy:Boolean — true 将部署鼠标盾，false 将删除鼠标盾。

getDefinitionByName

()

方法

public function getDefinitionByName(name:String):Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将给定的 String 转换为 Class 或数据包级的 Function。根据是否加载到其他应用程序来调用适当的 ApplicationDomain.getDefinition() 方法。

参数

name:String — 类名称，例如“mx.video.VideoManager”。

Object — 使用 name 或 null 表示的 Class。

getSandboxRoot

()

方法

public function getSandboxRoot():DisplayObject

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

获取此 SecurityDomain 中所有顶级系统管理器的根系统管理器。

DisplayObject — 沙箱中最高等级的 systemManager

getTopLevelRoot

()

方法

public function getTopLevelRoot():DisplayObject

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

尝试获取位于主应用程序中的系统管理器。

DisplayObject — 如果安全限制允许，则为主应用程序的 systemManager；如果它位于不同的 SecurityDomain 中，则为 null。

getVisibleApplicationRect

()

方法

public function getVisibleApplicationRect(bounds:Rectangle = null, skipToSandboxRoot:Boolean = false):Rectangle

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

获取所加载的应用程序在屏幕上对用户可见的范围。

参数

	`bounds:Rectangle` (default = `null`) — 可选。可见矩形的起始边界。边界采用全局坐标。如果 `bounds` 为 null，则起始边界由系统管理器的 `screen` 属性定义。

	`skipToSandboxRoot:Boolean` (default = `false`)

Rectangle — 包括此对象可见部分的 Rectangle。该矩形采用全局坐标。

invalidateParentSizeAndDisplayList

()

方法

public function invalidateParentSizeAndDisplayList():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

尝试通知父 SWFLoader 应用程序的大小可能已更改。

isFontFaceEmbedded

()

方法

public function isFontFaceEmbedded(tf:flash.text:TextFormat):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果所需的字体已嵌入到此应用程序中，或已使用 Font.registerFont() 方法进行了全局注册，则返回 true。

参数

tf:flash.text:TextFormat — 提供字符格式设置信息的 TextFormat 类。

Boolean — 如果所需的字体已嵌入到此应用程序中，或已使用 Font.registerFont() 方法进行了全局注册，则返回 true。

isTopLevel

()

方法

public function isTopLevel():Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果此 ISystemManager 负责应用程序窗口，则返回 true；如果此应用程序已加载到其他应用程序中，则返回 false。

Boolean — 如果此 ISystemManager 负责应用程序窗口，则返回 true。

isTopLevelRoot

()

方法

public function isTopLevelRoot():Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

测试此系统管理器是否为所有顶级系统管理器的根。

Boolean — 如果此 SystemManager 是显示列表上所有 SystemManager 的根，则为 true；否则为 false。

法律声明 | 在线隐私策略

ISystemManager - AS3 Flex

包x

语言元素

附录

包 mx.managers

cursorChildren

document

focusPane

isProxy

loaderInfo

numModalWindows

popUpChildren

rawChildren

screen

stage

toolTipChildren

topLevelSystemManager

deployMouseShields

getDefinitionByName

getSandboxRoot

getTopLevelRoot

getVisibleApplicationRect

invalidateParentSizeAndDisplayList

isFontFaceEmbedded

isTopLevel

isTopLevelRoot