| Package | mx.controls |
| Classe | public class SWFLoader |
| Héritage | SWFLoader  UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Implémente | ISWFLoader |
| Sous-classes | Image, MovieClipSWFLoader, PromoSWFLoader |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Remarque : vous pouvez utiliser le contrôle SWFLoader pour charger un fichier d’image GIF, JPEG ou PNG au moment de l’exécution, pour charger un objet ByteArray représentant une image SWF, GIF, JPEG ou PNG au moment de l’exécution ou pour charger une version imbriquée de n’importe lequel de ces types de fichiers, ainsi que les fichiers SVG, au moment de la compilation à l’aide de @Embed(source=’filename’). Toutefois, le contrôle Image convient mieux et doit être utilisé pour la plupart des chargement d’images. Le contrôle Image est également conçu pour être utilisé dans les rendus d’élément et les éditeurs d’élément personnalisés. Lorsque vous utilisez le contrôle SWFLoader ou Image avec un fichier SVG, vous ne pouvez charger le fichier SVG que s’il a été imbriqué dans votre application à l’aide d’une déclaration Embed. Vous ne pouvez pas charger un fichier SVG à partir du réseau au moment de l’exécution.
Le contrôle SWFLoader permet de mettre son contenu à l’échelle et de définir sa taille. Il peut également se redimensionner pour adapter sa taille à son contenu. Par défaut, le contenu est mis à l’échelle pour s’adapter à la taille du contrôle SWFLoader. Il peut également charger du contenu sur demande par programme et contrôler la progression du chargement.
Un contrôle SWFLoader ne peut pas recevoir le focus. En revanche, le contenu d’un contrôle SWFLoader peut accepter le focus et avoir ses propres interactions de focus.
Le contrôle SWFLoader possède les caractéristiques par défaut suivantes :
| Caractéristique | Description |
|---|---|
| Taille par défaut | Largeur et hauteur suffisamment importantes pour le contenu chargé |
| Taille minimale | 0 pixel |
| Taille minimale | Undefined |
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:SWFLoader> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:
<mx:SWFLoader
Properties
autoLoad="true|false"
loadForCompatibility="false|true"
loaderContext="null"
maintainAspectRatio="true|false"
scaleContent="true|false"
showBusyCursor="false|true"
source="No default"
trustContent="false|true"
Styles
brokenImageBorderSkin="BrokenImageBorderSkin"
brokenImageSkin="'__brokenImage' symbol in Assets.swf"
horizontalAlign="left|center|right"
verticalAlign="top|middle|bottom"
Effects
completeEffect="No default"
Events
complete="No default"
httpStatus="No default"
init="No default"
ioError="No default"
open="No default"
progress="No default"
securityError="No default"
unload="No default"
/>
Eléments de l’API associés
Propriétés publiques
| Propriété | Défini par | ||
|---|---|---|---|
 | accessibilityDescription : String
