ISystemManager - Guide de référence de l’API Adobe ActionScript® 3 (AS3 Flex)

Package	mx.managers
Interface	public interface ISystemManager extends IEventDispatcher , IChildList , IFlexModuleFactory
Implémenteurs	SystemManager, WindowedSystemManager

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Un objet ISystemManager gère une « fenêtre d’application ». Chaque application qui s’exécute sur le bureau ou dans un navigateur comporte une zone d’affichage des effets visuels de l’application. Il peut s’agir d’une fenêtre dans le système d’exploitation ou d’une zone au sein du navigateur. Il s’agit d’une « fenêtre d’application », ce qui est différent d’une instance de mx.core.Application, qui correspond à la fenêtre de « niveau supérieur » principale d’une application.

Chaque application est dotée d’un objet ISystemManager. L’objet ISystemManager envoie un événement si la taille de la fenêtre d’application change (vous ne pouvez pas la changer au sein de l’application, mais seulement par interaction avec la fenêtre du système d’exploitation ou avec le navigateur). Il est le parent de tous les éléments affichables dans l’application, comme l’instance mx.core.Application principale et tous les menus déroulants, infos-bulles, curseurs, etc. Tout objet parent du contrôle ISystemManager est considéré comme une fenêtre de « niveau supérieur », même les infos-bulles et les curseurs.

L’objet ISystemManager fait également basculer le focus entre les fenêtres de niveau supérieur si plusieurs objets IFocusManagerContainer sont affichées et si les utilisateurs interagissent avec les composants au sein des objets IFocusManagerContainer.

Toute activité du clavier et de la souris qui n’est pas expressément traitée à un autre emplacement de l’application est vue par l’objet ISystemManager, ce qui en fait l’endroit idéal pour gérer l’activité, si besoin est.

Si une application est chargée dans une autre application, un objet ISystemManager est tout de même créé, mais il ne gérera pas de « fenêtre d’application », selon les règles de sécurité et du domaine. En revanche, il deviendra le contenu du composant Loader qui l’a chargé et servira simplement de parent à la sous-application

