| 套件 | mx.managers |
| 介面 | public interface ISystemManager extends IEventDispatcher , IChildList , IFlexModuleFactory |
| 實作者 | SystemManager, WindowedSystemManager |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
mx.core.Application, which
is the main "top-level" window within an application.
Every application has an ISystemManager. The ISystemManager sends an event if the size of the application window changes (you cannot change it from within the application, but only through interaction with the operating system window or browser). It parents all displayable items within the application, such as the main mx.core.Application instance and all popups, tooltips, cursors, an so on. Any object parented by the ISystemManager is considered to be a "top-level" window, even tooltips and cursors.
The ISystemManager also switches focus between top-level windows if there are more than one IFocusManagerContainer displayed and users are interacting with components within the IFocusManagerContainers.
All keyboard and mouse activity that is not expressly trapped is seen by the ISystemManager, making it a good place to monitor activity should you need to do so.
If an application is loaded into another application, an ISystemManager
will still be created, but will not manage an "application window",
depending on security and domain rules.
Instead, it will be the content of the Loader
that loaded it and simply serve as the parent of the sub-application
The ISystemManager maintains multiple lists of children, one each for
tooltips, cursors, popup windows.
This is how it ensures that popup windows "float" above the main
application windows and that tooltips "float" above that
and cursors above that.
If you examine the numChildren property
or getChildAt() method on the ISystemManager
you are accessing the main application window and any other windows
that aren't popped up.
To get the list of all windows, including popups, tooltips and cursors,
use the rawChildren property.
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | allowDomainsInNewRSLs : Boolean
Controls whether the domains allowed by calls to allowDomain()
are also allowed by RSLs loaded after the call. | IFlexModuleFactory | |
| allowInsecureDomainsInNewRSLs : Boolean
Controls whether the domains allowed by calls to allowInsecureDomain()
are also allowed by RSLs loaded after the call. | IFlexModuleFactory | |
| cursorChildren : IChildList [唯讀]
An list of the custom cursors
being parented by this ISystemManager. | ISystemManager | ||
| document : Object
A reference to the document object. | ISystemManager | ||
| focusPane : Sprite
A single Sprite shared among components used as an overlay for drawing focus. | ISystemManager | ||
| isProxy : Boolean [唯讀]
True if the ISystemManager is a proxy and not a root class. | ISystemManager | ||
| loaderInfo : LoaderInfo [唯讀]
The LoaderInfo object that represents information about the application. | ISystemManager | ||
| numChildren : int [唯讀]
The number of children in this child list. | IChildList | |
| numModalWindows : int
The number of modal windows. | ISystemManager | ||
| popUpChildren : IChildList [唯讀]
An list of the topMost (popup)
windows being parented by this ISystemManager. | ISystemManager | ||
| preloadedRSLs : Dictionary [唯讀]
The RSLs loaded by this SystemManager or FlexModuleFactory before the
application starts. | IFlexModuleFactory | |
| rawChildren : IChildList [唯讀]
A list of all children
being parented by this ISystemManager. | ISystemManager | ||
| screen : Rectangle [唯讀]
The size and position of the application window. | ISystemManager | ||
| stage : Stage [唯讀]
The flash.display.Stage that represents the application window
mapped to this SystemManager
| ISystemManager | ||
| toolTipChildren : IChildList [唯讀]
A list of the tooltips
being parented by this ISystemManager. | ISystemManager | ||
| topLevelSystemManager : ISystemManager [唯讀]
The ISystemManager responsible for the application window. | ISystemManager | ||
| 方法 | 定義自 | ||
|---|---|---|---|
|
Adds a child DisplayObject after the end of this child list. | IChildList | |
|
Adds a child DisplayObject to this child list at the index specified. | IChildList | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。 | IEventDispatcher | |
|
Adds an RSL to the preloadedRSLs list. | IFlexModuleFactory | |
|
Calls the Security.allowDomain() method for the SWF
associated with this IFlexModuleFactory plus all the SWFs associated
with RSLs preloaded by this IFlexModuleFactory. | IFlexModuleFactory | |
|
Calls the Security.allowInsecureDomain() method for the
SWF associated with this IFlexModuleFactory
plus all the SWFs associated with RSLs preloaded by this
IFlexModuleFactory. | IFlexModuleFactory | |
|
A way to call a method in this IFlexModuleFactory's context
| IFlexModuleFactory | |
|
Determines if a DisplayObject is in this child list,
or is a descendant of an child in this child list. | IChildList | |
|
A factory method that requests
an instance of a definition known to the module. | IFlexModuleFactory | |
Deploy or remove mouse shields. | ISystemManager | ||
|
會將事件傳送到事件流程。 | IEventDispatcher | |
|
Gets the child DisplayObject at the specified index in this child list. | IChildList | |
|
Gets the child DisplayObject with the specified name
in this child list. | IChildList | |
|
Gets the index of a specific child in this child list. | IChildList | |
Converts the given String to a Class or package-level Function. | ISystemManager | ||
|
Get the implementation for an interface. | IFlexModuleFactory | |
|
Returns an array of DisplayObjects that lie under the specified point
and are in this child list. | IChildList | |
Gets the system manager that is the root of all
top level system managers in this SecurityDomain. | ISystemManager | ||
Attempts to get the system manager that is the in the main application. | ISystemManager | ||
Get the bounds of the loaded application that are visible to the user
on the screen. | ISystemManager | ||
|
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | IEventDispatcher | |
|
Returns a block of key/value pairs
that hold static data known to the module. | IFlexModuleFactory | |
Attempt to notify the parent SWFLoader that the application's size may
have changed. | ISystemManager | ||
Returns true if the required font face is embedded
in this application, or has been registered globally by using the
Font.registerFont() method. | ISystemManager | ||
Returns true if this ISystemManager is responsible
for an application window, and false if this
application has been loaded into another application. | ISystemManager | ||
Tests if this system manager is the root of all
top level system managers. | ISystemManager | ||
|
Register an implementation for an interface. | IFlexModuleFactory | |
|
Removes the specified child DisplayObject from this child list. | IChildList | |
|
Removes the child DisplayObject at the specified index
from this child list. | IChildList | |
|
會從 EventDispatcher 物件移除偵聽程式。 | IEventDispatcher | |
|
Changes the index of a particular child in this child list. | IChildList | |
|
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | IEventDispatcher | |
cursorChildren | 屬性 |
cursorChildren:IChildList [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
An list of the custom cursors being parented by this ISystemManager.
An ISystemManager has various types of children,
such as the Application, popups, top-most windows,
tooltips, and custom cursors.
You can access the custom cursors through
the cursorChildren property.
The IChildList object has methods like getChildAt()
and properties like numChildren.
For example, cursorChildren.numChildren gives
the number of custom cursors (which will be either 0 or 1)
and, if a custom cursor exists, you can access it as
cursorChildren.getChildAt(0).
實作
public function get cursorChildren():IChildListdocument | 屬性 |
document:Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
A reference to the document object. A document object is an Object at the top of the hierarchy of a Flex application, MXML component, or AS component.
實作
public function get document():Object public function set document(value:Object):voidfocusPane | 屬性 |
focusPane:Sprite| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
A single Sprite shared among components used as an overlay for drawing focus. You share it if you parent a focused component, not if you are IFocusManagerComponent.
實作
public function get focusPane():Sprite public function set focusPane(value:Sprite):voidisProxy | 屬性 |
loaderInfo | 屬性 |
loaderInfo:LoaderInfo [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The LoaderInfo object that represents information about the application.
實作
public function get loaderInfo():LoaderInfonumModalWindows | 屬性 |
numModalWindows:int| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The number of modal windows.
Modal windows don't allow clicking in another windows which would normally activate the FocusManager in that window. The PopUpManager modifies this count as it creates and destroy modal windows.
實作
public function get numModalWindows():int public function set numModalWindows(value:int):voidpopUpChildren | 屬性 |
popUpChildren:IChildList [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
An list of the topMost (popup) windows being parented by this ISystemManager.
An ISystemManager has various types of children,
such as the Application, popups,
tooltips, and custom cursors.
You can access the top-most windows through
the popUpChildren property.
The IChildList object has methods like getChildAt()
and properties like numChildren.
For example, popUpChildren.numChildren gives
the number of topmost windows and you can access them as
popUpChildren.getChildAt(i).
實作
public function get popUpChildren():IChildListrawChildren | 屬性 |
rawChildren:IChildList [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
A list of all children being parented by this ISystemManager.
An ISystemManager has various types of children, such as the Application, popups, tooltips, and custom cursors.
The IChildList object has methods like getChildAt()
and properties like numChildren.
實作
public function get rawChildren():IChildListscreen | 屬性 |
stage | 屬性 |
toolTipChildren | 屬性 |
toolTipChildren:IChildList [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
A list of the tooltips being parented by this ISystemManager.
An ISystemManager has various types of children, such as the Application, popups, topmost windows, tooltips, and custom cursors.
The IChildList object has methods like getChildAt()
and properties like numChildren.
For example, toolTipChildren.numChildren gives
the number of tooltips (which will be either 0 or 1)
and, if a tooltip exists, you can access it as
toolTipChildren.getChildAt(0).
實作
public function get toolTipChildren():IChildListtopLevelSystemManager | 屬性 |
topLevelSystemManager:ISystemManager [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The ISystemManager responsible for the application window. This will be the same ISystemManager unless this application has been loaded into another application.
實作
public function get topLevelSystemManager():ISystemManagerdeployMouseShields | () | 方法 |
public function deployMouseShields(deploy:Boolean):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Deploy or remove mouse shields. Mouse shields block mouse input to untrusted applications. The reason you would want to block mouse input is because when you are dragging over an untrusted application you would normally not receive any mouse move events. The Flash Player does not send events across trusted/untrusted boundries due to security concerns. By covering the untrusted application with a mouse shield (assuming you are its parent) you can get mouse move message and the drag operation will work as expected.
參數
deploy:Boolean — true to deploy the mouse shields, false
to remove the mouse shields.
|
getDefinitionByName | () | 方法 |
public function getDefinitionByName(name:String):Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Converts the given String to a Class or package-level Function.
Calls the appropriate ApplicationDomain.getDefinition()
method based on
whether you are loaded into another application or not.
參數
name:String — Name of class, for example "mx.video.VideoManager".
|
Object — The Class represented by the name, or null.
|
getSandboxRoot | () | 方法 |
public function getSandboxRoot():DisplayObject| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Gets the system manager that is the root of all top level system managers in this SecurityDomain.
傳回值DisplayObject — the highest-level systemManager in the sandbox
|
getTopLevelRoot | () | 方法 |
public function getTopLevelRoot():DisplayObject| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Attempts to get the system manager that is the in the main application.
傳回值DisplayObject — The main application's systemManager if allowed by
security restrictions or null if it is in a different SecurityDomain.
|
getVisibleApplicationRect | () | 方法 |
public function getVisibleApplicationRect(bounds:Rectangle = null, skipToSandboxRoot:Boolean = false):Rectangle| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Get the bounds of the loaded application that are visible to the user on the screen.
參數
bounds:Rectangle (default = null)bounds is null the
starting bounds is defined by the screen property of the
system manager.
| |
skipToSandboxRoot:Boolean (default = false) |
Rectangle — a Rectangle including the visible portion of the this
object. The rectangle is in global coordinates.
|
invalidateParentSizeAndDisplayList | () | 方法 |
public function invalidateParentSizeAndDisplayList():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Attempt to notify the parent SWFLoader that the application's size may have changed.
isFontFaceEmbedded | () | 方法 |
public function isFontFaceEmbedded(tf:flash.text:TextFormat):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns true if the required font face is embedded
in this application, or has been registered globally by using the
Font.registerFont() method.
參數
tf:flash.text:TextFormat — The TextFormat class representing character formatting information.
|
Boolean — true if the required font face is embedded
in this application, or has been registered globally by using the
Font.registerFont() method.
|
isTopLevel | () | 方法 |
public function isTopLevel():Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns true if this ISystemManager is responsible
for an application window, and false if this
application has been loaded into another application.
Boolean — true if this ISystemManager is responsible
for an application window.
|
isTopLevelRoot | () | 方法 |
Tue Jun 12 2018, 03:47 PM Z