Accesseur pratique pour la propriété description de l’objet accessibilityProperties de ce composant UIComponent. | UIComponent | |
| accessibilityEnabled : Boolean
Accesseur pratique pour la propriété silent de l’objet accessibilityProperties de ce composant UIComponent. | UIComponent | |
| accessibilityImplementation : AccessibilityImplementation
Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject. | InteractiveObject | |
| accessibilityName : String
Accesseur pratique pour la propriété name de l’objet accessibilityProperties de ce composant UIComponent. | UIComponent | |
| accessibilityProperties : AccessibilityProperties
Options d’accessibilité actuelles de l’objet d’affichage. | DisplayObject | |
| accessibilityShortcut : String
Accesseur pratique pour la propriété shortcut de l’objet accessibilityProperties de ce composant UIComponent. | UIComponent | |
| activeEffects : Array [lecture seule]
Liste des effets en cours de lecture sur le composant, sous forme d’un tableau d’instances EffectInstance. | UIComponent | |
| alpha : Number
Indique la valeur de transparence alpha de l’objet spécifié. | DisplayObject | |
| autoLoad : Boolean
Indicateur précisant si le contenu commence automatiquement à être chargé ou s’il attend l’appel de la méthode load(). | SWFLoader | ||
| automationDelegate : Object
Objet délégué qui traite la fonction d’automatisation. | UIComponent | |
| automationEnabled : Boolean [lecture seule]
True si ce composant est activé pour l’automatisation, false dans le cas contraire. | UIComponent | |
| automationName : String
Nom pouvant être utilisé comme identifiant de cet objet. | UIComponent | |
| automationOwner : DisplayObjectContainer [lecture seule]
Propriétaire de ce composant à des fins d’automatisation. | UIComponent | |
| automationParent : DisplayObjectContainer [lecture seule]
Parent de ce composant à des fins d’automatisation. | UIComponent | |
| automationTabularData : Object [lecture seule]
Implémentation de l’interface IAutomationTabularData, qui peut être utilisée pour récupérer les données. | UIComponent | |
| automationValue : Array [lecture seule]
Cette valeur correspond généralement à l’apparence rendue de l’objet et doit être utilisable pour associer l’identifiant à l’objet lorsqu’il apparaît visuellement dans l’application. | UIComponent | |
| automationVisible : Boolean [lecture seule]
True si ce composant est visible pour l’automatisation, false dans le cas contraire. | UIComponent | |
| baseline : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | |
| baselinePosition : Number [lecture seule]
Coordonnée y de la ligne de base de la première ligne de texte du composant. | UIComponent | |
| blendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser. | DisplayObject | |
| blendShader : Shader [écriture seule]
Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan. | DisplayObject | |
| bottom : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | |
| buttonMode : Boolean
Spécifie le mode de bouton du sprite. | Sprite | |
| bytesLoaded : Number [lecture seule]
Nombre d’octets du fichier SWF ou image déjà chargé. | SWFLoader | ||
| bytesTotal : Number [lecture seule]
Taille totale du fichier SWF ou image. | SWFLoader | ||
| cacheAsBitmap : Boolean
Si la valeur true est définie, les moteurs d’exécution de Flash placent en mémoire cache une version bitmap interne de l’objet d’affichage. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
S’il n’est pas nul, cet objet Matrix définit le mode de rendu d’un objet d’affichage lorsque cacheAsBitmap est définie sur true. | DisplayObject | |
| cacheHeuristic : Boolean [écriture seule]
Utilisé par Flex pour suggérer la mise en cache sous forme de bitmap de l’objet. | UIComponent | |
| cachePolicy : String
Spécifie la stratégie de mise en cache sous forme de bitmap de cet objet. | UIComponent | |
| childAllowsParent : Boolean [lecture seule]
Vérifie si l’enfant autorise son parent à accéder à ses objets d’affichage ou à écouter les messages qui prennent leur origine dans l’enfant. | SWFLoader | ||
| className : String [lecture seule]
Nom de la classe de cette instance, par exemple « Button ». | UIComponent | |
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| content : DisplayObject [lecture seule]
Cette propriété contient l’objet représentant le contenu qui a été chargé dans le contrôle SWFLoader. | SWFLoader | ||
| contentHeight : Number [lecture seule]
Hauteur du contenu mis à l’échelle et chargé par le contrôle, en pixels. | SWFLoader | ||
| contentMouseX : Number [lecture seule]
Renvoie la position x de la souris, dans le système de coordonnées du contenu. | UIComponent | |
| contentMouseY : Number [lecture seule]
Renvoie la position y de la souris, dans le système de coordonnées du contenu. | UIComponent | |
| contentWidth : Number [lecture seule]
Largeur du contenu mis à l’échelle et chargé par le contrôle, en pixels. | SWFLoader | ||
| contextMenu : NativeMenu
Spécifie le menu contextuel associé à l’objet. | InteractiveObject | |
| currentState : String
Etat d’affichage actuel du composant. | UIComponent | |
| cursorManager : ICursorManager [lecture seule]
Récupère le gestionnaire CursorManager qui contrôle le curseur pour ce composant et ses homologues. | UIComponent | |
| depth : Number
Détermine l’ordre dans lequel les éléments sont rendus au sein des conteneurs. | UIComponent | |
| descriptor : UIComponentDescriptor
Référence à la classe UIComponentDescriptor, le cas échéant, utilisée par la méthode createComponentFromDescriptor() pour créer cette instance UIComponent. | UIComponent | |
| designLayer : DesignLayer
Spécifie l’instance DesignLayer facultative associée à cet élément visuel. | UIComponent | |
| document : Object
Référence à l’objet de document associé à ce composant UIComponent. | UIComponent | |
| doubleClickEnabled : Boolean [override]
Spécifie si l’objet UIComponent reçoit les événements doubleClick. | UIComponent | |
| dropTarget : DisplayObject [lecture seule]
Spécifie l’objet d’affichage sur lequel le sprite est glissé ou sur lequel il a été déposé. | Sprite | |
| enabled : Boolean
Indique si le composant peut accepter une interaction de l’utilisateur. | UIComponent | |
| errorString : String
Texte affiché par le conseil d’erreur d’un composant lorsqu’un composant est surveillé par un programme de validation et que la validation échoue. | UIComponent | |
| explicitHeight : Number
Nombre définissant la hauteur explicite du composant en pixels, dans les coordonnées du composant. | UIComponent | |
| explicitMaxHeight : Number
Hauteur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | |
| explicitMaxWidth : Number
Largeur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | |
| explicitMinHeight : Number
Hauteur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | |
| explicitMinWidth : Number
Largeur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | |
| explicitWidth : Number
Nombre définissant la largeur explicite du composant en pixels, dans les coordonnées du composant. | UIComponent | |
| filters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage. | DisplayObject | |
| flexContextMenu : IFlexContextMenu
Menu contextuel pour ce composant UIComponent. | UIComponent | |
| focusEnabled : Boolean
Indique si le composant peut recevoir le focus par tabulation. | UIComponent | |
| focusManager : IFocusManager
Récupère le FocusManager qui contrôle le focus pour ce composant et ses homologues. | UIComponent | |
| focusPane : Sprite
Volet de focus associé à cet objet. | UIComponent | |
| focusRect : Object
Spécifie si l’objet affiche un rectangle de focus. | InteractiveObject | |
| graphics : Graphics [lecture seule]
Spécifie l’objet Graphics appartenant au sprite qui prend en charge les commandes de dessin vectoriel. | Sprite | |
| hasFocusableChildren : Boolean
Indicateur qui signale si les objets enfant peuvent recevoir le focus | UIComponent | |
| hasLayoutMatrix3D : Boolean [lecture seule]
Contient true si l’élément possède une matrice 3D. | UIComponent | |
| height : Number [override]
Nombre définissant la hauteur du composant en pixels, dans les coordonnées du parent. | UIComponent | |
| hitArea : Sprite
Désigne un autre sprite qui fera office de zone active d’un sprite. | Sprite | |
| horizontalCenter : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | |
| id : String
ID du composant. | UIComponent | |
| includeInLayout : Boolean
Indique si ce composant est inclus dans la présentation du conteneur parent. | UIComponent | |
| inheritingStyles : Object
Début de la chaîne de styles hérités de ce composant. | UIComponent | |
| initialized : Boolean
Indicateur déterminant si un objet a traversé les trois phases de présentation : validation, mesure et présentation (si besoin était). | UIComponent | |
| instanceIndex : int [lecture seule]
Index d’un composant répété. | UIComponent | |
| instanceIndices : Array
Tableau contenant les indices requis pour faire référence à cet objet UIComponent à partir de son document parent. | UIComponent | |
| is3D : Boolean [lecture seule]
Contient true lorsque l’élément est en 3D. | UIComponent | |
| isDocument : Boolean [lecture seule]
Contient la valeur true si l’instance UIComponent est un objet document. | UIComponent | |
| isPopUp : Boolean
Défini sur true par le gestionnaire PopUpManager pour indiquer que composant a été ouvert sous forme de menu contextuel. | UIComponent | |
| layoutMatrix3D : Matrix3D [écriture seule]
Matrice de transformation utilisée pour calculer la présentation d’un composant par rapport à ses frères. | UIComponent | |
| left : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | |
| loaderContext : LoaderContext
Objet LoaderContext à utiliser pour contrôler le chargement du contenu. | SWFLoader | ||
| loaderInfo : LoaderInfo [lecture seule]
Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage. | DisplayObject | |
| loadForCompatibility : Boolean
Indicateur précisant si le contenu est chargé afin qu’il puisse interagir avec des applications de version différente du compilateur Flex. | SWFLoader | ||
| maintainAspectRatio : Boolean
Indicateur précisant si les proportions du contenu chargé doivent être conservées. | SWFLoader | ||
| maintainProjectionCenter : Boolean
Lorsque sa valeur est true, le composant garde sa matrice de projection centrée sur le milieu de son cadre de sélection. | UIComponent | |
| mask : DisplayObject
L’objet d’affichage appelant est masqué par l’objet mask spécifié. | DisplayObject | |
| maxHeight : Number
Hauteur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | |
| maxWidth : Number
Largeur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | |
| measuredHeight : Number
Hauteur par défaut du composant, en pixels. | UIComponent | |
| measuredMinHeight : Number
Hauteur minimale par défaut du composant, en pixels. | UIComponent | |
| measuredMinWidth : Number
Largeur minimale par défaut du composant, en pixels. | UIComponent | |
| measuredWidth : Number
Largeur par défaut du composant, en pixels. | UIComponent | |
| metaData : Object
Obtient les données d’objet de métadonnées de l’occurrence DisplayObject si les données d’meta a été stockée près de la l’occurrence de cette DisplayObject dans le fichier SWF à l’aide d’une balise de4 PlaceObject. | DisplayObject | |
| minHeight : Number
Hauteur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | |
| minWidth : Number
Largeur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. | UIComponent | |
| moduleFactory : IFlexModuleFactory
Une fabrique de modules est utilisée comme contexte d’utilisation de polices intégrées et pour la recherche du gestionnaire de style qui contrôle les styles de ce composant. | UIComponent | |
| mouseChildren : Boolean
Détermine si les enfants de l’objet prennent en charge la souris ou les périphériques de saisie utilisateur. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur. | InteractiveObject | |
| mouseFocusEnabled : Boolean
Indique si le composant peut recevoir le focus à l’aide de la souris. | UIComponent | |
| mouseX : Number [lecture seule]
Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | |
| mouseY : Number [lecture seule]
Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | |
| name : String
Indique le nom d’occurrence de DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Indique si un clavier virtuel (clavier logiciel à l’écran) doit s’afficher lorsque cette occurrence d’InteractiveObject reçoit le focus. | InteractiveObject | |
| nestLevel : int
Profondeur de cet objet dans la hiérarchie de confinement. | UIComponent | |
| nonInheritingStyles : Object
Début de la chaîne de styles non hérités de ce composant. | UIComponent | |
| numAutomationChildren : int [lecture seule]
Nombre d’enfants d’automatisation que ce conteneur comporte. | UIComponent | |
| numChildren : int [lecture seule]
Renvoie le nombre d’enfants de l’objet. | DisplayObjectContainer | |
| opaqueBackground : Object
Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique. | DisplayObject | |
| owner : DisplayObjectContainer
Propriétaire de cet objet IVisualElement. | UIComponent | |
| parent : DisplayObjectContainer [override] [lecture seule]
Conteneur ou composant parent de ce composant. | UIComponent | |
| parentAllowsChild : Boolean [lecture seule]
Vérifie si le parent autorise son enfant à accéder à ses objets d’affichage ou à écouter les messages qui prennent leur origine dans le parent. | SWFLoader | ||
| parentApplication : Object [lecture seule]
Référence à l’objet d’application contenant cette instance UIComponent. | UIComponent | |
| parentDocument : Object [lecture seule]
Référence à l’objet de document parent pour ce composant UIComponent. | UIComponent | |
| percentHeight : Number
Spécifie la hauteur d’un composant en tant que pourcentage de la taille de son parent. | UIComponent | |
| percentLoaded : Number [lecture seule]
Pourcentage du fichier image ou SWF déjà chargé. | SWFLoader | ||
| percentWidth : Number
Spécifie la largeur d’un composant en tant que pourcentage de la taille de son parent. | UIComponent | |
| postLayoutTransformOffsets : mx.geom:TransformOffsets
Définit un ensemble de réglages pouvant être appliqué à la transformation d’un objet de manière invisible pour la présentation de son parent. | UIComponent | |
| processedDescriptors : Boolean
Définie sur true après la création d’enfant immédiate ou différée, en fonction de celle effectuée. | UIComponent | |
| repeater : IRepeater [lecture seule]
Référence à l’objet Repeater dans le document parent ayant produit ce composant UIComponent. | UIComponent | |
| repeaterIndex : int [lecture seule]
Index de l’élément dans le fournisseur de données de l’objet Repeater ayant produit ce composant UIComponent. | UIComponent | |
| repeaterIndices : Array
Tableau contenant les indices des éléments dans le fournisseur de données du des objets Repeater dans le document parent ayant produit ce composant UIComponent. | UIComponent | |
| repeaters : Array
Tableau contenant des références aux objets Repeater dans le document parent ayant produit ce composant UIComponent. | UIComponent | |
| right : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | |
| root : DisplayObject [lecture seule]
Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété root correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier. | DisplayObject | |
| rotation : Number [override]
Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine. | UIComponent | |
| rotationX : Number [override]
Indique la rotation de l’axe des x de l’instance DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | UIComponent | |
| rotationY : Number [override]
Indique la rotation de l’axe des y de l’instance DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | UIComponent | |
| rotationZ : Number [override]
Indique la rotation de l’axe des z de l’instance DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | UIComponent | |
| scale9Grid : Rectangle
Grille de mise à l’échelle en vigueur. | DisplayObject | |
| scaleContent : Boolean
Indicateur précisant si le contenu doit être mis à l’échelle pour correspondre à la taille du contrôle ou si le contrôle doit être redimensionné en fonction de la taille du contenu. | SWFLoader | ||
| scaleX : Number [override]
Nombre spécifiant le facteur de mise à l’échelle horizontale. | UIComponent | |
| scaleY : Number [override]
Nombre spécifiant le facteur de mise à l’échelle verticale. | UIComponent | |
| scaleZ : Number [override]
Nombre spécifiant le facteur de mise à l’échelle sur l’axe z. | UIComponent | |
| screen : Rectangle [lecture seule]
Renvoie un objet contenant la taille et la position de la surface de tracé de base pour cet objet. | UIComponent | |
| scrollRect : Rectangle
Cadre de sélection du défilement de l’objet d’affichage. | DisplayObject | |
| showBusyCursor : Boolean
Indicateur précisant si un curseur occupé doit s’afficher pendant le chargement du contenu. | SWFLoader | ||
| showInAutomationHierarchy : Boolean
Indicateur qui détermine si un objet d’automatisation s’affiche dans la hiérarchie d’automatisation. | UIComponent | |
| smoothBitmapContent : Boolean
Indicateur qui signale s’il faut lisser le contenu lorsqu’il est redimensionné. | SWFLoader | ||
| softKeyboard : String
Contrôle l’aspect du clavier logiciel. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Définit la zone qui doit rester à l’écran lorsqu’un clavier logiciel s’affiche (non disponible sur iOS) | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Contrôle le son à l’intérieur du sprite. | Sprite | |
| source : Object
Nom d’URL, d’objet, de classe ou de chaîne d’une classe à charger comme contenu. | SWFLoader | ||
| stage : Stage [lecture seule]
Scène de l’objet d’affichage. | DisplayObject | |
| states : Array
Etats d’affichage définis pour ce composant. | UIComponent | |
| styleDeclaration : CSSStyleDeclaration
Stockage pour les styles d’héritage intégrés sur cet objet. | UIComponent | |
| styleManager : IStyleManager2 [lecture seule]
Renvoie l’instance SystemManager utilisée par ce composant. | UIComponent | |
| styleName : Object
Style de classe utilisé par ce composant. | UIComponent | |
| styleParent : IAdvancedStyleClient
Le parent d’un composant permet d’évaluer les sélecteurs descendants. | UIComponent | |
| swfBridge : IEventDispatcher [lecture seule]
Pont vers l’application qui est associé à l’implémentation de cette interface. | SWFLoader | ||
| systemManager : ISystemManager
Renvoie l’objet SystemManager utilisé par ce composant. | UIComponent | |
| tabChildren : Boolean
Détermine si les enfants de l’objet prennent ou non en charge la tabulation. | DisplayObjectContainer | |
| tabEnabled : Boolean
Indique si cet objet est spécifié dans l’ordre de tabulation. | InteractiveObject | |
| tabFocusEnabled : Boolean
Indicateur qui signale si cet objet peut recevoir le focus via la touche de tabulation. Cette fonction est similaire à la propriété tabEnabled utilisée par le lecteur Flash. Sa valeur est généralement true pour les composants qui gèrent l’entrée au clavier, mais certains composants des barres de contrôle les définissent sur false, car il est conseillé de ne pas voler le focus d’un autre composant (un éditeur, par exemple). | UIComponent | |
| tabIndex : int
Spécifie l’ordre de tabulation des objets dans un fichier SWF. | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [lecture seule]
Renvoie un objet TextSnapshot pour l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | |
| toolTip : String
Texte à afficher dans l’info-bulle. | UIComponent | |
| top : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | |
| transform : flash.geom:Transform [override]
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage. | UIComponent | |
| transformX : Number
Définit la coordonnée x du centre de la transformation du composant. | UIComponent | |
| transformY : Number
Définit la coordonnée y du centre de la transformation du composant. | UIComponent | |
| transformZ : Number
Définit la coordonnée z du centre de la transformation du composant. | UIComponent | |
| transitions : Array
Tableau d’objets de transition, où chaque objet de transition définit un ensemble d’effets à lire lors d’un changement de l’état d’affichage. | UIComponent | |
| trustContent : Boolean
Si la valeur est true, le contenu est chargé dans votre domaine de sécurité. | SWFLoader | ||
| tweeningProperties : Array
Tableau de propriétés en cours d’interpolation sur cet objet. | UIComponent | |
| uid : String
Identifiant unique de l’objet. | UIComponent | |
| updateCompletePendingFlag : Boolean
Indicateur déterminant si un objet a traversé les trois phases de validation de mise en forme (si besoin était). | UIComponent | |
| useHandCursor : Boolean
Valeur booléenne indiquant si le curseur en forme de main apparaît lorsque le pointeur survole un sprite dont la propriété buttonMode est définie sur true. | Sprite | |
| validationSubField : String
Utilisé par un validateur pour associer un sous-champ à ce composant. | UIComponent | |
| verticalCenter : Object
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. | UIComponent | |
| visible : Boolean [override]
Indique si l’objet d’affichage est visible ou non. | UIComponent | |
| width : Number [override]
Nombre définissant la largeur du composant en pixels, dans les coordonnées du parent. | UIComponent | |
| x : Number [override]
Nombre spécifiant la position horizontale du composant, en pixels, au sein de son conteneur parent. | UIComponent | |
| y : Number [override]
Nombre spécifiant la position verticale du composant, en pixels, au sein de son conteneur parent. | UIComponent | |
| z : Number [override]
Indique la position de coordonnée z le long de l’axe des z de l’instance DisplayObject par rapport au conteneur 3D parent. | UIComponent | |
Propriétés protégées
Méthodes publiques
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | SWFLoader | ||
|
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. | DisplayObjectContainer | |
|
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. | DisplayObjectContainer | |
| 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. | EventDispatcher | |
|
Ajoute un client de style non visuel à cette instance de composant. | UIComponent | |
|
Indique si les restrictions de sécurité entraîneraient l’omission des objets d’affichage de la liste renvoyée en appelant la méthode DisplayObjectContainer.getObjectsUnderPoint() avec le point « point » spécifié. | DisplayObjectContainer | |
|
Place en attente une fonction à appeler ultérieurement. | UIComponent | |
|
Définit une propriété de style depuis cette instance de composant. | UIComponent | |
|
Détermine si l’objet d’affichage spécifié est un enfant de l’occurrence de DisplayObjectContainer ou l’occurrence en tant que telle. | DisplayObjectContainer | |
|
Convertit un objet Point de coordonnées de contenu en coordonnées globales. | UIComponent | |
|
Convertit un objet Point de coordonnées de contenu en coordonnées locales. | UIComponent | |
|
Renvoie un ensemble de propriétés qui identifient l’enfant au sein de ce conteneur. | UIComponent | |
|
Renvoie un ensemble de propriétés qui identifient l’enfant au sein de ce conteneur. | UIComponent | |
|
Crée une référence id pour cet objet IUIComponent sur son objet document parent. | UIComponent | |
|
Supprime la référence d’id à cet objet IUIComponent sur son objet de document parent. | UIComponent | |
|
Renvoie un objet UITextFormat correspondant aux styles du texte pour ce composant UIComponent. | UIComponent | |
| [override]
Distribue un événement dans le flux d’événements. | UIComponent | |
|
Affiche ou masque l’indicateur de focus autour de ce composant. | UIComponent | |
| drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
Trace par programmation un rectangle dans l’objet Graphics de cet habillage. | UIComponent | |
|
Appelé par l’instance d’effet lors de la fin de sa lecture sur le composant. | UIComponent | |
|
Appelé par l’instance d’effet lors du début de sa lecture sur le composant. | UIComponent | |
|
Termine tous les effets en cours de lecture sur le composant. | UIComponent | |
|
Exécute toutes les liaisons dont l’objet UIComponent est la destination. | UIComponent | |
|
Appelée après la fin de l’impression. | UIComponent | |
|
Fournit l’objet d’automatisation à l’index spécifié. | UIComponent | |
|
Fournit la liste d’objets d’automatisation. | UIComponent | |
|
Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace. | DisplayObject | |
|
Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée. | UIComponent | |
|
Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée. | UIComponent | |
|
Renvoie l’occurrence enfant de l’objet d’affichage associée à l’index spécifié. | DisplayObjectContainer | |
|
Renvoie l’objet d’affichage enfant portant le nom spécifié. | DisplayObjectContainer | |
|
Renvoie la position d’index d’une occurrence enfant de DisplayObject. | DisplayObjectContainer | |
|
Recherche les sélecteurs de type de cette instance UIComponent. | UIComponent | |
|
Renvoie une valeur de contrainte de présentation, ce qui revient à obtenir le style de contrainte pour ce composant. | UIComponent | |
|
Méthode pratique pour déterminer si la hauteur explicite ou mesurée doit être utilisée
| UIComponent | |
|
Méthode pratique pour déterminer si la largeur explicite ou mesurée doit être utilisée
| UIComponent | |
|
Récupère l’objet ayant actuellement le focus. | UIComponent | |
|
Renvoie la hauteur de présentation de l’élément. | UIComponent | |
|
Renvoie la largeur de la présentation de l’élément. | UIComponent | |
|
Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran. | UIComponent | |
|
Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran. | UIComponent | |
|
Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères. | UIComponent | |
|
Renvoie la matrice Matrix3D de transformation de présentation pour cet élément. | UIComponent | |
|
Renvoie la hauteur maximale de l’élément. | UIComponent | |
|
Renvoie la largeur maximale de l’élément. | UIComponent | |
|
Renvoie la hauteur minimale de l’élément. | UIComponent | |
|
Renvoie la largeur minimale de l’élément. | UIComponent | |
|
Renvoie un tableau d’objets de niveau inférieur au point spécifié et qui sont les enfants (ou les petits-enfants, etc.) de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | |
|
Renvoie la hauteur préférée de l’élément. | UIComponent | |
|
Renvoie la largeur préférée de l’élément. | UIComponent | |
|
Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes. | DisplayObject | |
|
Renvoie l’élément de l’objet dataProvider utilisé par le composant Repeater spécifié pour produire ce composant Repeater, ou null si ce composant Repeater n’est pas répété. | UIComponent | |
|
Extrait une propriété de style ayant été définie n’importe où dans la chaîne de recherche de style de ce composant. | UIComponent | |
Obtenez les limites de l’application chargée qui sont visibles pour l’utilisateur à l’écran. | SWFLoader | ||
|
Convertit un objet Point de coordonnées globales en coordonnées de contenu. | UIComponent | |
|
Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales). | DisplayObject | |
|
Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales). | DisplayObject | |
|
Renvoie true si la valeur currentCSSState n’est pas nulle. | UIComponent | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Détermine si l’état spécifié a été défini sur ce composant UIComponent. | UIComponent | |
|
Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage obj. | DisplayObject | |
|
Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y. | DisplayObject | |
|
Renvoie une matrice de zone pouvant être transmise à la méthode drawRoundRect() en tant que paramètre rot lors du tracé d’un dégradé horizontal. | UIComponent | |
|
Initialise la structure interne de ce composant. | UIComponent | |
|
Initialise différentes propriétés qui effectuent le suivi des instances répétées de ce composant. | UIComponent | |
|
Marque un composant de sorte que sa méthode updateDisplayList() soit appelée au cours d’une actualisation d’écran ultérieure. | UIComponent | |
|
Appelé par les éléments d’un composant pour indiquer que leur propriété de profondeur a changé. | UIComponent | |
|
Un élément doit appeler cette méthode lorsque la direction de la mise en forme change ou lorsque la direction de la mise en forme de son parent change. | UIComponent | |
|
Marque un composant de sorte que sa méthode commitProperties() soit appelée au cours d’une actualisation d’écran ultérieure. | UIComponent | |
|
Marque un composant de sorte que sa méthode measure() soit appelée au cours d’une actualisation d’écran ultérieure. | UIComponent | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
Charge une image ou un fichier SWF. | SWFLoader | ||
|
Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales). | DisplayObject | |
|
Convertit un objet Point de coordonnées locales en coordonnées de contenu. | UIComponent | |
|
Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales). | DisplayObject | |
|
Renvoie la valeur true si cssState correspond à currentCSSState. | UIComponent | |
|
Détermine si l’instance est identique au, ou est une sous-classe du, type donné. | UIComponent | |
|
Mesure le texte HTML spécifié, pouvant contenir des balises HTML telles que <font> et <b>, en supposant qu’il s’affiche sur un objet UITextField à une seule ligne, avec un format UITextFormat déterminé par les styles de ce composant UIComponent. | UIComponent | |
|
Mesure le texte spécifié, en supposant qu’il s’affiche sur un objet UITextField (ou UIFTETextField) à une seule ligne, avec un format UITextFormat déterminé par les styles de ce composant UIComponent. | UIComponent | |
|
Déplace le composant vers une position spécifiée dans son parent. | UIComponent | |
|
Propage les modifications de style aux enfants. | UIComponent | |
|
Renvoie true si la chaîne de propriétés du propriétaire pointe de l’enfant vers ce composant UIComponent. | UIComponent | |
|
Appelé par Flex lorsqu’un composant UIComponent est ajouté à ou supprimé d’un parent. | UIComponent | |
|
Prépare un objet IFlexDisplayObject pour l’impression. | UIComponent | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Génère ou régénère le cache de style CSS pour ce composant et, si le paramètre recursive a la valeur true, pour tous les descendants de ce composant également. | UIComponent | |
|
Pour chaque événement d’effet, enregistre le gestionnaire EffectManager comme l’un des écouteurs d’événement. | UIComponent | |
|
Supprime l’occurrence enfant de DisplayObject spécifiée de la liste d’enfants de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | |
|
Supprime une occurrence enfant de DisplayObject de la position d’index spécifiée dans la liste d’enfants de DisplayObjectContainer. | DisplayObjectContainer | |
|
Supprime toutes les occurrences enfants de DisplayObject de la liste d’enfants de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Supprime un client de style non visuel de cette instance de composant. | UIComponent | |
|
Réexécute l’événement spécifié. | UIComponent | |
|
Affiche un clavier virtuel. | InteractiveObject | |
|
Résout un enfant en utilisant l’ID fourni. | UIComponent | |
| [statique]
Reprend le traitement en arrière-plan des méthodes mises en attente par la méthode callLater(), après un appel à la méthode suspendBackgroundProcessing(). | UIComponent | |
|
Dimensionne l’objet. | UIComponent | |
|
Modifie la position d’un enfant existant dans le conteneur d’objet d’affichage. | DisplayObjectContainer | |
|
Définit une valeur de contrainte de présentation, ce qui revient à définir le style de contrainte pour ce composant. | UIComponent | |
|
Définir l’état actuel. | UIComponent | |
|
Définit le focus sur ce composant. | UIComponent | |
|
Définit les coordonnées utilisées par l’élément pour son affichage à l’écran. | UIComponent | |
|
Définit la taille de la présentation de l’élément. | UIComponent | |
|
Définit la matrice de transformation utilisée pour calculer la taille de présentation et la position du composant par rapport à ses frères. | UIComponent | |
|
Définit la matrice de transformation Matrix3D utilisée pour calculer la taille et la position de la présentation du composant par rapport à ses frères. | UIComponent | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Définit une propriété de style pour cette instance de composant. | UIComponent | |
|
Appelé lorsque la propriété visible est modifiée. | UIComponent | |
|
Permet à l’utilisateur de faire glisser le sprite spécifié. | Sprite | |
|
Permet à l’utilisateur de faire glisser le sprite spécifié sur un périphérique tactile. | Sprite | |
|
Interrompt de façon récursive l’exécution du scénario de tous les clips ayant cet objet comme racine. | DisplayObjectContainer | |
|
Met fin à la méthode startDrag(). | Sprite | |
|
Met fin à la méthode startTouchDrag() en vue d’utiliser des périphériques tactiles. | Sprite | |
|
Détecte les modifications apportées aux propriétés de style. | UIComponent | |
|
Flex() appelle la méthode stylesInitialized() lorsque les styles d’un composant sont d’abord initialisés. | UIComponent | |
| [statique]
Bloque le traitement en arrière-plan des méthodes placées en attente par callLater(), jusqu’à l’appel de la méthode resumeBackgroundProcessing(). | UIComponent | |
|
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des deux objets enfant spécifiés. | DisplayObjectContainer | |
|
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des objets enfant aux deux positions d’index spécifiées dans la liste d’enfants. | DisplayObjectContainer | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
| [override]
Renvoie une chaîne indiquant l’emplacement de l’objet dans la hiérarchie des objets DisplayObject de l’application. | FlexSprite | |
| transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
Méthode d’utilitaire permettant de mettre à jour la rotation, la mise à l’échelle et la translation de la transformation tout en conservant un point particulier, spécifié dans l’espace de coordonnées du composant, fixe dans l’espace de coordonnées du parent. | UIComponent | |
|
Méthode utilitaire permettant de transformer un point spécifié dans les coordonnées locales de cet objet en emplacement dans les coordonnées du parent de l’objet. | UIComponent | |
Décharge une image ou un fichier SWF. | SWFLoader | ||
|
Valide la position et la taille des enfants, et trace d’autres effets visuels. | UIComponent | |
|
Valide et actualise les propriétés et la présentation de cet objet, puis le retrace si nécessaire. | UIComponent | |
|
Utilisé par la logique de présentation pour valider les propriétés d’un composant par l’appel de la méthode commitProperties(). | UIComponent | |
|
Valide la taille mesurée du composant si la méthode LayoutManager.invalidateSize() est appelée avec cette interface ILayoutManagerClient, puis la méthode validateSize() est appelée lorsqu’il est temps d’effectuer les mesures. | UIComponent | |
|
Traite à la fois les événements valid et invalid d’une classe Validator assignée à ce composant. | UIComponent | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Renvoie une matrice de zone pouvant être transmise à la méthode drawRoundRect() en tant que paramètre rot lors du tracé d’un dégradé vertical. | UIComponent | |
|
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é. | EventDispatcher | |
Méthodes protégées
Evénements
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| Distribué lorsque le composant est ajouté à un conteneur en tant que contenu enfant à l’aide de la méthode addChild(), addChildAt(), addElement() ou addElementAt(). | UIComponent | ||
| Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage. | DisplayObject | ||
| Envoyé lorsqu’un objet d’affichage est ajouté dans la liste d’affichage de la scène, directement ou par l’intermédiaire d’une arborescence secondaire qui contient l’objet d’affichage. | DisplayObject | ||
| Distribué lorsque l’utilisateur sélectionne ’Effacer’ (ou ’Supprimer’) dans le menu contextuel. | InteractiveObject | ||
| Distribué lorsque l’utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsque le chargement du contenu est terminé. | SWFLoader | |||
| Distribué lorsque l’action d’un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR. | InteractiveObject | ||
| Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne "Copier" dans le menu contextuel. | InteractiveObject | ||
| Distribué lorsque le composant a terminé sa construction, son traitement de propriétés, sa mesure, sa présentation et son tracé. | UIComponent | ||
| Distribué après la modification de l’état d’affichage. | UIComponent | ||
| Distribué après la modification de la propriété currentState, mais avant la modification de l’état d’affichage. | UIComponent | ||
| Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne "Couper" dans le menu contextuel. | InteractiveObject | ||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué lorsque l’utilisateur appuie sur le bouton principal d’un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d’InteractiveObject si l’indicateur doubleClickEnabled de cet objet est réglé sur true. | InteractiveObject | ||
| Distribué par l’initiateur de l’action glisser (le composant source des données en cours de déplacement) lorsque l’opération de glissement se termine, lorsque vous déposez les données glissées sur une cible de dépôt ou lorsque vous terminez l’opération de glisser-déposer sans avoir effectué un dépôt. | UIComponent | ||
| Distribué par la cible de dépôt lorsque l’utilisateur libère le bouton de la souris au-dessus de la cible. | UIComponent | ||
| Distribué par un composant lorsque l’utilisateur passe le pointeur de la souris sur le composant pendant une opération de déplacement. | UIComponent | ||
| Distribué par le composant lorsque l’utilisateur effectue un déplacement en dehors du composant, mais ne dépose pas les données sur la cible. | UIComponent | ||
| Distribué par un composant lorsque l’utilisateur déplace la souris en survolant le composant pendant une opération de glissement. | UIComponent | ||
| Distribué par l’initiateur du déplacement lors du démarrage d’une opération de déplacement. | UIComponent | ||
| Distribué après la fin d’un effet. | UIComponent | ||
| Distribué juste avant le démarrage d’un effet. | UIComponent | ||
| Distribué après l’arrêt d’un effet, ce qui se produit uniquement par l’appel de la méthode stop() sur l’effet. | UIComponent | ||
| [événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image. | DisplayObject | ||
| Distribué après l’entrée du composant dans un état d’affichage. | UIComponent | ||
| [événement de diffusion] Distribué lorsque la tête de lecture quitte l’image en cours. | DisplayObject | ||
| Distribué juste avant que le composant quitte un état d’affichage. | UIComponent | ||
| Distribué après la prise de focus par un objet d’affichage. | InteractiveObject | ||
| Distribué après la perte de focus par un objet d’affichage. | InteractiveObject | ||
| [événement de diffusion] Distribué après l’exécution des constructeurs des objets d’affichage d’image, mais avant celle des scripts d’image. | DisplayObject | ||
| Distribué lorsque l’utilisateur crée un point de contact le long du bord de la surface tactile à l’aide d’une occurrence InteractiveObject (par exemple, en appuyant le long du bord de la surface tactile sur la télécommande Siri Remote pour l’Apple TV). Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements tactiles. | InteractiveObject | ||
| Distribué lorsque l’utilisateur appuie sur deux points de contact sur la même occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsque l’utilisateur appuie avec deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les retire). | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace un point de contact sur l’occurrence d’InteractiveObject d’un périphérique tactile (notamment lorsqu’il déplace un doigt de gauche à droite sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur effectue un mouvement de rotation sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les fait pivoter). | InteractiveObject | ||
| Distribué lorsque l’utilisateur effectue un mouvement de glissement sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose trois doigts puis les déplace parallèlement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur crée un point de contact à l’aide d’une occurrence d’InteractiveObject, puis appuie brièvement sur un périphérique tactile (notamment lorsqu’il place plusieurs doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile pour ouvrir un menu, puis appuie brièvement avec un doigt pour sélectionner une option de menu). | InteractiveObject | ||
| Distribué lorsque l’utilisateur effectue un mouvement de zoom sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts, puis les écarte rapidement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsqu’un objet passe de l’état visible à l’état invisible. | UIComponent | ||
| Distribué lorsqu’une requête réseau est envoyée via le protocole HTTP et que Flash Player ou AIR peut détecter le code d’état HTTP. | SWFLoader | |||
| Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME. | InteractiveObject | ||
| Distribué lorsqu’il est possible d’accéder aux propriétés et aux méthodes d’un fichier SWF chargé. | SWFLoader | |||
| Distribué lorsque le composant a terminé sa construction et dispose de toutes les propriétés d’initialisation définies. | UIComponent | ||
| Distribué si un composant est contrôlé par un validateur et que la validation a échoué. | UIComponent | ||
| Distribué lorsqu’une erreur d’entrée/sortie se produit. | SWFLoader | |||
| Distribué lorsque l’utilisateur appuie sur une touche. | InteractiveObject | ||
| Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier. | InteractiveObject | ||
| Distribué lorsque l’utilisateur relâche une touche. | InteractiveObject | ||
| Distribué lorsque l’utilisateur appuie sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | ||
| Distribué par un composant ouvert à l’aide du gestionnaire PopUpManager lorsque l’utilisateur clique en dehors du composant. | UIComponent | ||
| Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage. | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | ||
| Distribué lorsque la molette d’une souris est actionnée sur une occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué à partir d’un composant ouvert à l’aide du gestionnaire PopUpManager lorsque l’utilisateur fait défiler la molette de la souris en dehors de celui-ci. | UIComponent | ||
| Distribué lorsque l’objet a été déplacé. | UIComponent | ||
| Distribué par l’initiateur glisser InteractiveObject lorsque l’utilisateur arrête l’opération glisser. | InteractiveObject | ||
| Distribué par l’objet InteractiveObject cible lorsqu’un objet glissé est déposé dessus et que l’opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop(). | InteractiveObject | ||
| Distribué par un InteractiveObject lorsqu’une opération glisser entre dans ses limites. | InteractiveObject | ||
| Distribué par un InteractiveObject lorsqu’une opération glisser sort des limites. | InteractiveObject | ||
| Distribué par un objet InteractiveObject de façon continue lorsqu’une opération glisser reste dans ses limites. | InteractiveObject | ||
| Distribué au début d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag(). | InteractiveObject | ||
| Distribué lors d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag(). | InteractiveObject | ||
| Distribué lors du démarrage d’une opération réseau. | SWFLoader | |||
| Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de collage ou sélectionne "Coller" dans le menu contextuel. | InteractiveObject | ||
| Distribué au début de la séquence d’initialisation du composant. | UIComponent | ||
| Distribué lors du chargement de contenu. | SWFLoader | |||
| Distribué lorsque l’utilisateur approche un stylet actif de l’écran après le seuil de détection de proximité de l’écran. | InteractiveObject | ||
| Distribué lorsque l’utilisateur soulève un stylet actif au-dessus du seuil de détection de proximité de l’écran. | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace un stylet actif sur l’écran tout en respectant le seuil de détection de proximité. | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace un stylet actif en dehors de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace un stylet actif directement au-dessus de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace un stylet actif hors de cet objet InteractiveObject et de l’un de ses enfants, tout en respectant le seuil de détection de proximité de l’écran. | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace un stylet actif sur cet objet InteractiveObject de l’extérieur de l’arborescence d’objets de descendants dans la liste d’affichage (tout en respectant le seuil de détection de proximité de l’écran). | InteractiveObject | ||
| Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage après avoir appuyé sur le bouton sur une occurrence d’InteractiveObject, puis après avoir déplacé le périphérique de pointage hors de l’occurrence d’InteractiveObject. | InteractiveObject | ||
| Distribué lorsque le composant est supprimé d’un conteneur en tant que contenu enfant en utilisant la méthode removeChild(), removeChildAt(), removeElement() ou removeElementAt(). | UIComponent | ||
| Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage. | DisplayObject | ||
| Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage de la scène, directement ou par l’intermédiaire de la suppression d’une arborescence secondaire qui contient l’objet d’affichage. | DisplayObject | ||
| [événement de diffusion] Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et restituée. | DisplayObject | ||
| Distribué lorsque le composant est redimensionné. | UIComponent | ||
| Distribué lorsque l’utilisateur appuie sur le bouton droit de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject. | InteractiveObject | ||
| Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject. | InteractiveObject | ||
| Distribué lorsqu’une erreur de sécurité se produit pendant le chargement du contenu. | SWFLoader | |||
| Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour tout sélectionner ou choisit "Sélectionner tout" dans le menu contextuel. | InteractiveObject | ||
| Distribué lorsqu’un objet passe de l’état invisible à l’état visible. | UIComponent | ||
| Distribué immédiatement après l’affichage du clavier logiciel. | InteractiveObject | ||
| Distribué immédiatement avant l’affichage du clavier logiciel. | InteractiveObject | ||
| Distribué immédiatement après la disparition du clavier logiciel. | InteractiveObject | ||
| Distribué après le basculement du composant dans un nouvel état et après la lecture de toute animation de transition d’état vers cet état. | UIComponent | ||
| Distribué lorsqu’un composant interrompt une transition à son état actuel afin de basculer dans un nouvel état. | UIComponent | ||
| Distribué lorsque la valeur de l’indicateur tabChildren de l’objet change. | InteractiveObject | ||
| Distribué lorsque l’indicateur tabEnabled de l’objet change. | InteractiveObject | ||
| Distribué lorsque la valeur de la propriété tabIndex de l’objet change. | InteractiveObject | ||
| Distribué lorsqu’un utilisateur entre un ou plusieurs caractères de texte. | InteractiveObject | ||
| Distribué par le composant lorsqu’il est nécessaire de créer un composant ToolTip. | UIComponent | ||
| Distribué par le composant lorsque son objet ToolTip a été masqué et va être rapidement supprimé. | UIComponent | ||
| Distribué par le composant lorsque son composant ToolTip est sur le point d’être masqué. | UIComponent | ||
| Distribué par le composant lorsque son composant ToolTip est sur le point d’être affiché. | UIComponent | ||
| Distribué par le composant lorsque son composant ToolTip a été affiché. | UIComponent | ||
| Distribué par un composant dont la propriété toolTip est définie, dès que l’utilisateur le survole avec la souris. | UIComponent | ||
| Distribué lorsque l’utilisateur touche pour la première fois un périphérique tactile (notamment lorsqu’il pose un doigt sur un téléphone portable ou une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur cesse le contact avec un périphérique tactile (notamment lorsqu’il retire le doigt d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | ||
| Evénement non annulable, distribué par un composant lorsque celui-ci a terminé de réagir à un geste d’interaction tactile de l’utilisateur. | UIComponent | ||
| Evénement non annulable, distribué par un composant lorsque celui-ci commence à réagir à un geste d’interaction tactile de l’utilisateur. | UIComponent | ||
| Evénement annulable, distribué par un composant tentant de réagir à un geste d’interaction tactile de l’utilisateur. | UIComponent | ||
| Distribué lorsque l’utilisateur appuie sur le périphérique, et est continuellement distribué jusqu’au retrait du point de contact. | InteractiveObject | ||
| Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un objet d’affichage vers un autre sur un téléphone portable ou une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un se trouvant sur l’objet d’affichage d’un téléphone portable ou une tablette munis d’un écran tactile vers un point se trouvant en dehors de cet objet). | InteractiveObject | ||
| Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile). | InteractiveObject | ||
| Distribué lorsque l’utilisateur lève le point de contact sur la même occurrence d’InteractiveObject sur laquelle le contact a été lancé sur un périphérique tactile (notamment lorsqu’il appuie avec un doigt à partir d’un point de contact unique sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis le retire). | InteractiveObject | ||
| Distribué lorsqu’un objet chargé est supprimé ou lorsqu’un second chargement est effectué par le même contrôle SWFLoader et que le contenu d’origine est supprimé avant le début du nouveau chargement. | SWFLoader | |||
| Distribué lorsque les méthodes commitProperties(), measure() et updateDisplayList() d’un objet ont été appelées (si nécessaire). | UIComponent | ||
| Distribué si un composant est contrôlé par un validateur et que la validation a réussi. | UIComponent | ||
| Distribué lorsque les valeurs sont modifiées soit par programmation, soit par interaction de l’utilisateur. | UIComponent | ||
Styles
Les styles sont soit communs soit associés à un thème spécifique. Si le style est commun, il peut être utilisé avec n’importe quel thème. Si un style est associé à un thème spécifique, il ne peut être utilisé que si votre application utilise ce thème.
Styles communs
| Style | Description | Défini par | ||
|---|---|---|---|---|
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance verticale en pixels du bord supérieur de la zone de contenu à la position de la ligne de base de la commande. | UIComponent | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance verticale, en pixels, entre le bord inférieur du composant et le bord inférieur de la zone de contenu de son conteneur parent. | UIComponent | ||
brokenImageBorderSkin | Type: Class Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Nom de la classe à utiliser comme habillage de bordure SWFLoader si le contrôle ne parvient pas à charger le contenu. La valeur par défaut est BrokenImageBorderSkin. | SWFLoader | ||
brokenImageSkin | Type: Class Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Nom de la classe à utiliser comme habillage SWFLoader si le contrôle ne parvient pas à charger le contenu. La valeur par défaut est le symbole « __brokenImage » du fichier Assets.swf. | SWFLoader | ||
| Type: uint Format: Color Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Couleur de surbrillance du composant lorsque la validation échoue. | UIComponent | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Mode de fusion utilisé par le rectangle de focus. | UIComponent | ||
| Type: Class Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Habillage utilisé pour tracer le rectangle de focus. | UIComponent | ||
| Type: Number Format: Length Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Epaisseur du contour du rectangle de focus, en pixels. | UIComponent | ||
horizontalAlign | Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Alignement horizontal du contenu si aucune proportion de un à un ne lui est affectée. Les valeurs possibles sont "left", "center" et "right".
La valeur par défaut est "left". | SWFLoader | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance horizontale, en pixels, entre le centre de la zone de contenu et celui du composant. | UIComponent | ||
| Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 4.5 Versions du moteur d’exécution: Flash10, AIR 2.5 Le principal mode d’interaction pour ce composant. | UIComponent | ||
| Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 4.1 Versions du moteur d’exécution: Flash10, AIR 1.5 Spécifie la direction de mise en forme souhaitée d’un composant. | UIComponent | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance horizontale, en pixels, du bord gauche du composant au bord gauche de la zone de contenu de son conteneur parent. | UIComponent | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance horizontale, en pixels, du bord droit du composant au bord droit de la zone de contenu de son conteneur parent. | UIComponent | ||
| Type: Boolean Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 4.5 Versions du moteur d’exécution: Flash10, AIR 1.5 Montrer l’erreur bordure ou enveloppe lorsque ce composant n’est pas valide. | UIComponent | ||
| Type: Boolean Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 4.5 Versions du moteur d’exécution: Flash10, AIR 1.5 Afficher l’erreur-bulle lorsque ce composant n’est pas valide et que l’utilisateur pointe le curseur dessus | UIComponent | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance verticale, en pixels, entre le bord supérieur du composant et le bord supérieur de la zone de contenu de son conteneur parent. | UIComponent | ||
verticalAlign | Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Alignement vertical du contenu si aucune proportion de un à un ne lui est affectée. Valeurs possibles : "top", "middle" et "bottom".
La valeur par défaut est "top". | SWFLoader | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance verticale, en pixels, du centre de la zone de contenu du composant au centre du composant. | UIComponent | ||
Styles du thème Halo
Effets
| Effet | Description | Défini par | ||
|---|---|---|---|---|
| Evénement déclenchant: added Lue lorsque le composant est ajouté en tant qu’enfant à un conteneur. | UIComponent | ||
completeEffect | Evénement déclenchant: complete Effet qui commence lorsque l’événement complete est distribué. | SWFLoader | ||
| Evénement déclenchant: creationComplete Lue lorsque le composant est créé. | UIComponent | ||
| Evénement déclenchant: focusIn Lue lorsque le composant obtient le focus du clavier. | UIComponent | ||
| Evénement déclenchant: focusOut Lue lorsque le composant perd le focus du clavier. | UIComponent | ||
| Evénement déclenchant: hide Lue lorsque le composant devient invisible. | UIComponent | ||
| Evénement déclenchant: mouseDown Lue lorsque l’utilisateur appuie sur le bouton de la souris pendant qu’elle est située sur le composant. | UIComponent | ||
| Evénement déclenchant: mouseUp Lue lorsque l’utilisateur relâche le bouton de la souris pendant qu’elle est située sur le composant. | UIComponent | ||
| Evénement déclenchant: move Lue lorsque le composant est déplacé. | UIComponent | ||
| Evénement déclenchant: removed Lue lorsque le composant est supprimé d’un conteneur. | UIComponent | ||
| Evénement déclenchant: resize Lue lorsque le composant est redimensionné. | UIComponent | ||
| Evénement déclenchant: rollOut Lue lorsque l’utilisateur déplace la souris pour enlever le curseur du composant. | UIComponent | ||
| Evénement déclenchant: rollOver Lue lorsque l’utilisateur déplace la souris sur le composant. | UIComponent | ||
| Evénement déclenchant: show Lue lorsque le composant devient visible. | UIComponent | ||
Constantes publiques
Détails de la propriété
autoLoad | propriété |
autoLoad:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicateur précisant si le contenu commence automatiquement à être chargé ou s’il attend l’appel de la méthode load(). Si la valeur est true, le contenu est chargé automatiquement. Si la valeur est false, vous devez appeler la méthode load().
La valeur par défaut est true.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement autoLoadChanged .
Implémentation
public function get autoLoad():Boolean public function set autoLoad(value:Boolean):voidbytesLoaded | propriété |
bytesLoaded:Number [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 |
Nombre d’octets du fichier SWF ou image déjà chargé.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement progress .
Implémentation
public function get bytesLoaded():NumberbytesTotal | propriété |
bytesTotal:Number [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 totale du fichier SWF ou image.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement complete .
Implémentation
public function get bytesTotal():NumberchildAllowsParent | propriété |
childAllowsParent: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 |
Vérifie si l’enfant autorise son parent à accéder à ses objets d’affichage ou à écouter les messages qui prennent leur origine dans l’enfant. La valeur est true si l’accès est autorisé. Sinon, la valeur est false.
Implémentation
public function get childAllowsParent():Booleancontent | propriété |
content:DisplayObject [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 |
Cette propriété contient l’objet représentant le contenu qui a été chargé dans le contrôle SWFLoader.
Implémentation
public function get content():DisplayObjectcontentHeight | propriété |
contentHeight:Number [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 |
Hauteur du contenu mis à l’échelle et chargé par le contrôle, en pixels. Notez qu’il ne s’agit pas de la hauteur du contrôle, mais de celle du contenu chargé. Utilisez la propriété height du contrôle pour obtenir sa hauteur.
La valeur de cette propriété n’est pas finale lorsque l’événement complete est déclenché. Vous pouvez obtenir la valeur après le déclenchement de l’événement updateComplete.
La valeur par défaut est NaN.
Implémentation
public function get contentHeight():NumbercontentWidth | propriété |
contentWidth:Number [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 |
Largeur du contenu mis à l’échelle et chargé par le contrôle, en pixels. Notez qu’il ne s’agit pas de la largeur du contrôle, mais de celle du contenu chargé. Utilisez la propriété width du contrôle pour obtenir sa largeur.
La valeur de cette propriété n’est pas finale lorsque l’événement complete est déclenché. Vous pouvez obtenir la valeur après le déclenchement de l’événement updateComplete.
La valeur par défaut est NaN.
Implémentation
public function get contentWidth():NumberloaderContext | propriété |
loaderContext:LoaderContext| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Objet LoaderContext à utiliser pour contrôler le chargement du contenu. Il s’agit d’une propriété avancée. La plupart du temps, vous pouvez utiliser la propriété trustContent.
La valeur par défaut est null, ce qui entraîne le contrôle à utiliser la propriété trustContent pour créer un objet LoaderContext que vous pouvez relire une fois le chargement commencé.
Pour utiliser un objet LoaderContext personnalisé, vous devez comprendre les classes SecurityDomain et ApplicationDomain. La définition de cette propriété ne lance pas un chargement. Vous devez la définir avant le début du chargement. Cela ne signifie pas que vous devez définir la propriété autoLoad sur false, car le chargement ne commence pas immédiatement. Mais attendre que l’événement creationComplete la définisse est trop tard.
La valeur par défaut est null.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement loaderContextChanged .
Implémentation
public function get loaderContext():LoaderContext public function set loaderContext(value:LoaderContext):voidEléments de l’API associés
loadForCompatibility | propriété |
loadForCompatibility:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicateur précisant si le contenu est chargé afin qu’il puisse interagir avec des applications de version différente du compilateur Flex. La compatibilité avec d’autres applications Flex s’effectue en chargeant l’application dans une classe ApplicationDomain sœur (ou homologue). Cet indicateur est ignoré si le contenu doit être chargé dans un objet SecurityDomain différent. Si la valeur est true, le contenu est chargé dans une classe ApplicationDomain sœur. Si la valeur est false, le contenu est chargé dans une classe ApplicationDomain enfant.
La valeur par défaut est false.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement loadForCompatibilityChanged .
Implémentation
public function get loadForCompatibility():Boolean public function set loadForCompatibility(value:Boolean):voidmaintainAspectRatio | propriété |
maintainAspectRatio:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicateur précisant si les proportions du contenu chargé doivent être conservées. Si la valeur est true, indique que l’image doit s’afficher avec les mêmes proportions de hauteur à largeur que l’image d’origine.
La valeur par défaut est true.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement maintainAspectRatioChanged .
Implémentation
public function get maintainAspectRatio():Boolean public function set maintainAspectRatio(value:Boolean):voidparentAllowsChild | propriété |
parentAllowsChild: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 |
Vérifie si le parent autorise son enfant à accéder à ses objets d’affichage ou à écouter les messages qui prennent leur origine dans le parent. La valeur est true si l’accès est autorisé. Sinon, la valeur est false.
Implémentation
public function get parentAllowsChild():BooleanpercentLoaded | propriété |
percentLoaded:Number [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 |
Pourcentage du fichier image ou SWF déjà chargé.
La valeur par défaut est 0.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement progress .
Implémentation
public function get percentLoaded():NumberscaleContent | propriété |
scaleContent:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicateur précisant si le contenu doit être mis à l’échelle pour correspondre à la taille du contrôle ou si le contrôle doit être redimensionné en fonction de la taille du contenu. Si la valeur est true, le contenu est mis à l’échelle pour correspondre au contrôle SWFLoader. Si la valeur est false, le contrôle SWFLoader est mis à l’échelle en fonction du contenu.
La valeur par défaut est true.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement scaleContentChanged .
Implémentation
public function get scaleContent():Boolean public function set scaleContent(value:Boolean):voidshowBusyCursor | propriété |
showBusyCursor:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicateur précisant si un curseur occupé doit s’afficher pendant le chargement du contenu. Si la valeur est true, un curseur occupé s’affiche pendant le chargement du contenu. Le curseur occupé par défaut est l’instance mx.skins.halo.BusyCursor telle qu’elle est définie par la propriété busyCursor de la classe CursorManager.
La valeur par défaut est false.
Implémentation
public function get showBusyCursor():Boolean public function set showBusyCursor(value:Boolean):voidEléments de l’API associés
smoothBitmapContent | propriété |
smoothBitmapContent:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicateur qui signale s’il faut lisser le contenu lorsqu’il est redimensionné. Seul un contenu Bitmap peut être lissé. Si la valeur est true et le contenu est un Bitmap, alors la propriété de lissage du contenu est définie sur true. Si la valeur est false, le contenu n’est pas lissé.
La valeur par défaut est false.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement smoothBitmapContentChanged .
Implémentation
public function get smoothBitmapContent():Boolean public function set smoothBitmapContent(value:Boolean):voidsource | propriété |
source:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nom d’URL, d’objet, de classe ou de chaîne d’une classe à charger comme contenu. La propriété source prend la forme suivante :
source="URLOrPathOrClass"
source="@Embed(source='PathOrClass')"
La valeur de la propriété source représente une URL relative ou absolue, un objet ByteArray représentant un fichier SWF, GIF, JPEG ou PNG, un objet qui implémente l’objet IFlexDisplayObject, une classe dont le type implémente l’objet IFlexDisplayObject ou une chaîne qui représente une classe.
Lorsque vous spécifiez un chemin d’accès à un fichier SWF, GIF, JPEG, PNG ou SVG, Flex convertit automatiquement le fichier dans le type de données approprié pour l’utiliser avec le contrôle SWFLoader.
Si vous omettez la déclaration Embed, Flex charge le fichier référencé au moment de l’exécution. Il ne fait pas partie du fichier SWF généré. Au moment de l’exécution, la propriété source ne prend en charge que le chargement des images GIF, JPEG, PNG et des fichiers SWF.
Les utilisateurs de Flex Data Services peuvent utiliser le contrôle SWFLoader pour charger une application Flex des façons suivantes :
source="MXMLPath.mxml.swf"
Flex Data Services compile le fichier MXML et renvoie le fichier SWF vers l’application principale. Cette technique fonctionne parfaitement avec les fichiers SWF qui ajoutent des graphiques ou des animations à une application, mais ils ne sont pas conçus pour contenir un grand nombre d’interactions utilisateur. Si vous importez des fichiers SWF qui nécessitent un grand nombre d’interactions utilisateur, vous devez les créer en tant que composants personnalisés.
La valeur par défaut est null.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement sourceChanged .
Implémentation
public function get source():Object public function set source(value:Object):voidswfBridge | propriété |
swfBridge:IEventDispatcher [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 |
Pont vers l’application qui est associé à l’implémentation de cette interface. Objet IEventDispatcher pouvant servir à envoyer des événements à une application dans un objet ApplicationDomain différent ou un sandbox différent.
Implémentation
public function get swfBridge():IEventDispatchertrustContent | propriété |
trustContent:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Si la valeur est true, le contenu est chargé dans votre domaine de sécurité. Cela signifie que le chargement échoue si le contenu se trouve dans un autre domaine et que ce domaine n’est pas doté de fichier crossdomain.xml qui autorise votre domaine à y accéder. Cette propriété n’a un effet que sur le prochain chargement. Elle ne commence pas un nouveau chargement sur un contenu déjà chargé.
La valeur par défaut est false, ce qui signifie que tout contenu est chargé sans échec, mais vous ne pouvez pas accéder au contenu. Plus important encore, le contenu chargé n’a pas accès à vos objets ni au code, ce qui constitue le scénario le plus sûr. Ne définissez pas cette propriété sur true sauf si vous êtes absolument certain de la sécurité du contenu chargé, particulièrement en ce qui concerne le contenu actif comme les fichiers SWF.
Si la définition de la propriété trustContent ne répond pas parfaitement à vos besoins, vous pouvez également utiliser la propriété loaderContext pour déterminer de façon exacte le mode de chargement du contenu. La propriété loaderContext entraîne le contrôle SWFLoader à ignorer la valeur de la propriété trustContent. Vous devez cependant connaître les classes SecurityDomain et ApplicationDomain pour utiliser la propriété loaderContext.
La valeur par défaut est false.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement trustContentChanged .
Implémentation
public function get trustContent():Boolean public function set trustContent(value:Boolean):voidEléments de l’API associés
Détails du constructeur
SWFLoader | () | Constructeur |
public function SWFLoader()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
Détails de la méthode
getVisibleApplicationRect | () | méthode |
public function getVisibleApplicationRect(allApplications: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
allApplications:Boolean (default = false)true, toutes les applications sont utilisées pour rechercher la zone visible. Sinon, seuls les objets d’affichage de cette application sont utilisés.
|
Rectangle — Objet Rectangle incluant la portion visible de cet objet. Le rectangle utilise les coordonnées globales.
|
load | () | méthode |
public function load(url:Object = null):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Charge une image ou un fichier SWF. L’argument url peut faire référence à un fichier GIF, JPEG, PNG ou SWF. Vous ne pouvez pas utiliser cette méthode pour charger un fichier SVG. Vous devez en revanche le charger à l’aide d’une déclaration Embed avec la propriété source.
Paramètres
url:Object (default = null) |
unloadAndStop | () | méthode |
public function unloadAndStop(invokeGarbageCollector:Boolean = true):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écharge une image ou un fichier SWF. Au retour de cette méthode, la valeur de la propriété source est null. Cela est uniquement pris en charge si le Flash Player hôte est de version 10 ou supérieure. Si le Flash Player hôte est inférieur à la version 10, cette méthode décharge le contenu comme si la propriété source avait la valeur null. Cette méthode tente de décharger les fichiers SWF qui ont été chargés en supprimant les références aux objets EventDispatcher, NetConnection, Timer, Sound ou Video du fichier SWF enfant. Par conséquent, les actions suivantes sont effectuées dans le fichier SWF enfant et la liste d’affichage du fichier SWF enfant :
- Les sons sont arrêtés.
- Les écouteurs d’événement sont supprimés de la scène.
- Les écouteurs d’événement des événements
enterFrame,frameConstructed,exitFrame,activateetdeactivatesont supprimés. - Les horloges sont arrêtées.
- Les occurrences Camera et Microphone sont détachées.
- Les clips sont arrêtés.
Paramètres
invokeGarbageCollector:Boolean (default = true)true) ou pas (false). Si vous déchargez plusieurs objets de façon asynchrone, définissez le paramètre gc sur false afin d’améliorer les performances de l’application. Toutefois, si ce paramètre est défini sur false, les objets multimédia et les objets d’affichage du fichier SWF enfant peuvent rester en mémoire après le déchargement du fichier SWF enfant.
|
Détails de l’événement
complete | Evénement |
Type d’objet d’événement:
propriété Event.type =
flash.events.Eventpropriété Event.type =
flash.events.Event.COMPLETE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué lorsque le chargement du contenu est terminé.
Cet événement est distribué que le chargement soit déclenché par un paramètre autoload ou par un appel explicite à la méthode load().
Event.COMPLETE définit la valeur de la propriété type d’un objet événement complete.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet réseau dont le chargement est terminé. |
httpStatus | Evénement |
Type d’objet d’événement:
propriété HTTPStatusEvent.type =
flash.events.HTTPStatusEventpropriété HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué lorsqu’une requête réseau est envoyée via le protocole HTTP et que Flash Player ou AIR peut détecter le code d’état HTTP.
La constanteHTTPStatusEvent.HTTP_STATUS définit la valeur de la propriété type d’un objet événement httpStatus.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
status | Le code d’état HTTP renvoyé par le serveur. |
target | L’objet réseau recevant un code d’état HTTP. |
init | Evénement |
Type d’objet d’événement:
propriété Event.type =
flash.events.Eventpropriété Event.type =
flash.events.Event.INIT| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué lorsqu’il est possible d’accéder aux propriétés et aux méthodes d’un fichier SWF chargé. Pour que cet événement soit distribué, les deux conditions suivantes doivent être remplies :
- Il est possible d’accéder à toutes les propriétés et méthodes associées à l’objet chargé et celles associées au contrôle.
- L’exécution des constructeurs de tous les objets enfant est terminée.
Event.INIT définit la valeur de la propriété type d’un objet événement init.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet LoaderInfo associé au fichier SWF en cours de chargement. |
ioError | Evénement |
Type d’objet d’événement:
propriété IOErrorEvent.type =
flash.events.IOErrorEventpropriété IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué lorsqu’une erreur d’entrée/sortie se produit.
Définit la valeur de la propriététype d’un objet d’événement ioError.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
errorID | Un numéro de référence associé à l’erreur spécifique (AIR uniquement). |
target | Objet réseau sur lequel l’erreur d’entrée/sortie s’est produite. |
text | Texte à afficher en tant que message d’erreur. |
Eléments de l’API associés
open | Evénement |
Type d’objet d’événement:
propriété Event.type =
flash.events.Eventpropriété Event.type =
flash.events.Event.OPEN| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué lors du démarrage d’une opération réseau.
La constanteEvent.OPEN définit la valeur de la propriété type d’un objet événement open.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet réseau qui a ouvert une connexion. |
progress | Evénement |
Type d’objet d’événement:
propriété ProgressEvent.type =
flash.events.ProgressEventpropriété ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué lors du chargement de contenu.
Cet événement est distribué que le chargement soit déclenché par un paramètre autoload ou par un appel explicite à la méthode load().
Remarque : il n’est pas assuré que l’événement progress soit distribué. L’événement complete peut être reçu sans qu’aucun événement progress ne soit distribué. Ceci peut se produire si le contenu chargé est un fichier local.
type d’un objet événement progress.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
bytesLoaded | Nombre d’éléments ou d’octets chargés lors du traitement de l’événement par l’écouteur. |
bytesTotal | Nombre total d’éléments ou d’octets qui seront chargés si le processus de chargement aboutit. |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet indiquant la progression. |
securityError | Evénement |
Type d’objet d’événement:
propriété SecurityErrorEvent.type =
flash.events.SecurityErrorEventpropriété SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué lorsqu’une erreur de sécurité se produit pendant le chargement du contenu. Pour plus d’informations, voir la classe SecurityErrorEvent.
La constanteSecurityErrorEvent.SECURITY_ERROR définit la valeur de la propriété type d’un objet événement securityError.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet réseau signalant l’erreur de sécurité |
text | Texte à afficher en tant que message d’erreur. |
unload | Evénement |
Type d’objet d’événement:
propriété Event.type =
flash.events.Eventpropriété Event.type =
flash.events.Event.UNLOAD| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué lorsqu’un objet chargé est supprimé ou lorsqu’un second chargement est effectué par le même contrôle SWFLoader et que le contenu d’origine est supprimé avant le début du nouveau chargement.
La constanteEvent.UNLOAD définit la valeur de la propriété type d’un objet événement unload.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet LoaderInfo associé au fichier SWF en cours de déchargement ou de remplacement. |
Exemples Comment utiliser cet exemple
local.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Flex application loaded by the Halo SWFLoader control. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx"
width="350" height="75">
<s:Label color="blue" text="The Label control of the embedded application."/>
</s:Application>
SimpleLoader.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Halo SWFLoader control. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<s:Panel title="Halo SWFLoader Control Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<s:VGroup left="10" right="10" top="10" bottom="10">
<s:Label text="The Label control of the outer application."/>
<mx:SWFLoader id="Load" source="@Embed(source='Local.swf')" height="100" width="350"/>
</s:VGroup>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z