L’objet ISystemManager gère plusieurs listes d’enfants, chacune étant destinée aux infos-bulles, curseurs et fenêtres contextuelles. C’est ainsi qu’il s’assure que les fenêtres contextuelles « flottent » sur les fenêtres de l’application principale et que les infos-bulles « flottent » par dessus, et les curseurs encore au-dessus. Si vous observez la propriété numChildren ou la méthode getChildAt() appliquée au gestionnaire ISystemManager, elles se rapportent toutes les deux à la fenêtre d’application principale et à toutes les autres fenêtres non contextuelles. Pour obtenir la liste de toutes les fenêtres, y compris les fenêtres contextuelles, les infos-bulles et les curseurs, utilisez la propriété rawChildren.

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		allowDomainsInNewRSLs : Boolean Contrôle si les domaines autorisés par les appels à allowDomain() sont également autorisés par les bibliothèques RSL chargées après l’appel.	IFlexModuleFactory
		allowInsecureDomainsInNewRSLs : Boolean Contrôle si les domaines autorisés par les appels à allowInsecureDomain() sont également autorisés par les bibliothèques RSL chargées après l’appel.	IFlexModuleFactory
		cursorChildren : IChildList [lecture seule] Liste des curseurs personnalisés qui sont les parents de cet objet ISystemManager.	ISystemManager
		document : Object Référence à l’objet de document.	ISystemManager
		focusPane : Sprite Objet Sprite unique partagé entre les composants et utilisé comme incrustation pour le focus des dessins.	ISystemManager
		isProxy : Boolean [lecture seule] Renvoie la valeur True si SystemManager est un proxy et non une classe racine.	ISystemManager
		loaderInfo : LoaderInfo [lecture seule] Objet LoaderInfo qui représente les informations sur l’application.	ISystemManager
		numChildren : int [lecture seule] Nombre d’enfants dans cette liste d’enfants.	IChildList
		numModalWindows : int Nombre de fenêtres modales.	ISystemManager
		popUpChildren : IChildList [lecture seule] Liste des fenêtres (contextuelles) topMost qui sont les parents de cet objet ISystemManager.	ISystemManager
		preloadedRSLs : Dictionary [lecture seule] Les bibliothèques RSL chargées par ce SystemManager ou FlexModuleFactory avant le lancement de l’application.	IFlexModuleFactory
		rawChildren : IChildList [lecture seule] Liste de tous les enfants qui sont les parents de cet objet ISystemManager.	ISystemManager
		screen : Rectangle [lecture seule] Taille et position de la fenêtre d’application.	ISystemManager
		stage : Stage [lecture seule] Objet flash.display.Stage qui représente la fenêtre d’application associée à cet objet SystemManager.	ISystemManager
		toolTipChildren : IChildList [lecture seule] Liste des infos-bulles qui sont les parents de cet objet ISystemManager.	ISystemManager
		topLevelSystemManager : ISystemManager [lecture seule] Objet ISystemManager responsable de la fenêtre d’application.	ISystemManager

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		addChild(child:DisplayObject):DisplayObject Ajoute un objet DisplayObject enfant à la fin de la liste d’enfants.	IChildList
		addChildAt(child:DisplayObject, index:int):DisplayObject Ajoute une instance enfant de DisplayObject à cette liste d’enfants à l’index spécifié.	IChildList
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	IEventDispatcher
		addPreloadedRSL(loaderInfo:LoaderInfo, rsl:Vector.<RSLData>):void Ajoute une bibliothèque RSL dans la liste des preloadedRSL.	IFlexModuleFactory
		allowDomain(... domains):void Appelle la méthode Security.allowDomain() pour le fichier SWF associé à cette fabrique IFlexModuleFactory, plus tous les fichiers SWF associés aux bibliothèques RSL préchargées par cette dernière.	IFlexModuleFactory
		allowInsecureDomain(... domains):void Appelle la méthode Security.allowInsecureDomain() pour le fichier SWF associé à cette fabrique IFlexModuleFactory, plus tous les fichiers SWF associés aux bibliothèques RSL préchargées par cette dernière.	IFlexModuleFactory
		callInContext(fn:Function, thisArg:Object, argArray:Array, returns:Boolean = true):* Moyen d’appeler une méthode dans le contexte de cet IFlexModuleFactory	IFlexModuleFactory
		contains(child:DisplayObject):Boolean Détermine si un objet DisplayObject figure dans cette liste d’enfants ou est un descendant d’un enfant de cette liste d’enfants.	IChildList
		create(... parameters):Object Méthode de fabrique qui demande une instance d’une définition connue au module.	IFlexModuleFactory
		deployMouseShields(deploy:Boolean):void Déploie ou supprime les boucliers de souris.	ISystemManager
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	IEventDispatcher
		getChildAt(index:int):DisplayObject Obtient l’objet DisplayObject enfant qui se trouve à la position d’index spécifiée de cette liste d’enfants.	IChildList
		getChildByName(name:String):DisplayObject Obtient l’objet DisplayObject enfant avec le nom spécifié dans cette liste d’enfants.	IChildList
		getChildIndex(child:DisplayObject):int Récupère la position d’index d’un enfant spécifique dans cette liste d’enfants.	IChildList
		getDefinitionByName(name:String):Object Convertit la chaîne donnée en classe ou fonction au niveau du package.	ISystemManager
		getImplementation(interfaceName:String):Object Obtenez l’implémentation une interface.	IFlexModuleFactory
		getObjectsUnderPoint(point:Point):Array Renvoie un tableau d’objets DisplayObject de niveau inférieur au point spécifié et figurant dans cette liste d’enfants.	IChildList
		getSandboxRoot():DisplayObject Obtient le gestionnaire système qui est la racine de tous les gestionnaires système de niveau supérieur dans cet objet SecurityDomain.	ISystemManager
		getTopLevelRoot():DisplayObject Tente d’obtenir le gestionnaire système qui se trouve dans l’application principale.	ISystemManager
		getVisibleApplicationRect(bounds:Rectangle = null, skipToSandboxRoot:Boolean = false):Rectangle Obtenez les limites de l’application chargée qui sont visibles pour l’utilisateur à l’écran.	ISystemManager
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	IEventDispatcher
		info():Object Renvoie un bloc de paires clé/valeur contenant les données statistiques connues par le module.	IFlexModuleFactory
		invalidateParentSizeAndDisplayList():void Tentative de signalisation au SWFLoader parent que la taille de l’application a peut-être été modifiée.	ISystemManager
		isFontFaceEmbedded(tf:flash.text:TextFormat):Boolean Renvoie la valeur true si la police requise est imbriquée dans cette application ou a été enregistrée globalement à l’aide de la méthode Font.registerFont().	ISystemManager
		isTopLevel():Boolean Renvoie la valeur true si cet objet ISystemManager est responsable d’une fenêtre d’application et la valeur false si cette application a été chargée dans une autre application.	ISystemManager
		isTopLevelRoot():Boolean Teste si ce gestionnaire système est la racine de tous les gestionnaires système de niveau supérieur.	ISystemManager
		registerImplementation(interfaceName:String, impl:Object):void Enregistrez une implémentation pour une interface.	IFlexModuleFactory
		removeChild(child:DisplayObject):DisplayObject Supprime l’objet DisplayObject enfant spécifié de cette liste d’enfants.	IChildList
		removeChildAt(index:int):DisplayObject Supprime l’objet DisplayObject enfant qui se trouve à l’index spécifié de cette liste d’enfants.	IChildList
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	IEventDispatcher
		setChildIndex(child:DisplayObject, newIndex:int):void Modifie la position d’index d’un enfant particulier de cette liste d’enfants.	IChildList
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	IEventDispatcher

