The WindowedSystemManager class manages any non-Application windows in a
Flex-based AIR application. This includes all windows that are instances of
the Window component or a Window subclass, but not a WindowedApplication
window. For those windows, the WindowedSystemManager serves the same role
that a SystemManager serves for a WindowedApplication instance or an
Application instance in a browser-based Flex application.
As this comparison suggests, the WindowedSystemManager class serves
many roles. For instance, it is the root display object of a Window, and
manages tooltips, cursors, popups, and other content for the Window.
Returns true if the given DisplayObject is the
top-level window.
WindowedSystemManager
Property Detail
allowDomainsInNewRSLs
property
allowDomainsInNewRSLs:Boolean
Language Version :
ActionScript 3.0
Product Version :
Flex 4.5
Runtime Versions :
Flash Player 10.2, AIR 2.6
Controls whether the domains allowed by calls to allowDomain()
are also allowed by RSLs loaded after the call. Additional RSLs
may be loaded into this module factory by sub-applications or modules.
Implementation public function get allowDomainsInNewRSLs():Boolean public function set allowDomainsInNewRSLs(value:Boolean):void
allowInsecureDomainsInNewRSLs
property
allowInsecureDomainsInNewRSLs:Boolean
Language Version :
ActionScript 3.0
Product Version :
Flex 4.5
Runtime Versions :
Flash Player 10.2, AIR 2.6
Controls whether the domains allowed by calls to allowInsecureDomain()
are also allowed by RSLs loaded after the call. Additional RSLs
may be added to this module factory by sub-applications or modules.
Implementation public function get allowInsecureDomainsInNewRSLs():Boolean public function set allowInsecureDomainsInNewRSLs(value:Boolean):void
childAllowsParent
property
childAllowsParent:Boolean [read-only]
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
Implementation public function get childAllowsParent():Boolean
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).
Implementation public function get cursorChildren():IChildList
document
property
document:Object
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
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.
Implementation public function get document():Object public function set document(value:Object):void
embeddedFontList
property
embeddedFontList:Object [read-only]
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
A table of embedded fonts in this application. The
object is a table indexed by the font name.
Implementation public function get embeddedFontList():Object
focusPane
property
focusPane:Sprite
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
The focus pane associated with this object.
An object has a focus pane when one of its children has focus.
Implementation public function get focusPane():Sprite public function set focusPane(value:Sprite):void
height
property
height:Number [read-only] [override]
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
The height of this object. For the SystemManager
this should always be the width of the stage unless the application was loaded
into another application. If the application was not loaded
into another application, setting this value has no effect.
Implementation public function get height():Number
isProxy
property
isProxy:Boolean [read-only]
True if SystemManager is a proxy and not a root class
Implementation public function get isProxy():Boolean
numChildren
property
numChildren:int [read-only] [override]
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
The number of non-floating windows. This is the main application window
plus any other windows added to the SystemManager that are not popups,
tooltips or cursors.
Implementation public function get numChildren():int
numModalWindows
property
numModalWindows:int
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
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 destroys modal windows.
Implementation public function get numModalWindows():int public function set numModalWindows(value:int):void
parentAllowsChild
property
parentAllowsChild:Boolean [read-only]
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
Implementation public function get parentAllowsChild():Boolean
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).
Implementation public function get popUpChildren():IChildList
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.
Implementation public function get rawChildren():IChildList
screen
property
screen:Rectangle [read-only]
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
The size and position of the application window.
The Rectangle object contains x, y,
width, and height properties.
The Rectangle is in sandbox root coordinates.
Implementation public function get screen():Rectangle
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).
Implementation public function get toolTipChildren():IChildList
Returns the SystemManager responsible for the application window. This will be
the same SystemManager unless this application has been loaded into another
application.
Implementation public function get topLevelSystemManager():ISystemManager
width
property
width:Number [read-only] [override]
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
The width of this object. For the SystemManager
this should always be the width of the stage unless the application was loaded
into another application. If the application was not loaded
into another application, setting this value will have no effect.
Implementation public function get width():Number
Constructor Detail
WindowedSystemManager
()
Constructor
public function WindowedSystemManager(rootObj:IUIComponent)
public function callInContext(fn:Function, thisArg:Object, argArray:Array, returns:Boolean = true):*
This method should not be called on WindowedSystemManager.
It is here as part of the contract for IFlexModuleFactory.
Parameters
fn:Function
thisArg:Object
argArray:Array
returns:Boolean (default = true)
Returns
*
create
()
method
public function create(... params):Object
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
This method is overridden in the autogenerated subclass.
Parameters
... params
Returns
Object
deployMouseShields
()
method
public function deployMouseShields(deploy:Boolean):void
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
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.
Parameters
deploy:Boolean — true to deploy the mouse shields, false
to remove the mouse shields.
getDefinitionByName
()
method
public function getDefinitionByName(name:String):Object
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
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.
Parameters
name:String — Name of class, for example "mx.video.VideoManager".
Returns
Object — The Class represented by the name, or null.
getFocus
()
method
public function getFocus():InteractiveObject
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
Return the object the player sees as having focus.
Returns
InteractiveObject — An object of type InteractiveObject that the
player sees as having focus. If focus is currently
in a sandbox the caller does not have access to
null will be returned.
getSandboxRoot
()
method
public function getSandboxRoot():DisplayObject
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
Go up our parent chain to get the top level system manager in this
SecurityDomain
Returns
DisplayObject
getTopLevelRoot
()
method
public function getTopLevelRoot():DisplayObject
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
Go up our parent chain to get the top level system manager.
returns null if we are not on the display list or we don't have
access to the top level system manager.
Returns
DisplayObject
getVisibleApplicationRect
()
method
public function getVisibleApplicationRect(bounds:Rectangle = null, skipToSandboxRoot:Boolean = false):Rectangle
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
Parameters
bounds:Rectangle (default = null)
skipToSandboxRoot:Boolean (default = false)
Returns
Rectangle
invalidateParentSizeAndDisplayList
()
method
public function invalidateParentSizeAndDisplayList():void
Language Version :
ActionScript 3.0
Product Version :
Flex 4
Runtime Versions :
Flash Player 10, AIR 1.5
Attempts to notify the parent SWFLoader that the
Application's size has may have changed. Not needed
for WindowedSystemManager so does nothing
isFontFaceEmbedded
()
method
public function isFontFaceEmbedded(textFormat:TextFormat):Boolean
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
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.
Parameters
textFormat:TextFormat — The TextFormat class representing character formatting information.
Returns
Boolean — true if the required font face is embedded
in this application, or has been registered globally by using the
Font.registerFont() method.
isTopLevel
()
method
public function isTopLevel():Boolean
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
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.
Returns
Boolean — true if this ISystemManager is responsible
for an application window.
isTopLevelRoot
()
method
public function isTopLevelRoot():Boolean
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
Returns
Boolean
isTopLevelWindow
()
method
public function isTopLevelWindow(object:DisplayObject):Boolean
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
AIR 1.1
Returns true if the given DisplayObject is the
top-level window.
Parameters
object:DisplayObject
Returns
Boolean — true if the given DisplayObject is the
top-level window.