Détails de la propriété

cursorChildren

propriété

cursorChildren:IChildList [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Liste des curseurs personnalisés qui sont les parents de cet objet ISystemManager.

Un objet ISystemManager possède plusieurs types d’enfants, comme l’application, les fenêtres contextuelles, les fenêtres de niveau supérieur, les infos-bulles et les curseurs personnalisés. Vous pouvez accéder aux curseurs personnalisés via la propriété cursorChildren.

L’objet IChildList comporte des méthodes comme getChildAt() et comme numChildren. Par exemple, cursorChildren.numChildren fournit le nombre de curseurs personnalisés (qui sera de 0 ou 1) et, si un curseur personnalisé existe, il est accessible par la méthode cursorChildren.getChildAt(0).

Implémentation
public function get cursorChildren():IChildList

document

propriété

document:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Référence à l’objet de document. Un objet de document est un objet qui se trouve au sommet de la hiérarchie d’une application Flex, d’un composant MXML ou d’un composant AS.

Implémentation
public function get document():Object
public function set document(value:Object):void

focusPane

propriété

focusPane:Sprite

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Objet Sprite unique partagé entre les composants et utilisé comme incrustation pour le focus des dessins. Vous le partagez si vous êtes parent avec un composant sur lequel un focus est placé, et non si vous êtes un objet IFocusManagerComponent.

Implémentation
public function get focusPane():Sprite
public function set focusPane(value:Sprite):void

isProxy

propriété

isProxy:Boolean [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie la valeur True si SystemManager est un proxy et non une classe racine.

Implémentation
public function get isProxy():Boolean

loaderInfo

propriété

loaderInfo:LoaderInfo [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Objet LoaderInfo qui représente les informations sur l’application.

Implémentation
public function get loaderInfo():LoaderInfo

numModalWindows

propriété

numModalWindows:int

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Nombre de fenêtres modales.

Les fenêtres modales n’autorisent pas les clics dans une autre fenêtre qui sont susceptibles d’activer l’objet FocusManager dans cette fenêtre. L’objet PopUpManager modifie ce nombre en créant et supprimant les fenêtres modales.

Implémentation
public function get numModalWindows():int
public function set numModalWindows(value:int):void

popUpChildren

propriété

popUpChildren:IChildList [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Liste des fenêtres (contextuelles) topMost qui sont les parents de cet objet ISystemManager.

Un objet ISystemManager possède plusieurs types d’enfants, comme l’application, les fenêtres contextuelles, les infos-bulles et les curseurs personnalisés. Vous pouvez accéder aux fenêtres de niveau supérieur via la propriété popUpChildren.

L’objet IChildList comporte des méthodes comme getChildAt() et comme numChildren. Par exemple, la méthode popUpChildren.numChildren fournit le nombre de fenêtres de niveau supérieur qui est accessible avec méthode popUpChildren.getChildAt(i).

Implémentation
public function get popUpChildren():IChildList

rawChildren

propriété

rawChildren:IChildList [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Liste de tous les enfants qui sont les parents de cet objet ISystemManager.

Un objet ISystemManager possède plusieurs types d’enfants, comme l’application, les fenêtres contextuelles, les infos-bulles et les curseurs personnalisés.

L’objet IChildList comporte des méthodes comme getChildAt() et comme numChildren.

Implémentation
public function get rawChildren():IChildList

screen

propriété

screen:Rectangle [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Taille et position de la fenêtre d’application. L’objet Rectangle contient les propriétés x, y, width et height. Le rectangle est exprimé en racine sandbox coordonnées.

Implémentation
public function get screen():Rectangle

stage

propriété

stage:Stage [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Objet flash.display.Stage qui représente la fenêtre d’application associée à cet objet SystemManager.

Implémentation
public function get stage():Stage

toolTipChildren

propriété

toolTipChildren:IChildList [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Liste des infos-bulles qui sont les parents de cet objet ISystemManager.

Un objet ISystemManager possède plusieurs types d’enfants, comme l’application, les fenêtres contextuelles, les fenêtres de niveau supérieur, les infos-bulles et les curseurs personnalisés.

L’objet IChildList comporte des méthodes comme getChildAt() et comme numChildren. Par exemple, la méthode toolTipChildren.numChildren fournit le nombre d’infos-bulles (qui sera de 0 ou 1) et, si une info-bulle existe, il est accessible avec la méthode toolTipChildren.getChildAt(0).

Implémentation
public function get toolTipChildren():IChildList

topLevelSystemManager

propriété

topLevelSystemManager:ISystemManager [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Objet ISystemManager responsable de la fenêtre d’application. Il s’agira du même objet ISystemManager sauf si cette application a été chargée dans une autre application.

Implémentation
public function get topLevelSystemManager():ISystemManager

Détails de la méthode

deployMouseShields

()

méthode

public function deployMouseShields(deploy:Boolean):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Déploie ou supprime les boucliers de souris. Les boucliers de souris bloquent l’entrée de la souris pour les applications non approuvées. Une des raisons pour lesquelles vous pouvez souhaiter bloquer l’entrée de la souris est que lorsque vous faites glisser la souris sur une application non approuvée, vous ne recevez normalement pas d’événements de déplacement de souris. Flash Player n’envoie pas d’événements à travers les limites de confiance/non approuvées pour des raisons de sécurité. En couvrant une application non approuvée avec un bouclier de souris (si vous êtes son parent), vous pouvez recevoir le message de déplacement de la souris et l’opération Glisser-déposer fonctionnera normalement.

Paramètres

deploy:Boolean — La valeur est true pour déployer les boucliers de souris et false pour les enlever.

getDefinitionByName

()

méthode

public function getDefinitionByName(name:String):Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Convertit la chaîne donnée en classe ou fonction au niveau du package. Appelle la méthode ApplicationDomain.getDefinition() appropriée selon si un élément est chargé dans une autre application ou non.

Paramètres

name:String — Nom de classe, par exemple « mx.video.VideoManager ».

Valeur renvoyée

Object — Classe représentée par le nom, ou valeur null.

getSandboxRoot

()

méthode

public function getSandboxRoot():DisplayObject

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Obtient le gestionnaire système qui est la racine de tous les gestionnaires système de niveau supérieur dans cet objet SecurityDomain.

Valeur renvoyée

DisplayObject — le gestionnaire système de plus haut niveau dans le sandbox

getTopLevelRoot

()

méthode

public function getTopLevelRoot():DisplayObject

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Tente d’obtenir le gestionnaire système qui se trouve dans l’application principale.

Valeur renvoyée

DisplayObject — Objet systemManager de l’application principale s’il est autorisé par les restrictions de sécurité ou valeur null s’il se trouve dans un autre SecurityDomain.

getVisibleApplicationRect

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Obtenez les limites de l’application chargée qui sont visibles pour l’utilisateur à l’écran.

Paramètres

	`bounds:Rectangle` (default = `null`) — Facultatif. Limites de début du rectangle visible. Les limites sont exprimées en coordonnées globales. Si `bounds` est null, les limites de début sont définies par la propriété `screen` du gestionnaire système.

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

Valeur renvoyée

Rectangle — un Rectangle incluant la portion visible de cet objet. Le rectangle est exprimé en coordonnées globales.

invalidateParentSizeAndDisplayList

()

méthode

public function invalidateParentSizeAndDisplayList():void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Tentative de signalisation au SWFLoader parent que la taille de l’application a peut-être été modifiée.

isFontFaceEmbedded

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie la valeur true si la police requise est imbriquée dans cette application ou a été enregistrée globalement à l’aide de la méthode Font.registerFont.

Paramètres

tf:flash.text:TextFormat — Classe TextFormat représentant les informations de mise en forme de caractères.

Valeur renvoyée

Boolean — Renvoie la valeur true si la police requise est imbriquée dans cette application ou a été enregistrée globalement à l’aide de la méthode Font.registerFont.

isTopLevel

()

méthode

public function isTopLevel():Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie la valeur true si cet objet ISystemManager est responsable d’une fenêtre d’application et la valeur false si cette application a été chargée dans une autre application.

Valeur renvoyée

Boolean — Renvoie la valeur true si cet objet ISystemManager est responsable d’une fenêtre d’application.

isTopLevelRoot

()

méthode

public function isTopLevelRoot():Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Teste si ce gestionnaire système est la racine de tous les gestionnaires système de niveau supérieur.

Valeur renvoyée

Boolean — Renvoie la valeur true si l’objet SystemManager est la racine de tous les gestionnaires système sur la liste d’affiche. Sinon, la valeur false est renvoyée.

Informations juridiques | Politique de confidentialité en ligne

ISystemManager - AS3 Flex

Classes x

cursorChildren

document

focusPane

isProxy

loaderInfo

numModalWindows

popUpChildren

rawChildren

screen

stage

toolTipChildren

topLevelSystemManager

deployMouseShields

getDefinitionByName

getSandboxRoot

getTopLevelRoot

getVisibleApplicationRect

invalidateParentSizeAndDisplayList

isFontFaceEmbedded

isTopLevel

isTopLevelRoot