| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Un composant interactif peut participer à la tabulation et à d’autres types de focus de l’élément réalisés à l’aide du clavier, accepter des événements de bas niveau comme les saisies du clavier et de la souris, et être désactivé afin de ne pas recevoir les saisies du clavier et de la souris. Ceci diffère des composants non interactifs, tels que Label et ProgressBar, qui affichent simplement un contenu et ne sont pas manipulés par l’utilisateur.
La classe UIComponent n’est pas utilisée comme une balise MXML, mais comme classe de base pour d’autres classes.
Syntaxe MXML
Afficher la syntaxe MXML
Masquer la syntaxe MXMLAll user interface components in Flex extend the UIComponent class. Flex components inherit the following properties from the UIComponent class:
<mx:tagname
Properties
accessibilityDescription="null"
accessibilityName="null"
accessibilityShortcut="null"
accessibilitySilent="true|false"
automationName="null"
cachePolicy="auto|on|off"
currentState="null"
doubleClickEnabled="false|true"
enabled="true|false"
explicitHeight="NaN"
explicitMaxHeight="NaN"
explicitMaxWidth="NaN"
explicitMinHeight="NaN"
explicitMinWidth="NaN"
explicitWidth="NaN"
focusEnabled="true|false"
hasFocusableChildren="false|true"
height="0"
id=""
includeInLayout="true|false"
maxHeight="10000"
maxWidth="10000"
measuredHeight=
measuredMinHeight=
measuredMinWidth=
measuredWidth=
minHeight="0"
minWidth="0"
mouseFocusEnabled="true|false"
percentHeight="NaN"
percentWidth="NaN"
scaleX="1.0"
scaleY="1.0"
states="null"
styleName="undefined"
toolTip="null"
transitions=""
validationSubField
width="0"
x="0"
y="0"
Styles
bottom="undefined"
errorColor="0xFF0000"
focusBlendMode="normal"
focusSkin="HaloFocusRect""
focusThickness="2"
horizontalCenter="undefined"
layoutDirection="ltr"
left="undefined"
right="undefined"
themeColor="haloGreen"
top="undefined"
verticalCenter="undefined"
Effects
addedEffect="No default"
creationCompleteEffect="No default"
focusInEffect="No default"
focusOutEffect="No default"
hideEffect="No default"
mouseDownEffect="No default"
mouseUpEffect="No default"
moveEffect="No default"
removedEffect="No default"
resizeEffect="No default"
rollOutEffect="No default"
rollOverEffect="No default"
showEffect="No default"
Events
add="No default"
creationComplete="No default"
currentStateChange="No default"
currentStateChanging="No default"
dragComplete="No default"
dragDrop="No default"
dragEnter="No default"
dragExit="No default"
dragOver="No default"
effectEnd="No default"
effectStart="No default"
enterState="No default"
exitState="No default"
hide="No default"
initialize="No default"
invalid="No default"
mouseDownOutside="No default"
mouseWheelOutside="No default"
move="No default"
preinitialize="No default"
remove="No default"
resize="No default"
show="No default"
toolTipCreate="No default"
toolTipEnd="No default"
toolTipHide="No default"
toolTipShow="No default"
toolTipShown="No default"
toolTipStart="No default"
updateComplete="No default"
valid="No default"
valueCommit="No default"
>
Eléments de l’API associés
| 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 | |
| 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 | |
| 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 | ||
| 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 | |
| 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 | ||
| 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 | ||
| loaderInfo : LoaderInfo [lecture seule]
Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage. | DisplayObject | |
| 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 | ||
| 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 | ||
| 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 | |
| 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 | |
| showInAutomationHierarchy : Boolean
Indicateur qui détermine si un objet d’automatisation s’affiche dans la hiérarchie d’automatisation. | UIComponent | ||
| 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 | |
| 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 | ||
| 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 | ||
| 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é | Défini par | ||
|---|---|---|---|
| currentCSSState : String [lecture seule]
Etat à utiliser pour faire correspondre les pseudo-sélecteurs CSS. | UIComponent | ||
| hasComplexLayoutMatrix : Boolean [lecture seule]
Renvoie true si la classe UIComponent possède des propriétés de transformation de non-translation (x,y). | UIComponent | ||
| resourceManager : IResourceManager [lecture seule]
Référence à l’objet qui gère toutes les ressources localisées de l’application. | UIComponent | ||
| unscaledHeight : Number [lecture seule]
Méthode pratique pour déterminer la hauteur non mise à l’échelle du composant. | UIComponent | ||
| unscaledWidth : Number [lecture seule]
Méthode pratique pour déterminer la hauteur non mise à l’échelle du composant. L’ensemble du traçage et de la présentation des enfants d’un composant doit être réalisé dans un rectangle de délimitation de cette largeur, qui est également transmise comme argument à la méthode updateDisplayList(). | UIComponent | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | UIComponent | ||
|
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 | ||
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 | |
|
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 | ||
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éthode | Défini par | ||
|---|---|---|---|
Ajuste le rectangle de focus. | UIComponent | ||
Valide la matrice calculée générée par combinaison de la matrice de présentation et des décalages de transformation de la transformation de l’objet flash displayObject. | UIComponent | ||
Il s’agit d’une méthode interne utilisée par la structure Flex pour prendre en charge l’effet Fondre. | UIComponent | ||
Détermine si l’appel à la méthode measure() peut être ignoré. | UIComponent | ||
Effectue les traitements finals éventuels après la création des objets enfant. | UIComponent | ||
Traite les propriétés définies sur le composant. | UIComponent | ||
Crée des objets enfant du composant. | UIComponent | ||
Crée un nouvel objet à l’aide d’un contexte basé sur la police incorporée en cours d’utilisation. | UIComponent | ||
Crée l’objet à l’aide d’une fabrique moduleFactory donnée. | UIComponent | ||
Méthode d’assistance permettant la distribution d’un événement PropertyChangeEvent lorsqu’une propriété est actualisée. | UIComponent | ||
Gestionnaire d’événement appelé lorsqu’un objet UIComponent obtient le focus. | UIComponent | ||
Gestionnaire d’événement appelé lorsqu’un objet UIComponent perd le focus. | UIComponent | ||
Initialise l’implémentation et le stockage de certaines des fonctions de présentation avancées d’un composant utilisées plus rarement. | UIComponent | ||
Termine l’initialisation de ce composant. | UIComponent | ||
Initialise le code d’accessibilité de ce composant. | UIComponent | ||
Méthode d’assistance permettant d’invalider la taille du parent et la liste d’affichage si cet objet affecte sa présentation (includeInLayout est défini sur true). | UIComponent | ||
Généralement remplacée par les composants contenant des objets UITextField, où l’objet UITextField obtient le focus. | UIComponent | ||
Gestionnaire d’événement appelé pour un événement keyDown. | UIComponent | ||
Gestionnaire d’événement appelé pour un événement keyUp. | UIComponent | ||
Calcule la taille par défaut du composant. Peut également calculer sa taille minimale par défaut. | UIComponent | ||
Cette méthode est appelée lors de la construction d’une classe UIComponent, puis chaque fois que ResourceManager envoie un événement « change » pour indiquer que les ressources localisées ont subi une modification. | UIComponent | ||
Spécifie un facteur d’étirement de transformation dans le sens horizontal et vertical. | UIComponent | ||
Cette méthode est appelée lorsqu’un état change pour vérifier si des styles spécifiques à l’état s’appliquent à ce composant. | UIComponent | ||
Trace l’objet et/ou dimensionne et place ses enfants. | UIComponent | ||
| 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 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 | |||
| Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME. | InteractiveObject | ||
| 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é 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é 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é 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é 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é 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 | |||
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.
| Style | Description | Défini par | ||
|---|---|---|---|---|
baseline | 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. Si ce style est défini, la ligne de base du composant est ancrée au bord supérieur de sa zone de contenu. Lorsque son conteneur est redimensionné, les deux bords restent séparés. Ce style n’a d’effet que lorsqu’il est utilisé sur un composant dans un conteneur Canvas, ou sur un composant dans un conteneur Panel ou Application dont la propriété La valeur par défaut est | UIComponent | ||
bottom | 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. Si ce style est défini, le bord inférieur du composant est ancré au bord inférieur de sa zone de contenu. Lorsque son conteneur est redimensionné, les deux bords restent séparés. Ce style n’a d’effet que lorsqu’il est utilisé sur un composant dans un conteneur Canvas, ou sur un composant dans un conteneur Panel ou Application dont la propriété La valeur par défaut est | UIComponent | ||
errorColor | 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. Flex définit également le style borderColor du composant sur cette couleur errorColor lors d’un échec de validation. La valeur par défaut du thème Halo est 0xFF0000. La valeur par défaut du thème Spark est 0xFE0000.
| UIComponent | ||
focusBlendMode | 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. Pour plus d’informations, voir la propriété blendMode de la classe flash.display.DisplayObject.
La valeur par défaut est "normal". | UIComponent | ||
focusSkin | 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. La valeur par défaut pour les composants Halo est mx.skins.halo.HaloFocusRect. La valeur par défaut des composants Spark est spark.skins.spark.FocusSkin. | UIComponent | ||
focusThickness | 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. La valeur par défaut est 2. | UIComponent | ||
horizontalCenter | 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. Si ce style est défini, le centre du composant est ancré au centre de sa zone de contenu. Lorsque son conteneur est redimensionné, les deux centres restent séparés horizontalement. Ce style n’a d’effet que lorsqu’il est utilisé sur un composant dans un conteneur Canvas, ou sur un composant dans un conteneur Panel ou Application dont la propriété La valeur par défaut est | UIComponent | ||
interactionMode | 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. Les valeurs possibles sont : souris et touche. La valeur par défaut du thème Halo est souris. La valeur par défaut du thème Spark est souris. La valeur par défaut du thème Mobile est touche.
Eléments de l’API associés | UIComponent | ||
layoutDirection | 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. Les valeurs souhaitées sont "ltr" pour la mise en forme de gauche à droite utilisée pour les composants de script latin, et "rlt" pour la mise en forme de droite à gauche utilisée pour les composants de scripts arabe ou hébreux par exemple.
Dans ActionScript, vous pouvez définir la direction de la mise en forme à l’aide des valeurs La direction de la mise en forme doit typiquement être définie sur l’ Les composants qui traitent des événements Keyboard.LEFT et Keyboard.RIGHT permutent généralement le sens de la touche lorsque la direction de la mise en forme est Remarque : Ce style s’applique à tous les composants Spark et aux composants MX qui spécifient UIFTETextField comme étant leur classe textfieldClass. La valeur par défaut est "ltr".Eléments de l’API associés | UIComponent | ||
left | 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. Si ce style est défini, le bord gauche du composant est ancré au bord gauche de sa zone de contenu. Lorsque son conteneur est redimensionné, les deux bords restent séparés. Ce style n’a d’effet que lorsqu’il est utilisé sur un composant dans un conteneur Canvas, ou sur un composant dans un conteneur Panel ou Application dont la propriété La valeur par défaut est | UIComponent | ||
right | 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. Si ce style est défini, le bord droit du composant est ancré au bord droit de sa zone de contenu. Lorsque son conteneur est redimensionné, les deux bords restent séparés. Ce style n’a d’effet que lorsqu’il est utilisé sur un composant dans un conteneur Canvas, ou sur un composant dans un conteneur Panel ou Application dont la propriété La valeur par défaut est | UIComponent | ||
showErrorSkin | 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. La valeur par défaut est true. | UIComponent | ||
showErrorTip | 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 La valeur par défaut est true. | UIComponent | ||
top | 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. Si ce style est défini, le bord supérieur du composant est ancré au bord supérieur de sa zone de contenu. Lorsque son conteneur est redimensionné, les deux bords restent séparés. Ce style n’a d’effet que lorsqu’il est utilisé sur un composant dans un conteneur Canvas, ou sur un composant dans un conteneur Panel ou Application dont la propriété La valeur par défaut est | UIComponent | ||
verticalCenter | 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. Si ce style est défini, le centre du composant est ancré au centre de sa zone de contenu. Lorsque son conteneur est redimensionné, les deux centres restent séparés verticalement. Ce style n’a d’effet que lorsqu’il est utilisé sur un composant dans un conteneur Canvas, ou sur un composant dans un conteneur Panel ou Application dont la propriété La valeur par défaut est | UIComponent | ||
| Style | Description | Défini par | ||
|---|---|---|---|---|
chromeColor | Type: uint Format: Color Héritage CSS: Oui Thème : spark Version du langage: ActionScript 3.0 Version du produit: Flex 4 Versions du moteur d’exécution: Flash10, AIR 1.5 Couleur principale d’un composant. | UIComponent | ||
| Style | Description | Défini par | ||
|---|---|---|---|---|
themeColor | Type: uint Format: Color Héritage CSS: Oui Thème : halo Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Couleur de thème d’un composant. Cette propriété détermine l’aspect de la surbrillance, l’aspect de la sélection d’un composant et d’autres signaux visuels, mais n’a aucun impact sur les bordures ou couleurs d’arrière-plan habituelles du composant. Les valeurs par défaut sont haloGreen, haloBlue, haloOrange et haloSilver, mais toute valeur de couleur valide peut être utilisée.
Les valeurs par défaut des styles "haloBlue". | UIComponent | ||
| Constante | Défini par | ||
|---|---|---|---|
| DEFAULT_MAX_HEIGHT : Number = 10000 [statique]
Valeur par défaut pour la propriété maxHeight. | UIComponent | ||
| DEFAULT_MAX_WIDTH : Number = 10000 [statique]
Valeur par défaut pour la propriété maxWidth. | UIComponent | ||
| DEFAULT_MEASURED_HEIGHT : Number = 22 [statique]
Valeur par défaut pour la propriété measuredHeight. | UIComponent | ||
| DEFAULT_MEASURED_MIN_HEIGHT : Number = 22 [statique]
Valeur par défaut pour la propriété measuredMinHeight. | UIComponent | ||
| DEFAULT_MEASURED_MIN_WIDTH : Number = 40 [statique]
Valeur par défaut pour la propriété measuredMinWidth. | UIComponent | ||
| DEFAULT_MEASURED_WIDTH : Number = 160 [statique]
Valeur par défaut pour la propriété measuredWidth. | UIComponent | ||
accessibilityDescription | propriété |
accessibilityDescription:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Accesseur pratique pour la propriété description de l’objet accessibilityProperties de ce composant UIComponent.
L’accesseur Get renvoie simplement la propriété accessibilityProperties.descriptionou "" si accessibilityProperties est null. L’accesseur Set vérifie si la valeur de la propriété accessibilityProperties est null, et le cas échéant, la définit sur une nouvelle instance AccessibilityProperties. Elle définit ensuite la propriété accessibilityProperties.description.
Implémentation
public function get accessibilityDescription():String public function set accessibilityDescription(value:String):voidaccessibilityEnabled | propriété |
accessibilityEnabled:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Accesseur pratique pour la propriété silent de l’objet accessibilityProperties de ce composant UIComponent.
Notez que le sens de accessibilityEnabled est opposé à celui de silent ; accessibilityEnabled est true si silent est false.
L’accesseur Get renvoie simplement la propriété accessibilityProperties.silent ou true si accessibilityProperties est null. L’accesseur Set vérifie si la valeur de la propriété accessibilityProperties est null, et le cas échéant, la définit sur une nouvelle instance AccessibilityProperties. Elle définit ensuite la propriété accessibilityProperties.silent.
Implémentation
public function get accessibilityEnabled():Boolean public function set accessibilityEnabled(value:Boolean):voidaccessibilityName | propriété |
accessibilityName:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Accesseur pratique pour la propriété name de l’objet accessibilityProperties de ce composant UIComponent.
L’accesseur Get renvoie simplement la propriété accessibilityProperties.nameou "" si accessibilityProperties est null. L’accesseur Set vérifie si la valeur de la propriété accessibilityProperties est null, et le cas échéant, la définit sur une nouvelle instance AccessibilityProperties. Elle définit ensuite la propriété accessibilityProperties.name.
Implémentation
public function get accessibilityName():String public function set accessibilityName(value:String):voidaccessibilityShortcut | propriété |
accessibilityShortcut:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Accesseur pratique pour la propriété shortcut de l’objet accessibilityProperties de ce composant UIComponent.
L’accesseur Get renvoie simplement la propriété accessibilityProperties.shortcutou "" si accessibilityProperties est null. L’accesseur Set vérifie si la valeur de la propriété accessibilityProperties est null, et le cas échéant, la définit sur une nouvelle instance AccessibilityProperties. Elle définit ensuite la propriété accessibilityProperties.shortcut.
Implémentation
public function get accessibilityShortcut():String public function set accessibilityShortcut(value:String):voidactiveEffects | propriété |
activeEffects:Array [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Liste des effets en cours de lecture sur le composant, sous forme d’un tableau d’instances EffectInstance.
Implémentation
public function get activeEffects():ArrayautomationDelegate | propriété |
automationDelegate:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Objet délégué qui traite la fonction d’automatisation.
Implémentation
public function get automationDelegate():Object public function set automationDelegate(value:Object):voidautomationEnabled | propriété |
automationEnabled:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
True si ce composant est activé pour l’automatisation, false dans le cas contraire.
Implémentation
public function get automationEnabled():BooleanautomationName | propriété |
automationName:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nom pouvant être utilisé comme identifiant de cet objet.
Implémentation
public function get automationName():String public function set automationName(value:String):voidautomationOwner | propriété |
automationOwner:DisplayObjectContainer [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Propriétaire de ce composant à des fins d’automatisation.
Implémentation
public function get automationOwner():DisplayObjectContainerautomationParent | propriété |
automationParent:DisplayObjectContainer [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Parent de ce composant à des fins d’automatisation.
Implémentation
public function get automationParent():DisplayObjectContainerautomationTabularData | propriété |
automationTabularData:Object [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 |
Implémentation de l’interface IAutomationTabularData, qui peut être utilisée pour récupérer les données.
Implémentation
public function get automationTabularData():ObjectautomationValue | propriété |
automationValue:Array [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 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.
Implémentation
public function get automationValue():ArrayautomationVisible | propriété |
automationVisible:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
True si ce composant est visible pour l’automatisation, false dans le cas contraire.
Implémentation
public function get automationVisible():Booleanbaseline | propriété |
baseline:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. Pour définir la propriété sur sa valeur par défaut undefined, utilisez la directive @Clear() dans MXML ou la valeur undefineddans le code ActionScript. Par exemple, dans le code MXML, baseline.s2="@Clear()" désélectionnez la contrainte baseline dans l’état s2. Ou dans le code ActionScript, button.baseline = undefined désélectionnez la contrainte baseline sur button.
Par défaut, la cible d’ancrage est le bord supérieur de la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une ligne de contrainte.
La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.
Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « row1:10 ».
Implémentation
public function get baseline():Object public function set baseline(value:Object):voidbaselinePosition | propriété |
baselinePosition: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 |
Coordonnée y de la ligne de base de la première ligne de texte du composant.
Cette propriété est utilisée pour implémenter le style de contrainte baseline. Elle est également utilisée pour aligner l’étiquette d’une classe FormItem aux contrôles dans la classe FormItem.
Implémentation
public function get baselinePosition():Numberbottom | propriété |
bottom:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. Pour définir la propriété sur sa valeur par défaut undefined, utilisez la directive @Clear() dans MXML ou la valeur undefineddans le code ActionScript. Par exemple, dans le code MXML, bottom.s2="@Clear()" désélectionnez la contrainte bottom dans l’état s2. Ou dans le code ActionScript, button.bottom = undefined désélectionnez la contrainte bottom sur button.
Par défaut, la cible d’ancrage est la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une ligne de contrainte.
La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.
Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « row1:10 ».
Implémentation
public function get bottom():Object public function set bottom(value:Object):voidcacheHeuristic | propriété |
cacheHeuristic:Boolean [écriture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Utilisé par Flex pour suggérer la mise en cache sous forme de bitmap de l’objet. Si la propriété cachePolicy est définie sur la valeur UIComponentCachePolicy.AUTO, alors la propriété cacheHeuristic est utilisée pour contrôler la propriété cacheAsBitmap de l’objet.
Implémentation
public function set cacheHeuristic(value:Boolean):voidcachePolicy | propriété |
cachePolicy:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Spécifie la stratégie de mise en cache sous forme de bitmap de cet objet. Les valeurs possibles dans MXML sont "on", "off" et "auto" (valeur par défaut).
Les valeurs possibles dans ActionScript sont UIComponentCachePolicy.ON, UIComponentCachePolicy.OFF et UIComponentCachePolicy.AUTO (valeur par défaut).
- La valeur
UIComponentCachePolicy.ONsignifie que l’objet est toujours mis en cache sous forme de bitmap. - La valeur
UIComponentCachePolicy.OFFsignifie que l’objet n’est jamais mis en cache sous forme de bitmap. - La valeur
UIComponentCachePolicy.AUTOsignifie que le framework utilise une méthode heuristique pour déterminer si l’objet doit être mis en cache sous forme de bitmap.
La valeur par défaut est UIComponentCachePolicy.AUTO.
Implémentation
public function get cachePolicy():String public function set cachePolicy(value:String):voidclassName | propriété |
className:String [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 |
Nom de la classe de cette instance, par exemple "DataGridItemRenderer".
Cette chaîne n’inclut pas le nom du package. Si vous avez besoin du nom du package, appelez la méthode getQualifiedClassName() du package flash.utils. Il renvoie une chaîne telle que « mx.contrôle::Button ».
Implémentation
public function get className():StringcontentMouseX | propriété |
contentMouseX: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 |
Renvoie la position x de la souris, dans le système de coordonnées du contenu. Les coordonnées de contenu spécifient une position de pixel par rapport au coin supérieur gauche du contenu du composant. Elles incluent l’ensemble de la zone de contenu du composant, y compris les régions actuellement découpées, accessibles uniquement par défilement du composant.
Implémentation
public function get contentMouseX():NumbercontentMouseY | propriété |
contentMouseY: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 |
Renvoie la position y de la souris, dans le système de coordonnées du contenu. Les coordonnées de contenu spécifient une position de pixel par rapport au coin supérieur gauche du contenu du composant. Elles incluent l’ensemble de la zone de contenu du composant, y compris les régions actuellement découpées, accessibles uniquement par défilement du composant.
Implémentation
public function get contentMouseY():NumbercurrentCSSState | propriété |
currentCSSState:String [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Etat à utiliser pour faire correspondre les pseudo-sélecteurs CSS. Par défaut, il s’agit de l’état currentState.
Implémentation
protected function get currentCSSState():StringcurrentState | propriété |
currentState:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Etat d’affichage actuel du composant. Définissez la propriété sur "" ou null pour réinitialiser le composant dans son état de base.
Lorsque vous utilisez cette propriété pour définir l’état d’un composant, Flex applique une transition définie. Vous pouvez également utiliser la méthode setCurrentState() pour définir l’état actuel. Cette méthode permet également de modifier les états sans appliquer une transition.
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 currentStateChange .
Implémentation
public function get currentState():String public function set currentState(value:String):voidEléments de l’API associés
cursorManager | propriété |
cursorManager:ICursorManager [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 |
Récupère le gestionnaire CursorManager qui contrôle le curseur pour ce composant et ses homologues. Chaque fenêtre de niveau supérieur possède sa propre instance d’un gestionnaire CursorManager. Pour vous assurer de parler au gestionnaire concerné, utilisez cette méthode.
Implémentation
public function get cursorManager():ICursorManagerdepth | propriété |
depth:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Détermine l’ordre dans lequel les éléments sont rendus au sein des conteneurs. Les conteneurs Spark organisent leurs éléments en fonction de leur propriété depth, avec la profondeur la plus basse à l’arrière-plan et la plus élevée à l’avant. Les éléments avec la même valeur de profondeur apparaissent dans leur ordre d’ajout au conteneur.
Implémentation
public function get depth():Number public function set depth(value:Number):voiddescriptor | propriété |
descriptor:UIComponentDescriptor| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Référence à la classe UIComponentDescriptor, le cas échéant, utilisé par la méthode createComponentFromDescriptor() pour créer cette instance UIComponent. Si cette instance UIComponent n’a pas été créée à partir d’un descripteur, cette propriété est définie sur null.
Implémentation
public function get descriptor():UIComponentDescriptor public function set descriptor(value:UIComponentDescriptor):voidEléments de l’API associés
designLayer | propriété |
designLayer:DesignLayer| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie l’instance DesignLayer facultative associée à cet élément visuel.
Lorsqu’un objet DesignLayer est affecté, un élément visuel doit prendre en compte la visibilité et la valeur alpha de son calque parent, lors de l’enregistrement de ses propres valeurs de visibilité ou alpha réelles sur son objet DisplayObject de sauvegarde (si applicable).
Un élément visuel doit écouter les notifications layerPropertyChange du calque parent associé. Lorsque la propriété effectiveAlpha ou effectiveVisibility est modifiée, l’élément doit ensuite calculer sa propre propriété de visibilité (ou alpha) et l’appliquer en conséquence.
Cette propriété ne doit pas être définie directement dans MXML.
La propriété designLayer n’est pas utilisée pour le contrôle de l’ordre de plan. Voir depth.
Implémentation
public function get designLayer():DesignLayer public function set designLayer(value:DesignLayer):voiddocument | propriété |
document:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Référence à l’objet de document associé à ce composant UIComponent. Un objet de document est un objet qui se trouve au sommet de la hiérarchie d’une application Flex, d’un composant MXML ou d’un composant AS.
Implémentation
public function get document():Object public function set document(value:Object):voiddoubleClickEnabled | propriété |
doubleClickEnabled:Boolean[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Spécifie si l’objet UIComponent reçoit les événements doubleClick. La valeur par défaut est false, ce qui signifie que le composant UIComponent ne reçoit pas les événements doubleClick.
La propriété mouseEnabled doit également être définie sur true, sa valeur par défaut, pour que l’objet reçoive les événements doubleClick.
La valeur par défaut est false.
Implémentation
override public function get doubleClickEnabled():Boolean override public function set doubleClickEnabled(value:Boolean):voidenabled | propriété |
enabled:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique si le composant peut accepter une interaction de l’utilisateur. Même lorsque la propriété enabled est définie sur false, certains composants continuent à répondre aux interactions de souris telles que mouseOver. Par conséquent, pour désactiver entièrement des classes UIComponent, vous devez également définir la valeur de la propriété mouseEnabled sur false. Si vous définissez la propriété enabled sur false pour un conteneur, Flex estompe la couleur du conteneur et de ses enfants et empêche toute intervention de l’utilisateur sur le conteneur et ses enfants.
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 enabledChanged .
Implémentation
public function get enabled():Boolean public function set enabled(value:Boolean):voiderrorString | propriété |
errorString:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Vous pouvez utiliser la propriété errorString afin d’afficher une erreur de validation pour un composant, sans utiliser réellement une classe Validator. Lorsque vous écrivez une valeur de chaîne dans la propriété errorString, Flex trace une bordure rouge autour du composant pour indiquer l’erreur de validation et la chaîne apparaît dans une info-bulle en tant que message d’erreur de validation lorsque vous placez le curseur sur le composant, tout comme si un programme de validation détectait une erreur de validation.
Pour effacer l’erreur de validation, écrivez une chaîne vide, "", dans la propriété errorString.
Ecrire une valeur dans la propriété errorString ne déclenche pas les événements valid ou invalid ; cela change uniquement la couleur de bordure et affiche le message d’erreur de validation.
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 errorStringChanged .
Implémentation
public function get errorString():String public function set errorString(value:String):voidexplicitHeight | propriété |
explicitHeight:Number| 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éfinissant la hauteur explicite du composant en pixels, dans les coordonnées du composant.
Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur explicitHeight réelle par rapport à son parent est affectée par la propriété scaleY.
La définition de la propriété height définit également cette propriété sur la valeur de hauteur spécifiée.
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 explicitHeightChanged .
Implémentation
public function get explicitHeight():Number public function set explicitHeight(value:Number):voidexplicitMaxHeight | propriété |
explicitMaxHeight:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Hauteur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est exprimée dans les coordonnées du composant, en pixels.
Généralement, les développeurs d’applications ne définissent pas la propriété explicitMaxHeight. Au lieu de cela, ils définissent la valeur de la propriété maxHeight, ce qui définit la propriété explicitMaxHeight. La valeur de maxHeight ne change pas.
Lors de la présentation, si maxHeight a été explicitement définie par le développeur de l’application, la valeur explicitMaxHeight est utilisée. Dans le cas contraire, la valeur par défaut pour maxHeight est utilisée.
Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur maxHeight réelle par rapport à son parent est affectée par la propriété scaleY. Certains composants n’ont aucune limite théorique pour leur hauteur. Dans ces cas, leur propriété maxHeight est définie sur UIComponent.DEFAULT_MAX_HEIGHT.
La valeur par défaut est NaN.
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 explicitMaxHeightChanged .
Implémentation
public function get explicitMaxHeight():Number public function set explicitMaxHeight(value:Number):voidexplicitMaxWidth | propriété |
explicitMaxWidth:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Largeur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est exprimée dans les coordonnées du composant, en pixels.
Généralement, les développeurs d’applications ne définissent pas la propriété explicitMaxWidth. Au lieu de cela, ils définissent la valeur de la propriété maxWidth, ce qui définit la propriété explicitMaxWidth. La valeur de maxWidth ne change pas.
Lors de la présentation, si maxWidth a été explicitement définie par le développeur de l’application, la valeur explicitMaxWidth est utilisée. Dans le cas contraire, la valeur par défaut pour maxWidth est utilisée.
Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur maxWidth réelle par rapport à son parent est affectée par la propriété scaleX. Certains composants n’ont aucune limite théorique pour leur largeur. Dans ces cas, leur propriété maxWidth est définie sur UIComponent.DEFAULT_MAX_WIDTH.
La valeur par défaut est NaN.
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 explicitMaxWidthChanged .
Implémentation
public function get explicitMaxWidth():Number public function set explicitMaxWidth(value:Number):voidexplicitMinHeight | propriété |
explicitMinHeight:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Hauteur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est exprimée dans les coordonnées du composant, en pixels.
Généralement, les développeurs d’applications ne définissent pas la propriété explicitMinHeight. Au lieu de cela, ils définissent la valeur de la propriété minHeight, ce qui définit la propriété explicitMinHeight. La valeur de minHeight ne change pas.
Lors de la présentation, si minHeight a été explicitement définie par le développeur de l’application, la valeur explicitMinHeight est utilisée. Dans le cas contraire, la valeur de measuredMinHeight est utilisée.
Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur minHeight réelle par rapport à son parent est affectée par la propriété scaleY.
La valeur par défaut est NaN.
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 explictMinHeightChanged .
Implémentation
public function get explicitMinHeight():Number public function set explicitMinHeight(value:Number):voidexplicitMinWidth | propriété |
explicitMinWidth:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Largeur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est dans les coordonnées du composant, en pixels.
Généralement, les développeurs d’applications ne définissent pas la propriété explicitMinWidth. Au lieu de cela, ils définissent la valeur de la propriété minWidth, ce qui définit la propriété explicitMinWidth. La valeur de minWidth ne change pas.
Lors de la présentation, si minWidth a été explicitement définie par le développeur de l’application, la valeur explicitMinWidth est utilisée. Dans le cas contraire, la valeur de measuredMinWidth est utilisée.
Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur minWidth réelle par rapport à son parent est affectée par la propriété scaleX.
La valeur par défaut est NaN.
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 explicitMinWidthChanged .
Implémentation
public function get explicitMinWidth():Number public function set explicitMinWidth(value:Number):voidexplicitWidth | propriété |
explicitWidth:Number| 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éfinissant la largeur explicite du composant en pixels, dans les coordonnées du composant.
Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur explicitWidth réelle par rapport à son parent est affectée par la propriété scaleX.
La définition de la propriété width définit également cette propriété sur la valeur de largeur spécifiée.
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 explicitWidthChanged .
Implémentation
public function get explicitWidth():Number public function set explicitWidth(value:Number):voidflexContextMenu | propriété |
flexContextMenu:IFlexContextMenu| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Menu contextuel pour ce composant UIComponent.
La valeur par défaut est null.
Implémentation
public function get flexContextMenu():IFlexContextMenu public function set flexContextMenu(value:IFlexContextMenu):voidfocusEnabled | propriété |
focusEnabled:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique si le composant peut recevoir le focus par tabulation. Vous pouvez définir la propriété focusEnabled sur false lorsqu’un composant UIComponent est utilisé comme sous-composant d’un autre composant, pour que cet autre composant devienne l’entité pouvant recevoir le focus. Si la valeur de cette propriété est false, le focus est transféré au premier parent ayant une propriété focusEnable définie sur true.
La valeur par défaut est true, sauf pour le composant spark.components.Scroller. Pour ce composant, la valeur par défaut est false.
Implémentation
public function get focusEnabled():Boolean public function set focusEnabled(value:Boolean):voidEléments de l’API associés
focusManager | propriété |
focusManager:IFocusManager| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Récupère le FocusManager qui contrôle le focus pour ce composant et ses homologues. Chaque fenêtre contextuelle possède sa propre boucle de focus et donc sa propre instance du gestionnaire FocusManager. Pour vous assurer de parler au gestionnaire concerné, utilisez cette méthode.
Implémentation
public function get focusManager():IFocusManager public function set focusManager(value:IFocusManager):voidfocusPane | propriété |
focusPane:Sprite| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Volet de focus associé à cet objet. Un objet dispose d’un panneau de focus si l’un de ses enfants a le focus.
Implémentation
public function get focusPane():Sprite public function set focusPane(value:Sprite):voidhasComplexLayoutMatrix | propriété |
hasComplexLayoutMatrix:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie true si la classe UIComponent possède des propriétés de transformation de non-translation (x,y)
Implémentation
protected function get hasComplexLayoutMatrix():BooleanhasFocusableChildren | propriété |
hasFocusableChildren:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Indicateur qui signale si les objets enfant peuvent recevoir le focus
Remarque : cette fonction est similaire à la propriété tabChildren utilisée par Flash Player. Utilisez la propriété hasFocusableChildren avec les applications Flex. N’utilisez pas la propriété tabChildren.
La valeur de cette propriété est généralement false, car la plupart des composants reçoivent le focus ou le délèguent à un sous-composant interne unique et apparaissent comme s’ils avaient reçu le focus. Par exemple, un contrôle TextInput contient un contrôle RichEditableText enfant pouvant recevoir le focus, mais si le sous-composant RichEditableText reçoit le focus, le composant TextInput s’affiche comme s’il avait le focus. TextInput définit hasFocusableChildren sur false, car TextInput est considéré comme le composant ayant le focus. Sa structure interne est une abstraction.
Généralement, seuls les indicateurs des composants de navigateur tels que TabNavigator et Accordion sont définis sur true, car, bien qu’ils reçoivent le focus sur l’onglet, le focus est attribué aux composants des conteneurs enfant des onglets ultérieurs.
La valeur par défaut est false, sauf pour le composant spark.components.Scroller. Pour ce composant, 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 hasFocusableChildrenChange .
Implémentation
public function get hasFocusableChildren():Boolean public function set hasFocusableChildren(value:Boolean):voidEléments de l’API associés
hasLayoutMatrix3D | propriété |
hasLayoutMatrix3D:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Contient true si l’élément possède une matrice 3D.
Utilisez hasLayoutMatrix3D au lieu d’appeler et d’examiner la valeur renvoyée par la méthode getLayoutMatrix3D(), car cette méthode renvoie une matrice valide même lorsque l’élément est en 2D.
Implémentation
public function get hasLayoutMatrix3D():Booleanheight | propriété |
height:Number[override] | 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éfinissant la hauteur du composant en pixels, dans les coordonnées du parent. La valeur par défaut est 0, mais cette propriété contient la hauteur réelle du composant dès lors que Flex termine le dimensionnement des composants de l’application.
Remarque : vous pouvez spécifier une valeur de pourcentage pour l’attribut MXML height, par exemple height="100%", mais pas pour la propriété height dans ActionScript. Utilisez dans ce cas la propriété percentHeight.
La définition de cette propriété entraîne la distribution d’un événement resize. Reportez-vous à l’événement resize pour plus d’informations sur le moment de distribution de cet événement.
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 heightChanged .
Implémentation
override public function get height():Number override public function set height(value:Number):voidEléments de l’API associés
horizontalCenter | propriété |
horizontalCenter:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. Pour définir la propriété sur sa valeur par défaut undefined, utilisez la directive @Clear() dans MXML ou la valeur undefineddans le code ActionScript. Par exemple, dans le code MXML, horizontalCenter.s2="@Clear()", désélectionnez la contrainte horizontalCenter dans l’état s2. Ou dans le code ActionScript, button.horizontalCenter = undefined désélectionnez la contrainte horizontalCenter sur button.
La cible d’ancrage par défaut est le conteneur lui-même.
Dans les présentations avec contraintes avancées, la cible d’ancrage peut être une colonne de contrainte. Dans ce cas, la zone de contenu est l’espace entre la colonne précédente (ou le côté du conteneur) et la colonne cible.
Définir la propriété sur un nombre ou une chaîne numérique (par exemple, 10) spécifie l’utilisation de la cible d’ancrage par défaut.
Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « constraintColumnId:value ». Par exemple, « col1:10 ».
Implémentation
public function get horizontalCenter():Object public function set horizontalCenter(value:Object):voidid | propriété |
id:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
ID du composant. Cette valeur devient le nom d’instance de l’objet et ne doit pas contenir d’espace ni de caractère spécial. Chaque composant d’une application doit avoir un id unique.
Si l’application va être testée par des outils tiers, donnez à chaque composant un id significatif. Les outils de test utilisent des id pour représenter le contrôle dans leurs scripts. Leur donner un nom significatif permet de réaliser des scripts plus lisibles. Par exemple, définissez la valeur d’un bouton sur submit_button plutôt que sur b1 ou button1.
Implémentation
public function get id():String public function set id(value:String):voidincludeInLayout | propriété |
includeInLayout:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique si ce composant est inclus dans la présentation du conteneur parent. Si la valeur est true, l’objet est inclus dans la mise en forme du conteneur parent et est dimensionné et agencé par son conteneur parent par les règles de sa mise en page. Si la valeur est false, la taille et la position de l’objet ne sont pas affectés par la mise en page de son conteneur parent.
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 includeInLayoutChanged .
Implémentation
public function get includeInLayout():Boolean public function set includeInLayout(value:Boolean):voidinheritingStyles | propriété |
inheritingStyles:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Début de la chaîne de styles hérités de ce composant. La méthode getStyle() accède simplement à inheritingStyles[styleName] pour parcourir la totalité de la chaîne liée au prototype. Cet objet est défini par la méthode initProtoChain(). En règle générale, les développeurs n’ont jamais besoin d’accéder à cette propriété directement.
Implémentation
public function get inheritingStyles():Object public function set inheritingStyles(value:Object):voidinitialized | propriété |
initialized: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 déterminant si un objet a traversé les trois phases de présentation : validation, mesure et présentation (si besoin était).
Implémentation
public function get initialized():Boolean public function set initialized(value:Boolean):voidinstanceIndex | propriété |
instanceIndex:int [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 |
Index d’un composant répété. Si le composant n’est pas dans un objet Repeater, la valeur est -1.
Implémentation
public function get instanceIndex():intinstanceIndices | propriété |
instanceIndices:Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Tableau contenant les indices requis pour faire référence à cet objet UIComponent à partir de son document parent. Le tableau est vide, sauf si cet objet UIComponent figure dans un ou plusieurs objets Repeater. Le premier élément correspond à l’objet Repeater le plus excentré. Par exemple, si id a la valeur « b » et instanceIndices a la valeur [2,4], la référence dans le document parent est b[2][4].
Implémentation
public function get instanceIndices():Array public function set instanceIndices(value:Array):voidis3D | propriété |
is3D:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Contient true lorsque l’élément est en 3D. L’élément peut être en 3D parce qu’il possède des propriétés de transformation 3D, des décalages de transformation 3D après la mise en forme ou les deux.
Implémentation
public function get is3D():BooleanisDocument | propriété |
isDocument: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 |
Contient la valeur true si l’instance UIComponent est un objet document. Cela signifie qu’il se trouve au sommet de la hiérarchie d’une application Flex ou d’un composant MXML ou ActionScript.
Implémentation
public function get isDocument():BooleanisPopUp | propriété |
isPopUp:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Défini sur true par le gestionnaire PopUpManager pour indiquer que composant a été ouvert sous forme de menu contextuel.
Implémentation
public function get isPopUp():Boolean public function set isPopUp(value:Boolean):voidlayoutMatrix3D | propriété |
layoutMatrix3D:Matrix3D [écriture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Matrice de transformation utilisée pour calculer la présentation d’un composant par rapport à ses frères. Cette matrice est définie par les propriétés 3D du composant (qui incluent les propriétés 2D, par exemple x, y, rotation, scaleX, scaleY, transformX et transformY, ainsi que rotationX, rotationY, scaleZ, z et transformZ).
La plupart des composants ne disposent pas de propriétés de transformation 3D définies.
Cette matrice de mise en forme est combinée avec les valeurs de la propriété postLayoutTransformOffsets pour déterminer la matrice calculée finale du composant.
Implémentation
public function set layoutMatrix3D(value:Matrix3D):voidEléments de l’API associés
left | propriété |
left:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. Pour définir la propriété spécifique d’un état dans MXML sur sa valeur par défaut undefined, utilisez la directive @Clear(). Par exemple, dans le code MXML, left.s2="@Clear()", désélectionnez la contrainte left dans l’état s2. Ou dans le code ActionScript, button.left = undefined désélectionnez la contrainte left sur button.
Par défaut, la cible d’ancrage est la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une colonne de contrainte.
La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.
Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « col1:10 ».
Implémentation
public function get left():Object public function set left(value:Object):voidmaintainProjectionCenter | propriété |
maintainProjectionCenter:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Lorsque sa valeur est true, le composant garde sa matrice de projection centrée sur le milieu de son cadre de sélection. Si aucune matrice de projection n’est définie sur le composant, elle est ajoutée automatiquement.
Implémentation
public function get maintainProjectionCenter():Boolean public function set maintainProjectionCenter(value:Boolean):voidmaxHeight | propriété |
maxHeight:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Hauteur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est exprimée dans les coordonnées du composant, en pixels. La valeur par défaut de cette propriété est définie par le développeur du composant.
Le développeur de composant utilise cette propriété pour définir une limite supérieure pour la hauteur du composant.
Si le développeur de l’application remplace la valeur par défaut de la propriété maxHeight, la nouvelle valeur est stockée dans la propriété explicitMaxHeight. La valeur par défaut de maxHeight ne change pas. Par conséquent, lors de la présentation, si maxHeight a été explicitement définie par le développeur de l’application, la valeur explicitMaxHeight est utilisée pour la hauteur maximale recommandée du composant. Si la propriété maxHeight n’est pas définie de façon explicite par l’utilisateur, la valeur par défaut est utilisée.
Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur maxHeight réelle par rapport à son parent est affectée par la propriété scaleY. Certains composants n’ont aucune limite théorique pour leur hauteur. Dans ces cas, leur propriété maxHeight est définie sur UIComponent.DEFAULT_MAX_HEIGHT.
La valeur par défaut est 10000.
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 explicitMaxHeightChanged .
Implémentation
public function get maxHeight():Number public function set maxHeight(value:Number):voidmaxWidth | propriété |
maxWidth:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Largeur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est exprimée dans les coordonnées du composant, en pixels. La valeur par défaut de cette propriété est définie par le développeur du composant.
Le développeur de composant utilise cette propriété pour définir une limite supérieure pour la largeur du composant.
Si le développeur de l’application remplace la valeur par défaut de la propriété maxWidth, la nouvelle valeur est stockée dans la propriété explicitMaxWidth. La valeur par défaut de maxWidth ne change pas. Par conséquent, lors de la présentation, si maxWidth a été explicitement définie par le développeur de l’application, la valeur explicitMaxWidth est utilisée pour la largeur maximale recommandée du composant. Si la propriété maxWidth n’est pas définie de façon explicite par l’utilisateur, la valeur par défaut est utilisée.
Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur maxWidth réelle par rapport à son parent est affectée par la propriété scaleX. Certains composants n’ont aucune limite théorique pour leur largeur. Dans ces cas, leur propriété maxWidth est définie sur UIComponent.DEFAULT_MAX_WIDTH.
La valeur par défaut est 10000.
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 explicitMaxWidthChanged .
Implémentation
public function get maxWidth():Number public function set maxWidth(value:Number):voidmeasuredHeight | propriété |
measuredHeight:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Hauteur par défaut du composant, en pixels. Cette valeur est définie par la méthode measure().
Implémentation
public function get measuredHeight():Number public function set measuredHeight(value:Number):voidmeasuredMinHeight | propriété |
measuredMinHeight:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Hauteur minimale par défaut du composant, en pixels. Cette valeur est définie par la méthode measure().
Implémentation
public function get measuredMinHeight():Number public function set measuredMinHeight(value:Number):voidmeasuredMinWidth | propriété |
measuredMinWidth:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Largeur minimale par défaut du composant, en pixels. Cette valeur est définie par la méthode measure().
Implémentation
public function get measuredMinWidth():Number public function set measuredMinWidth(value:Number):voidmeasuredWidth | propriété |
measuredWidth:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Largeur par défaut du composant, en pixels. Cette valeur est définie par la méthode measure().
Implémentation
public function get measuredWidth():Number public function set measuredWidth(value:Number):voidminHeight | propriété |
minHeight:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Hauteur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est dans les coordonnées du composant, en pixels. La valeur par défaut dépend de l’implémentation du composant.
Si le développeur de l’application définit la valeur de la propriété minHeight, la nouvelle valeur est stockée dans la propriété explicitMinHeight. La valeur par défaut de minHeight ne change pas. Par conséquent, lors de la présentation, si minHeight a été explicitement définie par le développeur de l’application, la valeur explicitMinHeight est utilisée pour la hauteur minimale recommandée du composant. Si la propriété minHeight n’est pas définie de façon explicite par le développeur de l’application, la valeur de la propriété measuredMinHeight est utilisée.
Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur minHeight réelle par rapport à son parent est affectée par la propriété scaleY.
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 explicitMinHeightChanged .
Implémentation
public function get minHeight():Number public function set minHeight(value:Number):voidminWidth | propriété |
minWidth:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Largeur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est dans les coordonnées du composant, en pixels. La valeur par défaut dépend de l’implémentation du composant.
Si le développeur de l’application définit la valeur de la propriété minWidth, la nouvelle valeur est stockée dans la propriété explicitMinWidth. La valeur par défaut de minWidth ne change pas. Par conséquent, lors de la présentation, si minWidth a été explicitement définie par le développeur de l’application, la valeur explicitMinWidth est utilisée pour la largeur minimale recommandée du composant. Si la propriété minWidth n’est pas définie de façon explicite par le développeur de l’application, la valeur de la propriété measuredMinWidth est utilisée.
Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur minWidth réelle par rapport à son parent est affectée par la propriété scaleX.
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 explicitMinWidthChanged .
Implémentation
public function get minWidth():Number public function set minWidth(value:Number):voidmoduleFactory | propriété |
moduleFactory:IFlexModuleFactory| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Implémentation
public function get moduleFactory():IFlexModuleFactory public function set moduleFactory(value:IFlexModuleFactory):voidmouseFocusEnabled | propriété |
mouseFocusEnabled:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique si le composant peut recevoir le focus à l’aide de la souris. Si la valeur est false, le focus est transféré au premier parent ayant une propriété mouseFocusEnabled définie sur true. Par exemple, vous pouvez définir cette propriété sur false sur une commande Button afin de permettre l’utilisation de la touche de tabulation pour passer le focus à la commande, mais ne pas passer le focus à la commande lorsque vous cliquez dessus.
La valeur par défaut est true pour la plupart des sous-classes, à l’exception de TabBar de Spark. Dans ce cas, la valeur par défaut est false.
La valeur par défaut est true.
Implémentation
public function get mouseFocusEnabled():Boolean public function set mouseFocusEnabled(value:Boolean):voidnestLevel | propriété |
nestLevel:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Profondeur de cet objet dans la hiérarchie de confinement. Ce nombre est utilisé par le code de mesure et de présentation. La valeur est 0 si ce composant n’est pas dans la liste DisplayList.
Implémentation
public function get nestLevel():int public function set nestLevel(value:int):voidnonInheritingStyles | propriété |
nonInheritingStyles:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Début de la chaîne de styles non hérités de ce composant. La méthode getStyle() accède simplement à nonInheritingStyles[styleName] pour parcourir la totalité de la chaîne liée au prototype. Cet objet est défini par la méthode initProtoChain(). En règle générale, les développeurs n’ont jamais besoin d’accéder à cette propriété directement.
Implémentation
public function get nonInheritingStyles():Object public function set nonInheritingStyles(value:Object):voidnumAutomationChildren | propriété |
numAutomationChildren:int [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’enfants d’automatisation que ce conteneur comporte. Cette somme ne doit inclure aucun enfant composite, bien qu’elle inclue les enfants non significatifs dans la hiérarchie d’automatisation.
Implémentation
public function get numAutomationChildren():intowner | propriété |
owner:DisplayObjectContainer| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Propriétaire de cet objet IVisualElement. Par défaut, il s’agit du parent de cet objet IVisualElement. Toutefois, si cet objet IVisualElement est un composant enfant déclenché par son parent, comme la liste déroulante d’un composant de commande ComboBox, le propriétaire est le composant ayant affiché cet objet IVisualElement.
Cette propriété n’est pas gérée par Flex, mais par chaque composant. Aussi, si vous utilisez la méthode PopUpManger.createPopUp() ou PopUpManger.addPopUp() pour afficher un composant enfant, définissez la propriété owner du composant enfant sur le composant l’ayant affiché.
La valeur par défaut est la valeur de la propriété parent.
Implémentation
public function get owner():DisplayObjectContainer public function set owner(value:DisplayObjectContainer):voidparent | propriété |
parent:DisplayObjectContainer [lecture seule] [override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Conteneur ou composant parent de ce composant. Seuls les éléments visuels doivent avoir une propriété parent. Les éléments non visuels doivent utiliser une autre propriété pour faire référence à l’objet auquel ils appartiennent. Par convention, les objets non visuels utilisent une propriété owner pour faire référence à l’objet auquel ils appartiennent.
Implémentation
override public function get parent():DisplayObjectContainerparentApplication | propriété |
parentApplication:Object [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 |
Référence à l’objet d’application contenant cette instance UIComponent. Cet objet Application peut exister dans un contrôle SWFLoader dans un autre objet Application et ainsi de suite, créant une chaîne d’objets Application pouvant être remontée à l’aide de parentApplication.
La propriété parentApplication d’une application n’est jamais l’application elle-même. Elle correspond soit à l’application dans laquelle elle a été chargée, soit à la valeur null (pour l’application de plus haut niveau).
Le parcours de la chaîne d’application à l’aide de la propriété parentApplication est comparable au parcours de la chaîne de document à l’aide de la propriété parentDocument. Vous pouvez accéder à l’application de plus haut niveau à l’aide de la propriété application de la classe Application.
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 initialize .
Implémentation
public function get parentApplication():ObjectparentDocument | propriété |
parentDocument:Object [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 |
Référence à l’objet de document parent pour ce composant UIComponent. Un objet de document est un objet UIComponent qui se trouve au sommet de la hiérarchie d’une application Flex, d’un composant MXML ou d’un composant AS.
Pour l’objet Application, la propriété parentDocument a la valeur null. Cette propriété est utile dans les scripts MXML pour remonter d’un niveau dans la chaîne d’objets de document. Elle peut être utilisée pour parcourir cette chaîne, à l’aide de la syntaxe parentDocument.parentDocument, etc.
Il est typé en tant qu’objet pour que les auteurs puissent accéder à des propriétés et méthodes sur des objets de document ancêtre sans projection.
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 initialize .
Implémentation
public function get parentDocument():ObjectpercentHeight | propriété |
percentHeight:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Spécifie la hauteur d’un composant en tant que pourcentage de la taille de son parent. Valeurs autorisées : 0 à 100. La valeur par défaut est NaN. Définir les propriétés height ou explicitHeight réinitialise cette propriété sur NaN.
Cette propriété renvoie une valeur numérique uniquement si elle a été précédemment définie. Elle ne reflète pas la taille exacte du composant en pourcentage.
Cette propriété est toujours définie sur NaN pour la commande UITextField.
Lorsqu’elle est utilisée dans des mises en forme Spark, cette propriété permet de calculer la hauteur des limites du composant après la mise à l’échelle et la rotation. Par exemple, si le composant pivote à 90 degrés, le fait de spécifier percentHeight affecte sa largeur.
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 resize .
Implémentation
public function get percentHeight():Number public function set percentHeight(value:Number):voidpercentWidth | propriété |
percentWidth:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Spécifie la largeur d’un composant en tant que pourcentage de la taille de son parent. Valeurs autorisées : 0 à 100. La valeur par défaut est NaN. La définition des valeurs width ou explicitWidth restaure cette propriété sur la valeur NaN.
Cette propriété renvoie une valeur numérique uniquement si elle a été précédemment définie. Elle ne reflète pas la taille exacte du composant en pourcentage.
Cette propriété est toujours définie sur NaN pour la commande UITextField.
Lorsqu’elle est utilisé avec des mises en forme Spark, cette propriété permet de calculer la largeur des limites du composant après la mise à l’échelle et la rotation. Par exemple, si le composant pivote à 90 degrés, le fait de spécifier percentWidth affecte la hauteur du composant.
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 resize .
Implémentation
public function get percentWidth():Number public function set percentWidth(value:Number):voidpostLayoutTransformOffsets | propriété |
postLayoutTransformOffsets:mx.geom:TransformOffsets| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Définit un ensemble de réglages pouvant être appliqués à la transformation d’un objet de manière invisible pour la présentation de son parent.
Par exemple, si vous souhaitez que la présentation s’adapte à un objet devant subir une rotation de 90 degrés, définissez la propriété rotation de ce dernier. Si vous souhaitez que la présentation ne s’adapte pas à un objet subissant une rotation, définissez sa propriété postLayoutTransformOffsets.rotationZ.
Implémentation
public function get postLayoutTransformOffsets():mx.geom:TransformOffsets public function set postLayoutTransformOffsets(value:mx.geom:TransformOffsets):voidprocessedDescriptors | propriété |
processedDescriptors:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Définie sur true après la création d’enfant immédiate ou différée, en fonction de celle effectuée. Pour un objet Container, elle est définie sur true à la fin de la méthode createComponentsFromDescriptors(), donc après la création des enfants du conteneur à partir de ses descripteurs enfant.
Par exemple, si un conteneur Accordion utilise l’instanciation différée, la propriété processedDescriptors pour le deuxième volet du conteneur Accordion ne prend pas la valeur true jusqu’à ce que l’utilisateur accède au volet et que le volet crée ses enfants. Si toutefois le composant Accordion a défini la propriété creationPolicy sur "all", la propriété processedDescriptors de son deuxième panneau est définie sur true au démarrage de l’application.
Pour les classes qui ne sont pas des conteneurs, qui n’ont pas de descripteurs, elle est définie sur true après la création des enfants de composant internes éventuels par la méthode createChildren().
Implémentation
public function get processedDescriptors():Boolean public function set processedDescriptors(value:Boolean):voidrepeater | propriété |
repeater:IRepeater [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 |
Référence à l’objet Repeater dans le document parent ayant produit ce composant UIComponent. Utilisez cette propriété plutôt que la propriété repeaters lorsque l’objet UIComponent est créé par un seul objet Repeater. Utilisez la propriété repeaters lorsque cet objet UIComponent est créé par des objets Repeater imbriqués.
La propriété est définie sur null lorsque cet objet UIComponent n’est pas créé par un objet Repeater.
Implémentation
public function get repeater():IRepeaterrepeaterIndex | propriété |
repeaterIndex:int [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 |
Index de l’élément dans le fournisseur de données de l’objet Repeater ayant produit ce composant UIComponent. Utilisez cette propriété plutôt que la propriété repeaterIndices lorsque l’objet UIComponent est créé par un seul objet Repeater. Utilisez la propriété repeaterIndices lorsque cet objet UIComponent est créé par des objets Repeater imbriqués.
Cette propriété est définie sur -1 lorsque cet objet UIComponent n’est pas créé par un objet Repeater.
Implémentation
public function get repeaterIndex():intrepeaterIndices | propriété |
repeaterIndices:Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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. Le tableau est vide, sauf si ce composant UIComponent figure dans un ou plusieurs objets Repeater.
Le premier élément du tableau correspond à l’objet Repeater le plus externe. Par exemple, si la propriété repeaterIndices a la valeur [2,4] cela signifie que l’objet Repeater extérieur a utilisé l’élément dataProvider[2] et que l’objet Repeater intérieur a utilisé l’élément dataProvider[4].
Notez que cette propriété est différente de la propriété instanceIndices si la propriété startingIndex de l’un des objets Repeater n’a pas la valeur 0. Par exemple, même si un composant Repeater commence à l’élément dataProvider[4], la référence du document au premier objet répété est b[0] et non b[4].
Implémentation
public function get repeaterIndices():Array public function set repeaterIndices(value:Array):voidrepeaters | propriété |
repeaters:Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Tableau contenant des références aux objets Repeater dans le document parent ayant produit ce composant UIComponent. Le tableau est vide, sauf si ce composant UIComponent figure dans un ou plusieurs objets Repeater. Le premier élément correspond à l’objet Repeater le plus excentré.
Implémentation
public function get repeaters():Array public function set repeaters(value:Array):voidresourceManager | propriété |
resourceManager:IResourceManager [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 |
Référence à l’objet qui gère toutes les ressources localisées de l’application. Il s’agit d’une instance Singleton qui implémente l’interface IResourceManager.
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 unused .
Implémentation
protected function get resourceManager():IResourceManagerright | propriété |
right:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. Pour définir la propriété sur sa valeur par défaut undefined, utilisez la directive @Clear() dans MXML ou la valeur undefineddans le code ActionScript. Par exemple, dans le code MXML, right.s2="@Clear()", désélectionnez la contrainte right dans l’état s2. Ou dans le code ActionScript, button.right = undefined désélectionnez la contrainte right sur button.
Par défaut, la cible d’ancrage est la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une colonne de contrainte.
La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.
Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « col1:10 ».
Implémentation
public function get right():Object public function set right(value:Object):voidrotation | propriété |
rotation:Number[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine. Les valeurs comprises entre 0 et 180 représentent la rotation en sens horaire ; les valeurs comprises entre 0 et -180 représentent la rotation en sens anti-horaire. Les valeurs hors de cette plage sont ajoutées ou soustraites de 360 pour obtenir une valeur comprise dans la plage. Par exemple, l’instruction my_video.rotation = 450 correspond à my_video.rotation = 90.
Implémentation
override public function get rotation():Number override public function set rotation(value:Number):voidrotationX | propriété |
rotationX:Number[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Indique la rotation de l’axe des x de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. Les valeurs comprises entre 0 et 180 représentent la rotation dans le sens des aiguilles d’une montre ; les valeurs comprises entre 0 et -180 représentent la rotation dans le sens inverse des aiguilles d’une montre. Les valeurs hors de cette plage sont ajoutées ou soustraites de 360 pour obtenir une valeur comprise dans la plage. Cette propriété est ignorée lors du calcul par une présentation 2D Flex.
Implémentation
override public function get rotationX():Number override public function set rotationX(value:Number):voidrotationY | propriété |
rotationY:Number[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique la rotation de l’axe des y de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. Les valeurs comprises entre 0 et 180 représentent la rotation dans le sens des aiguilles d’une montre ; les valeurs comprises entre 0 et -180 représentent la rotation dans le sens inverse des aiguilles d’une montre. Les valeurs hors de cette plage sont ajoutées ou soustraites de 360 pour obtenir une valeur comprise dans la plage. Cette propriété est ignorée lors du calcul par une présentation 2D Flex.
Implémentation
override public function get rotationY():Number override public function set rotationY(value:Number):voidrotationZ | propriété |
rotationZ:Number[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique la rotation de l’axe des z de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. Les valeurs comprises entre 0 et 180 représentent la rotation dans le sens des aiguilles d’une montre ; les valeurs comprises entre 0 et -180 représentent la rotation dans le sens inverse des aiguilles d’une montre. Les valeurs hors de cette plage sont ajoutées ou soustraites de 360 pour obtenir une valeur comprise dans la plage.
Implémentation
override public function get rotationZ():Number override public function set rotationZ(value:Number):voidscaleX | propriété |
scaleX:Number[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nombre spécifiant le facteur de mise à l’échelle horizontale.
La valeur par défaut est 1,0, ce qui signifie que l’objet n’est pas redimensionné. Une valeur scaleX de 2.0 signifie que l’objet a été agrandi par 2 et une valeur scaleX de 0.5 signifie que l’objet a été réduit par 2.
La valeur 0.0 n’est pas valide. Au lieu de le définir sur 0.0, choisissez une valeur faible ou définissez la propriété visible sur false pour masquer le composant.
La valeur par défaut est 1.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 scaleXChanged .
Implémentation
override public function get scaleX():Number override public function set scaleX(value:Number):voidscaleY | propriété |
scaleY:Number[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nombre spécifiant le facteur de mise à l’échelle verticale.
La valeur par défaut est 1,0, ce qui signifie que l’objet n’est pas redimensionné. Une valeur scaleY de 2.0 signifie que l’objet a été agrandi par 2 et une valeur scaleY de 0.5 signifie que l’objet a été réduit par 2.
La valeur 0.0 n’est pas valide. Au lieu de le définir sur 0.0, choisissez une valeur faible ou définissez la propriété visible sur false pour masquer le composant.
La valeur par défaut est 1.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 scaleYChanged .
Implémentation
override public function get scaleY():Number override public function set scaleY(value:Number):voidscaleZ | propriété |
scaleZ:Number[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nombre spécifiant le facteur de mise à l’échelle sur l’axe z.
Une mise à l’échelle le long de l’axe z n’a pas d’incidence sur un composant standard, allongé dans le plan z=0. Les composants avec enfants auxquels sont appliquées des transformations 3D ou composants avec une valeur de la propriété transformZ différente de zéro, sont affectés.
La valeur par défaut est 1,0, ce qui signifie que l’objet n’est pas redimensionné.
Cette propriété est ignorée lors du calcul par une présentation 2D Flex.
La valeur par défaut est 1.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 scaleZChanged .
Implémentation
override public function get scaleZ():Number override public function set scaleZ(value:Number):voidscreen | propriété |
screen:Rectangle [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie un objet contenant la taille et la position de la surface de tracé de base pour cet objet.
Implémentation
public function get screen():RectangleshowInAutomationHierarchy | propriété |
showInAutomationHierarchy: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 détermine si un objet d’automatisation s’affiche dans la hiérarchie d’automatisation. Les enfants des conteneurs qui ne sont pas visibles dans la hiérarchie apparaissent en tant qu’enfants du parent visible le plus élevé suivant. En général, les conteneurs utilisés pour la présentation (par exemple, cases et dessins) n’apparaissent pas dans la hiérarchie.
Certains contrôles forcent leurs enfants à apparaître dans la hiérarchie lorsque cela est approprié. Par exemple, une liste force toujours les fonctionnalités de rendu d’éléments, y compris les cases, à apparaître dans la hiérarchie. Les implémenteurs doivent prendre en charge la définition de cette propriété sur true.
Implémentation
public function get showInAutomationHierarchy():Boolean public function set showInAutomationHierarchy(value:Boolean):voidstates | propriété |
states:Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Etats d’affichage définis pour ce composant. La propriété states peut être spécifiée uniquement sur la racine de l’application ou sur la balise racine d’un composant MXML. Le compilateur génère une erreur si vous la spécifiez sur une autre commande.
Implémentation
public function get states():Array public function set states(value:Array):voidstyleDeclaration | propriété |
styleDeclaration:CSSStyleDeclaration| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Stockage pour les styles d’héritage intégrés sur cet objet. Cet objet CSSStyleDeclaration est créé lors du premier appel de la méthode setStyle() sur ce composant afin de définir un style d’héritage. En règle générale, les développeurs n’ont jamais besoin d’accéder à cette propriété directement.
Implémentation
public function get styleDeclaration():CSSStyleDeclaration public function set styleDeclaration(value:CSSStyleDeclaration):voidstyleManager | propriété |
styleManager:IStyleManager2 [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie l’instance SystemManager utilisée par ce composant.
Implémentation
public function get styleManager():IStyleManager2styleName | propriété |
styleName:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Style de classe utilisé par ce composant. Il peut s’agir d’une chaîne, d’une déclaration CSSStyleDeclaration ou d’une interface IStyleClient.
S’il s’agit d’une chaîne, elle correspond au nom d’une ou plusieurs déclarations de classe séparées par des espaces blancs dans une balise <fx:Style> ou un fichier CSS. N’incluez pas le point dans la propriété styleName. Par exemple, si vous disposez d’un style de classe nommé ".bigText", définissez la propriété styleName sur "bigText" (sans point).
S’il s’agit d’une interface IStyleClient (généralement un composant UIComponent), tous les styles de l’objet styleName sont utilisés par ce composant.
La valeur par défaut est null.
Implémentation
public function get styleName():Object public function set styleName(value:Object):voidstyleParent | propriété |
styleParent:IAdvancedStyleClient| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Le parent d’un composant permet d’évaluer les sélecteurs descendants. Un parent doit également être une interface IAdvancedStyleClient pour participer aux déclarations de style avancées.
Implémentation
public function get styleParent():IAdvancedStyleClient public function set styleParent(value:IAdvancedStyleClient):voidsystemManager | propriété |
systemManager:ISystemManager| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie l’objet SystemManager utilisé par ce composant.
Implémentation
public function get systemManager():ISystemManager public function set systemManager(value:ISystemManager):voidtabFocusEnabled | propriété |
tabFocusEnabled:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Indicateur qui signale si cet objet peut recevoir le focus via la touche de tabulation
Cette fonction est similaire à la propriété tabEnabled de Flash Player.
Cette valeur est généralement true pour les composants qui traitent les entrée au clavier, mais certains composants des barres de contrôle la définissent sur false, car il est conseillé de ne pas voler le focus d’un autre composant (un éditeur, par exemple).
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 tabFocusEnabledChange .
Implémentation
public function get tabFocusEnabled():Boolean public function set tabFocusEnabled(value:Boolean):voidtoolTip | propriété |
toolTip:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Texte à afficher dans l’info-bulle.
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 toolTipChanged .
Implémentation
public function get toolTip():String public function set toolTip(value:String):voidtop | propriété |
top:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. Pour définir la propriété sur sa valeur par défaut undefined, utilisez la directive @Clear() dans MXML ou la valeur undefineddans le code ActionScript. Par exemple, dans le code MXML, top.s2="@Clear()", désélectionnez la contrainte top dans l’état s2. Ou dans le code ActionScript, button.top = undefined désélectionnez la contrainte top sur button.
Par défaut, la cible d’ancrage est la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une ligne de contrainte.
La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.
Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « row1:10 ».
Implémentation
public function get top():Object public function set top(value:Object):voidtransform | propriété |
transform:flash.geom:Transform[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage. Les propriétés spécifiques, telles que matrix, colorTransform et trois propriétés en lecture seule (concatenatedMatrix, concatenatedColorTransform et pixelBounds) sont décrites dans la section relative à la classe Transform.
Chacune des propriétés de l’objet transform constitue un objet. Ce concept est important dans la mesure où la seule façon de définir de nouvelles valeurs pour les objets matrix ou colorTransform consiste à créer un objet et à le copier dans la propriété transform.matrix ou transform.colorTransform.
Par exemple, pour augmenter la valeur tx d’une matrice d’objet d’affichage, vous devez copier l’ensemble de l’objet de la matrice, puis copier le nouvel objet dans la propriété matrix de l’objet transform :
var myMatrix:Matrix = myUIComponentObject.transform.matrix;
myMatrix.tx += 10;
myUIComponent.transform.matrix = myMatrix;
Vous ne pouvez pas définir directement la propriété tx. Le code suivant n’a pas d’effet sur myUIComponent :
myUIComponent.transform.matrix.tx += 10;
Notez que pour UIComponent, contrairement à DisplayObject, l’opération transform conserve la synchronisation des valeurs matrix et matrix3D et matrix3D n’est pas null, même lorsque le composant lui-même n’a aucune propriété 3D définie. Les développeurs doivent utiliser la propriété is3D pour vérifier si le composant dispose de propriétés 3D définies. Si le composant a des propriétés 3D, la propriété matrix3D de la transformation doit être utilisée à la place de la propriété matrix.
Implémentation
override public function get transform():flash.geom:Transform override public function set transform(value:flash.geom:Transform):voidEléments de l’API associés
transformX | propriété |
transformX:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Définit la coordonnée x du centre de la transformation du composant.
Lorsque ce composant est la cible d’un effet de transformation Spark, vous pouvez remplacer cette propriété en définissant la propriété AnimateTransform.autoCenterTransform. Si autoCenterTransform est false, le centre de la transformation est déterminé par les propriétés transformX, transformY et transformZ de la cible de l’effet. Si autoCenterTransform est true, l’effet se produit autour du centre de la cible, (largeur/2, hauteur/2).
La définition de cette propriété sur la classe d’effet Spark remplace le paramètre sur le composant cible.
Implémentation
public function get transformX():Number public function set transformX(value:Number):voidEléments de l’API associés
transformY | propriété |
transformY:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Définit la coordonnée y du centre de la transformation du composant.
Lorsque ce composant est la cible d’un effet de transformation Spark, vous pouvez remplacer cette propriété en définissant la propriété AnimateTransform.autoCenterTransform. Si autoCenterTransform est false, le centre de la transformation est déterminé par les propriétés transformX, transformY et transformZ de la cible de l’effet. Si autoCenterTransform est true, l’effet se produit autour du centre de la cible, (largeur/2, hauteur/2).
La définition de cette propriété sur la classe d’effet Spark remplace le paramètre sur le composant cible.
Implémentation
public function get transformY():Number public function set transformY(value:Number):voidEléments de l’API associés
transformZ | propriété |
transformZ:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Définit la coordonnée z du centre de la transformation du composant.
Lorsque ce composant est la cible d’un effet de transformation Spark, vous pouvez remplacer cette propriété en définissant la propriété AnimateTransform.autoCenterTransform. Si autoCenterTransform est false, le centre de la transformation est déterminé par les propriétés transformX, transformY et transformZ de la cible de l’effet. Si autoCenterTransform est true, l’effet se produit autour du centre de la cible, (largeur/2, hauteur/2).
La définition de cette propriété sur la classe d’effet Spark remplace le paramètre sur le composant cible.
Implémentation
public function get transformZ():Number public function set transformZ(value:Number):voidEléments de l’API associés
transitions | propriété |
transitions:Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Implémentation
public function get transitions():Array public function set transitions(value:Array):voidEléments de l’API associés
tweeningProperties | propriété |
tweeningProperties:Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Tableau de propriétés en cours d’interpolation sur cet objet.
Utilisé pour avertir le gestionnaire EffectManager que certaines propriétés de cet objet sont en cours d’interpolation, de sorte qu’il ne tente pas d’animer les mêmes propriétés.
Implémentation
public function get tweeningProperties():Array public function set tweeningProperties(value:Array):voiduid | propriété |
uid:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Identifiant unique de l’objet. Les commandes de données Flex, y compris toutes les commandes correspondant à des sous-classes de la classe List, utilisent un UID pour le suivi des éléments du fournisseur de données.
Flex peut automatiquement créer et gérer des UID. Toutefois, dans certaines circonstances vous devez fournir votre propre propriété uid en implémentant l’interface IUID, ou fournir votre propre propriété uid pour améliorer l’efficacité de traitement. Les UID n’ont pas besoin d’être universellement uniques pour la plupart des utilisations dans Flex. Les messages transmis par les services de données constituent une exception.
Implémentation
public function get uid():String public function set uid(value:String):voidEléments de l’API associés
unscaledHeight | propriété |
unscaledHeight: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 |
Méthode pratique pour déterminer la hauteur non mise à l’échelle du composant. L’ensemble du traçage et de la présentation des enfants d’un composant doit être réalisé dans un rectangle de délimitation de cette hauteur, qui est également transmise comme argument à la méthode updateDisplayList().
Implémentation
protected function get unscaledHeight():NumberunscaledWidth | propriété |
unscaledWidth: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 |
Méthode pratique pour déterminer la hauteur non mise à l’échelle du composant. L’ensemble du traçage et de la présentation des enfants d’un composant doit être réalisé dans un rectangle de délimitation de cette largeur, qui est également transmise comme argument à la méthode updateDisplayList().
Implémentation
protected function get unscaledWidth():NumberupdateCompletePendingFlag | propriété |
updateCompletePendingFlag: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 déterminant si un objet a traversé les trois phases de validation de mise en forme (si besoin était).
Implémentation
public function get updateCompletePendingFlag():Boolean public function set updateCompletePendingFlag(value:Boolean):voidvalidationSubField | propriété |
validationSubField:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Utilisé par un validateur pour associer un sous-champ à ce composant.
Implémentation
public function get validationSubField():String public function set validationSubField(value:String):voidverticalCenter | propriété |
verticalCenter:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Pour les composants, cette propriété de contrainte de mise en page est une façade s’ajoutant au style du même nom. Pour définir la propriété sur sa valeur par défaut undefined, utilisez la directive @Clear() dans MXML ou la valeur undefineddans le code ActionScript. Par exemple, dans le code MXML, verticalCenter.s2="@Clear()", désélectionnez la contrainte verticalCenter dans l’état s2. Ou dans le code ActionScript, button.verticalCenter = undefined désélectionnez la contrainte verticalCenter sur button.
La cible d’ancrage par défaut est le conteneur lui-même.
Dans les présentations avec contraintes avancées, la cible peut être une ligne de contrainte. La zone de contenu est alors l’espace entre la rangée précédente (ou le côté du conteneur) et la rangée cible.
Définir la propriété sur un nombre ou une chaîne numérique (par exemple, 10) spécifie l’utilisation de la cible d’ancrage par défaut.
Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « constraintColumnId:value ». Par exemple, « row1:10 ».
Implémentation
public function get verticalCenter():Object public function set verticalCenter(value:Object):voidvisible | propriété |
visible:Boolean[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique si l’objet d’affichage est visible ou non. Les objets d’affichage qui ne sont pas visibles sont désactivés. Par exemple, si visible=false pour une instance InteractiveObject, il est impossible de cliquer sur cette dernière.
Lorsque la valeur est définie sur true, l’objet distribue un événement show. Lorsque la valeur est définie sur false, l’objet distribue un événement hide. Dans les deux cas, les enfants de l’objet ne génèrent pas d’événement show ou hide, sauf si l’objet écrit de façon explicite une telle implémentation.
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 show .
Implémentation
override public function get visible():Boolean override public function set visible(value:Boolean):voidwidth | propriété |
width:Number[override] | 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éfinissant la largeur du composant en pixels, dans les coordonnées du parent. La valeur par défaut est 0, mais cette propriété contient la largeur réelle du composant dès lors que Flex termine le dimensionnement des composants de l’application.
Remarque : vous pouvez spécifier une valeur de pourcentage pour l’attribut MXML width, par exemple width="100%", mais pas pour la propriété width dans ActionScript. Utilisez plutôt la propriété percentWidth.
La définition de cette propriété entraîne la distribution d’un événement resize. Reportez-vous à l’événement resize pour plus d’informations sur le moment de distribution de cet événement.
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 widthChanged .
Implémentation
override public function get width():Number override public function set width(value:Number):voidEléments de l’API associés
x | propriété |
x:Number[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nombre spécifiant la position horizontale du composant, en pixels, au sein de son conteneur parent.
La définition de cette propriété directement, ou en appelant la méthode move() n’a aucun effet (ou seulement un effet temporaire) si le composant a pour parent un conteneur de présentation tel que HBox, Grid ou Form. En effet, les calculs de présentation de ces conteneurs définissent la position x d’après les résultats des calculs. Toutefois, la propriété x doit être quasiment toujours définie lorsque le parent est un conteneur Canvas ou tout autre conteneur à positionnement absolu, car la valeur par défaut est 0.
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 xChanged .
Implémentation
override public function get x():Number override public function set x(value:Number):voidy | propriété |
y:Number[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nombre spécifiant la position verticale du composant, en pixels, au sein de son conteneur parent.
La définition de cette propriété directement, ou en appelant la méthode move() n’a aucun effet (ou seulement un effet temporaire) si le composant a pour parent un conteneur de présentation tel que HBox, Grid ou Form. En effet, les calculs de présentation de ces conteneurs définissent la position x d’après les résultats des calculs. Toutefois, la propriété x doit être quasiment toujours définie lorsque le parent est un conteneur Canvas ou tout autre conteneur à positionnement absolu, car la valeur par défaut est 0.
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 yChanged .
Implémentation
override public function get y():Number override public function set y(value:Number):voidz | propriété |
z:Number[override] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Indique la position de coordonnée z le long de l’axe z de l’occurrence de DisplayObject par rapport au conteneur 3D parent. La propriété z est utilisée avec des coordonnées 3D et non avec des coordonnées d’écran ou de pixel.
Lorsque vous réglez la propriété z d’un objet d’affichage sur une valeur autre que la valeur par défaut, à savoir 0, l’objet Matrix3D correspondant est automatiquement créé pour régler la position et l’orientation 3D d’un objet d’affichage. Lorsque l’on utilise l’axe des z, le comportement existant des propriétés x et y passe des coordonnées d’écran ou pixel aux positions par rapport au conteneur 3D parent.
Par exemple, un enfant de _root dont la position est x = 100, y = 100, z = 200 n’est pas dessiné à l’emplacement du pixel (100,100). L’enfant est dessiné à l’endroit où les calculs de projection 3D le placent. Ce calcul est :
(x*cameraFocalLength/cameraRelativeZPosition, y*cameraFocalLength/cameraRelativeZPosition)
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 zChanged .
Implémentation
override public function get z():Number override public function set z(value:Number):voidUIComponent | () | Constructeur |
public function UIComponent()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
addStyleClient | () | méthode |
public function addStyleClient(styleClient:IAdvancedStyleClient):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Ajoute un client de style non visuel à cette instance de composant. Une fois que cette méthode a été appelée, le client de style héritera les changements de style à partir de cette instance de composant. Les clients de style qui sont des objets DisplayObject doivent utiliser les méthodes addChild ou addChildAt pour être ajoutés à un composant UIComponent. De façon collatérale, cette méthode définit la propriété styleParent du paramètre styleClient pour faire référence à cette instance du composant UIComponent. Si le paramètre styleClient possède déjà une propriété styleParent, cette méthode appelle removeStyleClient à partir de cette propriété styleParent précédente.
Paramètres
styleClient:IAdvancedStyleClient — L’interface IAdvancedStyleClient à ajouter à la liste de clients de style non visuels de ce composant.
|
Valeur émise
ArgumentError — si le paramètre styleClient est un objet DisplayObject.
|
Eléments de l’API associés
mx.styles.IAdvancedStyleClient
adjustFocusRect | () | méthode |
protected function adjustFocusRect(obj:DisplayObject = 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 |
Ajuste le rectangle de focus.
Paramètres
obj:DisplayObject (default = null) |
applyComputedMatrix | () | méthode |
protected function applyComputedMatrix():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Valide la matrice calculée générée par combinaison de la matrice de présentation et des décalages de transformation de la transformation de l’objet flash displayObject.
attachOverlay | () | méthode |
protected function attachOverlay():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Il s’agit d’une méthode interne utilisée par la structure Flex pour prendre en charge l’effet Fondre. Il est inutile de l’appeler ou de la remplacer.
callLater | () | méthode |
public function callLater(method:Function, args:Array = 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 |
Place en attente une fonction à appeler ultérieurement.
Avant chaque actualisation de l’écran, Flash Player ou AIR appelle le jeu de fonctions prévues pour l’actualisation. Parfois, une fonction doit être appelée dans la prochaine actualisation pour permettre l’exécution du code restant prévu pour l’actualisation en cours. Certaines fonctionnalités, comme les effets, peuvent retarder les fonctions en attente jusqu’à ce que la fonctionnalité se termine.
Paramètres
method:Function — Référence à une méthode à exécuter ultérieurement.
| |
args:Array (default = null) |
canSkipMeasurement | () | méthode |
protected function canSkipMeasurement():Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Détermine si l’appel à la méthode measure() peut être ignoré.
Boolean — Renvoie true lorsque la méthode measureSizes() peut ignorer l’appel à la méthode measure(). Par exemple, la valeur est généralement la valeur true lorsque explicitWidth et explicitHeight sont chacun défini. Pour les chemins, la valeur est true lorsque les limites du chemin n’ont pas changé.
|
childrenCreated | () | méthode |
protected function childrenCreated():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Effectue les traitements finals éventuels après la création des objets enfant. Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de la classe UIComponent.
clearStyle | () | méthode |
public function clearStyle(styleProp:String):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Supprime une propriété de style de cette instance de composant.
La méthode getStyle() ne renvoie pas nécessairement la valeur undefined.
Paramètres
styleProp:String — Nom de la propriété de style.
|
commitProperties | () | méthode |
protected function commitProperties():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Traite les propriétés définies sur le composant. Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de la classe UIComponent.
Vous n’appelez pas cette méthode directement. Flex appelle la méthode commitProperties() lorsque vous utilisez la méthode addChild() pour ajouter un composant à un conteneur ou lorsque vous appelez la méthode invalidateProperties() du composant. Les appels de la méthode commitProperties() sont réalisés avant les appels de la méthode measure(). Ainsi, vous pouvez définir des valeurs de propriété susceptibles d’être utilisées par la méthode measure().
Certains composants présentent des propriétés influant sur le nombre ou le type d’objets enfant à créer, ou des propriétés liées les unes aux autres, telles que horizontalScrollPolicy et horizontalScrollPosition. En règle générale, il est préférable de traiter toutes ces propriétés en même temps au démarrage pour éviter d’avoir à réaliser plusieurs fois les mêmes opérations.
contentToGlobal | () | méthode |
public function contentToGlobal(point:Point):Point| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Convertit un objet Point de coordonnées de contenu en coordonnées globales. Les coordonnées de contenu spécifient une position de pixel par rapport au coin supérieur gauche du contenu du composant. Elles incluent l’ensemble de la zone de contenu du composant, y compris les régions actuellement découpées, accessibles uniquement par défilement du composant. Le système de coordonnées du contenu permet de définir et d’obtenir les positions des enfants d’un conteneur qui utilise le positionnement absolu. Les coordonnées globales spécifient une position de pixel par rapport au coin supérieur gauche de la scène, qui est la bordure extérieure de l’application.
Paramètres
point:Point — Objet Point qui spécifie les coordonnées x et y dans le système de coordonnées du contenu en tant que propriétés.
|
Point — Objet Point dont les coordonnées sont relatives à la scène.
|
Eléments de l’API associés
contentToLocal | () | méthode |
public function contentToLocal(point:Point):Point| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Convertit un objet Point de coordonnées de contenu en coordonnées locales. Les coordonnées de contenu spécifient une position de pixel par rapport au coin supérieur gauche du contenu du composant. Elles incluent l’ensemble de la zone de contenu du composant, y compris les régions actuellement découpées, accessibles uniquement par défilement du composant. Le système de coordonnées du contenu permet de définir et d’obtenir les positions des enfants d’un conteneur qui utilise le positionnement absolu. Les coordonnées locales spécifient une position de pixel par rapport au coin supérieur gauche du composant.
Paramètres
point:Point — Objet Point qui spécifie les coordonnées x et y dans le système de coordonnées du contenu en tant que propriétés.
|
Point — Pointer sur un objet Point dont les coordonnées sont relatives au système de coordonnées local.
|
Eléments de l’API associés
createAutomationIDPart | () | méthode |
public function createAutomationIDPart(child:IAutomationObject):Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie un ensemble de propriétés qui identifient l’enfant au sein de ce conteneur. Ces valeurs ne doivent pas changer pendant la durée de vie de l’application.
Paramètres
child:IAutomationObject — Enfant pour lequel fournir l’ID.
|
Object — Ensemble de propriétés décrivant l’enfant qui peut par la suite être utilisé pour résoudre le composant.
|
createAutomationIDPartWithRequiredProperties | () | méthode |
public function createAutomationIDPartWithRequiredProperties(child:IAutomationObject, properties:Array):Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie un ensemble de propriétés qui identifient l’enfant au sein de ce conteneur. Ces valeurs ne doivent pas changer pendant la durée de vie de l’application.
Paramètres
child:IAutomationObject — Enfant pour lequel fournir l’ID.
| |
properties:Array |
Object — Ensemble de propriétés décrivant l’enfant qui peut par la suite être utilisé pour résoudre le composant.
|
createChildren | () | méthode |
protected function createChildren():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Crée les objets enfant du composant. Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de la classe UIComponent.
Un composant qui crée d’autres composants ou des objets à l’intérieur de ce composant s’appelle un composant composite. Par exemple, le contrôle ComboBox de Flex est réellement composé d’un contrôle TextInput qui permet de définir la zone de texte du contrôle ComboBox et d’un contrôle Button qui définit la flèche du contrôle ComboBox. Les composants implémentent la méthode createChildren() pour créer des objets enfant (d’autres composants, par exemple) dans le composant.
Vous appelez la méthode addChild() au sein d’un remplacement de la méthode createChildren() pour ajouter chaque objet enfant.
Vous n’appelez pas cette méthode directement. Flex appelle la méthode createChildren() en réponse à l’appel de la méthode addChild() pour ajouter le composant à son parent.
createInFontContext | () | méthode |
protected function createInFontContext(classObj:Class):Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Crée un nouvel objet à l’aide d’un contexte basé sur la police incorporée en cours d’utilisation.
Cette méthode est utilisée pour la résolution d’un problème concernant l’accès aux polices incorporées dans un fichier SWF d’application lorsque la structure est chargée en tant que bibliothèque RSL (la bibliothèque RSL possède son propre fichier SWF de contexte). Les polices incorporées sont uniquement accessibles à partir du fichier SWF du contexte dans lequel elles ont été créées. A l’aide du contexte du fichier SWF de l’application, la bibliothèque RSL peut créer des objets dans le fichier SWF de contexte de l’application ayant accès aux polices incorporées de l’application.
Appelez cette méthode uniquement après la définition des styles de police pour cet objet.
Paramètres
classObj:Class — Classe à créer.
|
Object — Instance de la classe créée dans le contexte du fichier SWF propriétaire de la police incorporée. Si cet objet n’utilise aucune police incorporée, la classe est créée dans le contexte de l’objet.
|
createInModuleContext | () | méthode |
protected function createInModuleContext(moduleFactory:IFlexModuleFactory, className:String):Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Crée l’objet à l’aide d’une fabrique moduleFactory donnée. Si la propriété moduleFactory a la valeur null ou l’objet ne peut pas être créé à l’aide de la fabrique de module, revenez à la création de l’objet par un gestionnaire systemManager.
Paramètres
moduleFactory:IFlexModuleFactory — Fabrique moduleFactory dans laquelle créer la classe. Peut avoir la valeur null.
| |
className:String — Nom de la classe à créer.
|
Object — Objet créé dans le contexte de la fabrique moduleFactory.
|
createReferenceOnParentDocument | () | méthode |
public function createReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Crée une référence d’id à cet objet IUIComponent sur son objet de document parent. Cette fonction peut créer des références multidimensionnelles telles que b[2][4] pour les objets figurant dans un ou plusieurs objets Repeater. Si les indices ont la valeur null, il crée une référence simple, sans tableau.
Paramètres
parentDocument:IFlexDisplayObject — Parent de cet objet IUIComponent.
|
deleteReferenceOnParentDocument | () | méthode |
public function deleteReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Supprime la référence d’id à cet objet IUIComponent sur son objet de document parent. Cette fonction peut effectuer des suppressions dans des références multidimensionnelles telles que b[2][4] pour les objets figurant dans un ou plusieurs objets Repeater. Si les index sont définis sur null, elle supprime la référence simple autre qu’un tableau.
Paramètres
parentDocument:IFlexDisplayObject — Parent de cet objet IUIComponent.
|
determineTextFormatFromStyles | () | méthode |
public function determineTextFormatFromStyles():mx.core:UITextFormat| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie un objet UITextFormat correspondant aux styles du texte pour ce composant UIComponent.
Valeur renvoyéemx.core:UITextFormat — Objet UITextFormat correspondant aux styles du texte pour ce composant UIComponent.
|
dispatchEvent | () | méthode |
override public function dispatchEvent(event:Event):Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribue un événement dans le flux d’événements. La cible de l’événement est l’objet EventDispatcher sur lequel la méthode dispatchEvent() est appelée.
Paramètres
event:Event — Objet Event qui est distribué dans le flux d’événements. Si l’événement est redistribué, un clone est automatiquement créé. Après la distribution d’un événement, il est impossible de modifier sa propriété target. Pour que la redistribution fonctionne, vous devez donc créer une copie de l’événement.
|
Boolean — Une valeur true si l’événement a bien été distribué. Une valeur false indique un échec ou que la méthode preventDefault() a été appelée sur l’événement.
|
dispatchPropertyChangeEvent | () | méthode |
protected function dispatchPropertyChangeEvent(prop:String, oldValue:*, value:*):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Méthode d’assistance permettant la distribution d’un événement PropertyChangeEvent lorsqu’une propriété est actualisée.
Paramètres
prop:String — Nom de la propriété qui a changé.
| |
oldValue:* — Ancienne valeur de la propriété.
| |
value:* — Nouvelle valeur de la propriété.
|
drawFocus | () | méthode |
public function drawFocus(isFocused:Boolean):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Affiche ou masque l’indicateur de focus autour de ce composant.
UIComponent effectue cette implémentation en créant une instance de la classe spécifiée par le style focusSkin et en la positionnant de manière approprié.
Paramètres
isFocused:Boolean — Détermine si l’indicateur de focus doit être affiché. Définissez la propriété sur true pour afficher l’indicateur de focus. Définissez la propriété sur false pour le masquer.
|
drawRoundRect | () | méthode |
public function 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| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Trace par programmation un rectangle dans l’objet Graphics de cet habillage.
Le rectangle peut présenter des coins arrondis. Ses bords sont tracés avec le style de trait actuel de l’objet Graphics. Elle peut avoir un remplissage de couleur unie, un remplissage dégradé, ou pas de remplissage. Un remplissage uni peut avoir une transparence alpha. Un remplissage dégradé peut être linéaire ou radial. Vous pouvez définir jusqu’à 15 couleurs et valeurs alpha à des points spécifiques le long du dégradé. Vous pouvez également spécifier un angle de rotation ou une matrice de transformation pour le dégradé. Enfin, un trou rectangulaire arrondi peut être découpé dans le rectangle.
Cette routine de tracé de rectangle polyvalente est utilisée par de nombreux habillages. Il appelle les méthodes drawRect() ou drawRoundRect() (dans la classe flash.display.Graphics) pour tracer dans l’objet Graphics de cet habillage.
Paramètres
x:Number — Position horizontale du coin supérieur gauche du rectangle dans cet habillage.
| |
y:Number — Position verticale du coin supérieur gauche du rectangle dans cet habillage.
| |
w:Number — Largeur du rectangle en pixels.
| |
h:Number — Hauteur du rectangle en pixels.
| |
r:Object (default = null)null, à un nombre ou à un objet. Si la valeur est null, elle indique que les coins doivent être carrés et non pas arrondis. S’il s’agit d’un nombre, il indique le même rayon en pixels pour les quatre coins. S’il s’agit d’un objet, il doit présenter des propriétés appelées tl, tr, bl et br, dont les valeurs sont des nombres spécifiant le rayon (en pixels) pour les coins supérieur gauche, supérieur droit, inférieur gauche et inférieur droit. Par exemple, vous pouvez transmettre un objet simple tel que { tl: 5, tr: 5, bl: 0, br: 0 }. La valeur par défaut est null (angles carrés).
| |
c:Object (default = null)null, à un uint ou à un tableau. Si la valeur est null, le rectangle n’est pas rempli. S’il s’agit d’un uint, il indique une couleur RVB de remplissage. Par exemple, transmettez 0xFF0000 pour un remplissage en rouge. S’il s’agit d’un tableau, il doit contenir des nombres uint spécifiant les couleurs de dégradé. Par exemple, transmettez [ 0xFF0000, 0xFFFF00, 0x0000FF ] pour un remplissage dégradé du rouge au bleu en passant par le jaune. Vous pouvez définir jusqu’à 15 couleurs dans le dégradé. La valeur par défaut est null (aucun remplissage).
| |
alpha:Object (default = null)colora la valeur null. Si la propriété color est un uint spécifiant une couleur RVB de remplissage, alors alpha doit être un nombre spécifiant la transparence du remplissage, où 0.0 est entièrement transparent et 1.0 est entièrement opaque. Dans ce cas, vous pouvez également transmettre la valeur null au lieu de 1,0 pour spécifier l’opacité complète. Si la propriété color est un tableau spécifiant des couleurs de dégradé, alors alpha doit être un tableau de nombres de même longueur, spécifiant les valeurs alpha correspondantes du dégradé. Dans ce cas, la valeur par défaut est null (entièrement opaque).
| |
rot:Object (default = null)horizontalGradientMatrix(), verticalGradientMatrix() et rotatedGradientMatrix() peuvent être utilisées pour créer la valeur de ce paramètre.
| |
gradient:String (default = null)GradientType.LINEAR ou GradientType.RADIAL (la classe GradientType figure dans le package flash.display).
| |
ratios:Array (default = null)color. Chaque valeur définit le pourcentage de la largeur où la couleur est échantillonnée sur 100 %. La valeur 0 représente la position de gauche dans la zone de dégradés, tandis que 255 représente la position de droite.
| |
hole:Object (default = null) |
Eléments de l’API associés
effectFinished | () | méthode |
public function effectFinished(effectInst:IEffectInstance):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Appelé par l’instance d’effet lors de la fin de sa lecture sur le composant. Vous pouvez utiliser cette méthode pour restaurer une modification du composant apportée par la méthode effectStarted() lors du lancement de l’effet ou effectuer une autre action à la fin de l’effet.
Paramètres
effectInst:IEffectInstance — Objet d’instance de l’effet en cours de lecture sur le composant.
|
effectStarted | () | méthode |
public function effectStarted(effectInst:IEffectInstance):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Appelé par l’instance d’effet lors du début de sa lecture sur le composant. Vous pouvez utiliser cette méthode pour effectuer une modification du composant dans le cadre d’un effet. Vous pouvez utiliser la méthode effectFinished() pour restaurer la modification à la fin de l’effet.
Paramètres
effectInst:IEffectInstance — Objet d’instance de l’effet en cours de lecture sur le composant.
|
endEffectsStarted | () | méthode |
public function endEffectsStarted():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Termine tous les effets en cours de lecture sur le composant.
executeBindings | () | méthode |
public function executeBindings(recurse:Boolean = false):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Exécute toutes les liaisons dont l’objet UIComponent est la destination.
Paramètres
recurse:Boolean (default = false) |
finishPrint | () | méthode |
public function finishPrint(obj:Object, target:IFlexDisplayObject):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Appelée après la fin de l’impression. Pour la classe UIComponent, la méthode n’effectue aucune action. Les conteneurs Flex remplacent la méthode pour restaurer le conteneur après l’impression.
Normalement, cette méthode n’est pas utilisée par les développeurs d’applications.
Paramètres
obj:Object — Contient les propriétés du composant permettant de le restaurer dans son état avant l’impression.
| |
target:IFlexDisplayObject — Composant qui vient de terminer l’impression. Il peut s’agir du composant actif ou de l’un de ses enfants.
|
Eléments de l’API associés
focusInHandler | () | méthode |
protected function focusInHandler(event:FocusEvent):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Gestionnaire d’événement appelé lorsqu’un objet UIComponent obtient le focus. Si vous remplacez cette méthode, assurez-vous d’appeler la version de classe de base.
Paramètres
event:FocusEvent — Objet événement.
|
focusOutHandler | () | méthode |
protected function focusOutHandler(event:FocusEvent):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Gestionnaire d’événement appelé lorsqu’un objet UIComponent perd le focus. Si vous remplacez cette méthode, assurez-vous d’appeler la version de classe de base.
Paramètres
event:FocusEvent — Objet événement.
|
getAutomationChildAt | () | méthode |
public function getAutomationChildAt(index:int):IAutomationObject| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Fournit l’objet d’automatisation à l’index spécifié. Cette liste ne doit inclure aucun enfant composite.
Paramètres
index:int — Index de l’enfant à renvoyer.
|
IAutomationObject — Enfant à l’index spécifié.
|
getAutomationChildren | () | méthode |
getBoundsXAtSize | () | méthode |
public function getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée.
Cette méthode est généralement utilisée par les présentations pendant un appel de la méthode measure() pour prévoir la position de l’élément, si l’élément est redimensionné sur certaines dimensions.
Paramètres
width:Number — Largeur des limites de l’élément ou NaN pour utiliser la largeur préférée.
| |
height:Number — Hauteur des limites de l’élément ou NaN pour utiliser la hauteur préférée.
| |
postLayoutTransform:Boolean (default = true)postLayoutTransform a la valeur true, la méthode renvoie la coordonnée x du coin supérieur gauche du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément et est calculé d’après la taille des limites, la position de la présentation et la matrice de transformation de la présentation spécifiées.
|
Number — Coordonnée x des limites de l’élément à la taille d’élément spécifiée.
|
getBoundsYAtSize | () | méthode |
public function getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée. Cette méthode est généralement utilisée par les présentations pendant un appel de la méthode measure() pour prévoir la position de l’élément, si l’élément est redimensionné sur certaines dimensions.
Paramètres
width:Number — Largeur des limites de l’élément ou NaN pour utiliser la largeur préférée.
| |
height:Number — Hauteur des limites de l’élément ou NaN pour utiliser la hauteur préférée.
| |
postLayoutTransform:Boolean (default = true)postLayoutTransform est true, la méthode renvoie la coordonnée y du coin supérieur gauche du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément et est calculé d’après la taille des limites, la position de la présentation et la matrice de transformation de la présentation spécifiées.
|
Number — Coordonnée y des limites de l’élément à la taille d’élément spécifiée.
|
getClassStyleDeclarations | () | méthode |
public function getClassStyleDeclarations():Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Recherche les sélecteurs de type de cette instance UIComponent. L’algorithme remonte la chaîne de super-classe. Par exemple, supposons que la classe MyButton étende le contrôle Button. Une instance MyButton recherche d’abord un sélecteur de type MyButton, puis un sélecteur de type Button. Ensuite, elle recherche un sélecteur de type UIComponent (la chaîne de super-classe est considérée s’arrêter à la classe UIComponent et non Object).
Valeur renvoyéeArray — Tableau de sélecteurs de type de cette instance UIComponent.
|
getConstraintValue | () | méthode |
public function getConstraintValue(constraintName:String):*| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie une valeur de contrainte de présentation, ce qui revient à obtenir le style de contrainte pour ce composant.
Paramètres
constraintName:String — Nom de la contrainte de style, qui peut être l’un des suivants : left, right, top, bottom, verticalCenter, horizontalCenter, baseline.
|
* — Renvoie la valeur de contrainte de présentation, qui peut être spécifiée avec deux formes distinctes. Elle peut être spécifiée en tant que chaîne numérique, par exemple « 10 », ou en tant que chaîne identifier:numeric. Pour la chaîne identifier:numeric, l’identifiant est l’id d’un élément ConstraintRow ou ConstraintColumn. Par exemple, la valeur « cc1:10 » indique une valeur de 10 pour la colonne ConstraintColumn portant l’id« cc1 ».
|
getExplicitOrMeasuredHeight | () | méthode |
public function getExplicitOrMeasuredHeight():Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Méthode pratique pour déterminer si la hauteur explicite ou mesurée doit être utilisée
Valeur renvoyéeNumber — Nombre qui est explicitHeight si elle est définie ou measuredHeight dans le cas contraire.
|
getExplicitOrMeasuredWidth | () | méthode |
public function getExplicitOrMeasuredWidth():Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Méthode pratique pour déterminer si la largeur explicite ou mesurée doit être utilisée
Valeur renvoyéeNumber — Nombre qui est explicitWidth si elle est définie ou measuredWidth dans le cas contraire.
|
getFocus | () | méthode |
public function getFocus():InteractiveObject| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Récupère l’objet ayant actuellement le focus. Il peut ne pas s’agir de cet objet. Notez que cette méthode ne renvoie pas nécessairement le composant qui a le focus. Elle peut renvoyer le sous-composant interne du composant qui détient le focus. Pour obtenir le composant qui a le focus, utilisez la propriété focusManager.focus.
InteractiveObject — Objet qui a le focus.
|
getLayoutBoundsHeight | () | méthode |
public function getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la hauteur de présentation de l’élément. Il s’agit de la taille que l’élément utilise pour son affichage à l’écran.
Paramètres
postLayoutTransform:Boolean (default = true)postLayoutTransform a la valeur true, la méthode renvoie la largeur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille de présentation et de la matrice de transformation de présentation de l’élément.
|
Number — Hauteur de la présentation de l’élément.
|
getLayoutBoundsWidth | () | méthode |
public function getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la largeur de présentation de l’élément. Il s’agit de la taille que l’élément utilise pour son affichage à l’écran.
Paramètres
postLayoutTransform:Boolean (default = true)postLayoutTransform a la valeur true, la méthode renvoie la largeur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille de présentation et de la matrice de transformation de présentation de l’élément.
|
Number — Largeur de la présentation de l’élément.
|
getLayoutBoundsX | () | méthode |
public function getLayoutBoundsX(postLayoutTransform:Boolean = true):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran.
Paramètres
postLayoutTransform:Boolean (default = true)postLayoutTransform a la valeur true, la méthode renvoie la coordonnée x du coin supérieur gauche du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille de présentation, de la position de présentation et de la matrice de transformation de présentation de l’élément.
|
Number — Coordonnée x que l’élément utilise pour le traçage sur l’écran.
|
getLayoutBoundsY | () | méthode |
public function getLayoutBoundsY(postLayoutTransform:Boolean = true):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran.
Paramètres
postLayoutTransform:Boolean (default = true)postLayoutTransform a la valeur true, la méthode renvoie la coordonnée y du coin supérieur gauche du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille de présentation, de la position de présentation et de la matrice de transformation de présentation de l’élément.
|
Number — Coordonnée y utilisée par l’élément pour son affichage à l’écran.
|
getLayoutMatrix | () | méthode |
public function getLayoutMatrix():Matrix| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères.
Cette matrice est habituellement définie par les propriétés 2D du composant, telles que x, y, rotation, scaleX, scaleY, transformX et transformY. Certains composants peuvent comporter des propriétés de transformation supplémentaires appliquées au-dessus de la matrice de présentation pour déterminer la matrice calculée finale. Par exemple, UIComponent définit la propriété offsets.
Matrix — Matrice de transformation de la présentation pour cet élément. Au lieu de modifier directement la valeur renvoyée, appelez la méthode setLayoutMatrix().
|
getLayoutMatrix3D | () | méthode |
public function getLayoutMatrix3D():Matrix3D| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la matrice Matrix3D de transformation de présentation pour cet élément.
Cette matrice est habituellement définie par les propriétés de transformation du composant, comme x, y, z, rotationX, rotationY, rotationZ, scaleX, scaleY, scaleZ, transformX et transformY. Certains composants peuvent comporter des propriétés de transformation supplémentaires appliquées au-dessus de la matrice de présentation pour déterminer la matrice calculée finale. Par exemple, UIComponent définit la propriété offsets.
Matrix3D — Matrice Matrix3D de transformation de présentation pour cet élément. Au lieu de modifier directement la valeur renvoyée, appelez la méthode setLayoutMatrix().
|
getMaxBoundsHeight | () | méthode |
public function getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la hauteur maximale de l’élément.
Paramètres
postLayoutTransform:Boolean (default = true)postLayoutTransform a la valeur true, la méthode renvoie la hauteur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille maximale et de la matrice de transformation de présentation de l’élément.
|
Number — Hauteur maximale de l’élément.
|
getMaxBoundsWidth | () | méthode |
public function getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la largeur maximale de l’élément.
Paramètres
postLayoutTransform:Boolean (default = true)postLayoutTransform a la valeur true, la méthode renvoie la largeur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille maximale et de la matrice de transformation de présentation de l’élément.
|
Number — Largeur maximale de l’élément.
|
getMinBoundsHeight | () | méthode |
public function getMinBoundsHeight(postLayoutTransform:Boolean = true):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la hauteur minimale de l’élément.
Paramètres
postLayoutTransform:Boolean (default = true)postLayoutTransform a la valeur true, la méthode renvoie la hauteur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille minimale et de la matrice de transformation de présentation de l’élément.
|
Number — Hauteur maximale de l’élément.
|
getMinBoundsWidth | () | méthode |
public function getMinBoundsWidth(postLayoutTransform:Boolean = true):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la largeur minimale de l’élément.
Paramètres
postLayoutTransform:Boolean (default = true)postLayoutTransform a la valeur true, la méthode renvoie la largeur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille minimale et de la matrice de transformation de présentation de l’élément.
|
Number — Largeur maximale de l’élément.
|
getPreferredBoundsHeight | () | méthode |
public function getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la hauteur préférée de l’élément.
Paramètres
postLayoutTransform:Boolean (default = true)postLayoutTransform a la valeur true, la méthode renvoie la hauteur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille préférée et de la matrice de transformation de présentation de l’élément.
|
Number — Renvoie la hauteur préférée de l’élément. La hauteur par défaut est habituellement basée sur la taille d’élément par défaut et tout remplacement explicite éventuel. Pour un composant UIComponent, il s’agit de la même valeur que celle renvoyée par la méthode getExplicitOrMeasuredHeight().
|
getPreferredBoundsWidth | () | méthode |
public function getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie la largeur préférée de l’élément.
Paramètres
postLayoutTransform:Boolean (default = true)postLayoutTransform a la valeur true, la méthode renvoie la largeur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille préférée et de la matrice de transformation de présentation de l’élément.
|
Number — Renvoie la largeur préférée de l’élément. La largeur par défaut est habituellement basée sur la taille d’élément par défaut et tout remplacement explicite éventuel. Pour le composant UIComponent, il s’agit de la même valeur que celle renvoyée par la méthode getExplicitOrMeasuredWidth().
|
getRepeaterItem | () | méthode |
public function getRepeaterItem(whichRepeater:int = -1):Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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é. L’argument whichRepeater est de 0 pour l’objet Repeater le plus excentré, 1 pour le prochain objet Repeater vers l’intérieur, et ainsi de suite. Si la propriété whichRepeater n’est pas spécifiée, le composant Repeater le plus interne est utilisé.
Paramètres
whichRepeater:int (default = -1) |
Object — Elément Repeater demandé.
|
getStyle | () | méthode |
public function getStyle(styleProp:String):*| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Extrait une propriété de style ayant été définie n’importe où dans la chaîne de recherche de style de ce composant.
Cette méthode étant utilisée pour obtenir un type de propriété de style, la valeur renvoyée peut être une valeur booléenne, de chaîne, de nombre, int, uint (pour une couleur RVB), de classe (pour un habillage) ou un type d’objet. Par conséquent, le type renvoyé est simplement spécifié en tant que *.
Si vous obtenez une propriété de style particulière, vous connaissez son type et souhaitez souvent stocker le résultat dans une variable de ce type. Aucune projection n’est nécessaire depuis * vers ce type.
var backgroundColor:uint = getStyle("backgroundColor");
Si la propriété de style n’a pas été définie à un endroit quelconque de la chaîne de recherche de style, la valeur renvoyée par la méthode getStyle() est undefined. Notez que undefined est une valeur spéciale qui ne correspond pas à false, "", NaN, 0 ou null. Aucune valeur de style valide n’est jamais undefined. Vous pouvez utiliser la méthode IStyleManager2.isValidStyleValue() pour vérifier si une valeur a été définie.
Paramètres
styleProp:String — Nom de la propriété de style.
|
* — Valeur du style.
|
globalToContent | () | méthode |
public function globalToContent(point:Point):Point| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Convertit un objet Point de coordonnées globales en coordonnées de contenu. Les coordonnées globales spécifient une position de pixel par rapport au coin supérieur gauche de la scène, qui est la bordure extérieure de l’application. Les coordonnées de contenu spécifient une position de pixel par rapport au coin supérieur gauche du contenu du composant. Elles incluent l’ensemble de la zone de contenu du composant, y compris les régions actuellement découpées, accessibles uniquement par défilement du composant. Le système de coordonnées du contenu permet de définir et d’obtenir les positions des enfants d’un conteneur qui utilise le positionnement absolu.
Paramètres
point:Point — Objet Point qui spécifie les coordonnées x et y dans le système de coordonnées global (de la scène) en tant que propriétés.
|
Point — Pointer sur un objet Point dont les coordonnées sont relatives au composant.
|
Eléments de l’API associés
hasCSSState | () | méthode |
public function hasCSSState():Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.6 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Renvoie true si la valeur currentCSSState n’est pas égale à null. Vous ne devez généralement pas appeler cette méthode directement. Elle est appelée par la méthode mx.styles.CSSCondition.matchesStyleClient().
Notez que les composants Spark utilisent leur état d’habillage comme pseudo état. Les composants Halo utilisent la propriété currentState.
Boolean — Renvoie true si la valeur currentCSSState n’est pas égale à null. Par défaut, currentCSSState est identique à currentState. En l’absence d’état, elle renvoie la valeur false.
|
hasState | () | méthode |
public function hasState(stateName:String):Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Détermine si l’état spécifié a été défini sur ce composant UIComponent.
Paramètres
stateName:String — Le nom de l’état en cours de vérification.
|
Boolean — Indique si l’état spécifié a été défini ou non
|
horizontalGradientMatrix | () | méthode |
public function horizontalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Pour des raisons de performances, la matrice est stockée dans une variable statique réutilisée par tous les appels des méthodes horizontalGradientMatrix() et verticalGradientMatrix(). Par conséquent, la matrice obtenue doit être transmise à la méthode drawRoundRect() avant un nouvel appel de la méthode horizontalGradientMatrix() ou verticalGradientMatrix().
Paramètres
x:Number — Coordonnée de gauche du dégradé, en pixels.
| |
y:Number — Coordonnée supérieure du dégradé, en pixels.
| |
width:Number — Largeur du gradient, en pixels.
| |
height:Number — Hauteur du gradient, en pixels.
|
Matrix — Matrice pour le dégradé horizontal.
|
initAdvancedLayoutFeatures | () | méthode |
protected function initAdvancedLayoutFeatures():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Initialise l’implémentation et le stockage de certaines des fonctions de présentation avancées d’un composant utilisées plus rarement. Appelez cette fonction avant de tenter d’utiliser l’une des fonctions implémentées par l’objet AdvancedLayoutFeatures.
initializationComplete | () | méthode |
protected function initializationComplete():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Termine l’initialisation de ce composant.
Cette méthode est le dernier code qui s’exécute lors de l’ajout d’un composant à un parent pour la première fois à l’aide de la méthode addChild() ou addChildAt(). Elle gère certaines tâches d’entretien liées à la distribution de l’événement initialize. Si vous écrivez un composant, il est inutile de remplacer cette méthode.
initialize | () | méthode |
public function initialize():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Initialise la structure interne de ce composant.
L’initialisation d’un composant UIComponent est la quatrième étape de la création d’un composant visuel. Elle est exécutée automatiquement la première fois que l’instance est ajoutée à un parent. Par conséquent, il est généralement inutile d’appeler la méthode initialize(). La structure Flex l’appelle automatiquement à partir du remplacement par le composant UIComponent des méthodes addChild() et addChildAt().
La première étape de la création d’une instance de composant visuel est la construction, avec l’opérateur new :
var okButton:Button = new Button();
Après la construction, la nouvelle instance de la classe Button est un objet DisplayObject isolé. Elle ne présente pas encore d’objet UITextField comme enfant permettant d’afficher son libellé et elle n’a pas de parent.
La deuxième étape est la configuration de l’instance générée avec les propriétés, les styles et les gestionnaires d’événement appropriés :
okButton.label = "OK";
okButton.setStyle("cornerRadius", 0);
okButton.addEventListener(MouseEvent.CLICK, clickHandler);
La troisième étape est l’ajout de l’instance à un parent :
someContainer.addChild(okButton);
L’appel de la méthode addChild() ou addChildAt() lors du premier ajout d’un composant à un parent a pour effet secondaire l’appel automatique de la méthode initialize.
Cette méthode distribue d’abord un événement preinitialize, permettant aux développeurs utilisant ce composant de le modifier avant la création de sa structure interne. Il appelle ensuite la méthode createChildren() pour créer la structure interne du composant. Pour un composant Button, cette méthode crée et ajoute l’élément UITextField pour le libellé. Ensuite, il distribue un événement initialize permettant aux développeurs de modifier le composant après la création de sa structure interne.
Notez que l’association d’un composant à un parent pour la première fois déclenche la création de sa structure interne. Si sa structure interne comporte d’autres composants UIComponent, alors il s’agit d’un processus récursif dans lequel l’arborescence d’objets DisplayObject augmente d’un nœud terminal à la fois.
Si vous écrivez un composant, il est inutile de remplacer cette méthode.
initializeAccessibility | () | méthode |
protected function initializeAccessibility():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Initialise le code d’accessibilité de ce composant.
Cette méthode est appelée par la méthodeinitialize() pour accrocher le code d’accessibilité du composant. Ce code réside dans une classe distincte dans le package mx.accessibility. Chaque sous-classe prenant en charge l’accessibilité doit remplacer cette méthode, car le processus d’accroche utilise une variable statique distincte dans chaque sous-classe.
initializeRepeaterArrays | () | méthode |
public function initializeRepeaterArrays(parent:IRepeaterClient):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Initialise différentes propriétés qui effectuent le suivi des instances répétées de ce composant.
Une balise <mx:Repeater/> peut provoquer la création d’instances répétées d’un composant, une instance par élément du fournisseur de données de l’objet Repeater. Les propriétés instanceIndices, repeaters et repeaterIndices de l’objet UIComponent assurent le suivi des éléments de données et des objets Repeater respectifs desquels proviennent les différentes instances.
Cette méthode est une méthode interne appelée automatiquement par la structure Flex. Il est inutile de l’appeler ou de la remplacer.
Paramètres
parent:IRepeaterClient — Objet parent contenant le composant Repeater qui a créé ce composant.
|
invalidateDisplayList | () | méthode |
public function invalidateDisplayList():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Marque un composant de sorte que sa méthode updateDisplayList() soit appelée au cours d’une actualisation d’écran ultérieure.
L’invalidation est un mécanisme efficace pour éliminer la répétition inutile d’opérations. Elle retarde le traitement des modifications apportées à un composant à une actualisation d’écran ultérieure. Par exemple, si vous souhaitez modifier la largeur et la hauteur, il est inutile de mettre à jour le composant immédiatement après la modification de la largeur, puis de réaliser une autre mise à jour pour la hauteur. Il est ainsi plus efficace de modifier les deux propriétés et de rendre le composant une seule fois en utilisant les nouvelles dimensions.
Les méthodes d’invalidation sont rarement appelées. En général, le fait de définir une propriété sur un composant provoque automatiquement l’appel de la méthode d’invalidation adaptée.
invalidateLayering | () | méthode |
public function invalidateLayering():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.4 |
Appelé par les éléments d’un composant pour indiquer que leur propriété depth a changé. Notez que bien que cette fonction soit définie sur UIComponent, les sous-classes sont chargées d’implémenter la prise en charge de la superposition complexe. Par défaut, seules Group et DataGroup prennent en charge la superposition arbitraire de leurs enfants.
Eléments de l’API associés
invalidateLayoutDirection | () | méthode |
public function invalidateLayoutDirection():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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. Si celles-ci diffèrent, la méthode est chargée de la réflexion du contenu de l’élément et de la mise à jour de la transformation post-mise en forme de l’élément afin que les descendants héritent d’un système de coordonnées par symétrie. IVisualElements met généralement en œuvre la réflexion en utilisant postLayoutTransformOffsets pour réduire l’axe des abscisses par -1 et pour translater la coordonnée de l’axe des x de l’origine par la largeur de l’élément. L’effet net de cette transformation « miroir » est d’inverser la direction dans laquelle l’axe des abscisses augmente sans modifier l’emplacement de l’élément par rapport à l’origine de son parent.
invalidateParentSizeAndDisplayList | () | méthode |
protected function invalidateParentSizeAndDisplayList():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Méthode d’assistance permettant d’invalider la taille du parent et la liste d’affichage si cet objet affecte sa présentation (includeInLayout est défini sur true).
invalidateProperties | () | méthode |
public function invalidateProperties():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Marque un composant de sorte que sa méthode commitProperties() soit appelée au cours d’une actualisation d’écran ultérieure.
L’invalidation est un mécanisme efficace pour éliminer la répétition inutile d’opérations. Elle retarde le traitement des modifications apportées à un composant à une actualisation d’écran ultérieure. Par exemple, si vous souhaitez modifier la couleur du texte et la taille de la police, il est inutile de mettre à jour la couleur immédiatement après sa modification, puis de réaliser une autre mise à jour pour la taille de police. Il est plus efficace de modifier les deux propriétés et de rendre le texte une seule fois avec sa nouvelle couleur et sa nouvelle taille.
Les méthodes d’invalidation sont rarement appelées. En général, le fait de définir une propriété sur un composant provoque automatiquement l’appel de la méthode d’invalidation adaptée.
invalidateSize | () | méthode |
public function invalidateSize():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Marque un composant de sorte que sa méthode measure() soit appelée au cours d’une actualisation d’écran ultérieure.
L’invalidation est un mécanisme efficace pour éliminer la répétition inutile d’opérations. Elle retarde le traitement des modifications apportées à un composant à une actualisation d’écran ultérieure. Par exemple, si vous souhaitez modifier le texte et la taille de la police, il est inutile de mettre à jour le composant immédiatement après la modification du texte, puis de réaliser une autre mise à jour pour la taille de police. Il est ainsi plus efficace de modifier les deux propriétés et de rendre le composant une seule fois en utilisant le nouveau texte à sa nouvelle taille.
Les méthodes d’invalidation sont rarement appelées. En général, le fait de définir une propriété sur un composant provoque automatiquement l’appel de la méthode d’invalidation adaptée.
isOurFocus | () | méthode |
protected function isOurFocus(target:DisplayObject):Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Généralement remplacée par les composants contenant des objets UITextField, où l’objet UITextField obtient le focus.
Paramètres
target:DisplayObject — Objet UIComponent contenant un objet UITextField pouvant recevoir le focus.
|
Boolean — Renvoie true si l’objet UITextField a le focus.
|
keyDownHandler | () | méthode |
protected function keyDownHandler(event:KeyboardEvent):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Gestionnaire d’événement appelé pour un événement keyDown. Si vous remplacez cette méthode, assurez-vous d’appeler la version de classe de base.
Paramètres
event:KeyboardEvent — Objet événement.
|
keyUpHandler | () | méthode |
protected function keyUpHandler(event:KeyboardEvent):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Gestionnaire d’événement appelé pour un événement keyUp. Si vous remplacez cette méthode, assurez-vous d’appeler la version de classe de base.
Paramètres
event:KeyboardEvent — Objet événement.
|
localToContent | () | méthode |
public function localToContent(point:Point):Point| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Convertit un objet Point de coordonnées locales en coordonnées de contenu. Les coordonnées locales spécifient une position de pixel par rapport au coin supérieur gauche du composant. Les coordonnées de contenu spécifient une position de pixel par rapport au coin supérieur gauche du contenu du composant. Elles incluent l’ensemble de la zone de contenu du composant, y compris les régions actuellement découpées, accessibles uniquement par défilement du composant. Le système de coordonnées du contenu permet de définir et d’obtenir les positions des enfants d’un conteneur qui utilise le positionnement absolu.
Paramètres
point:Point — Objet Point qui spécifie les coordonnées x et y dans le système de coordonnées local en tant que propriétés.
|
Point — Pointer sur un objet Point dont les coordonnées sont relatives au système de coordonnées du contenu.
|
Eléments de l’API associés
matchesCSSState | () | méthode |
public function matchesCSSState(cssState:String):Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie true si cssState correspond à currentCSSState. Vous ne devez généralement pas appeler cette méthode directement. Elle est appelée par la méthode mx.styles.CSSCondition.matchesStyleClient().
Notez que les composants Spark utilisent leur état d’habillage comme pseudo état. Les composants Halo utilisent la propriété currentState.
Paramètres
cssState:String — Une valeur possible de CSSCondition.value. Elle représente l’état actuel de ce composant utilisé pour faire correspondre les pseudo-sélecteurs CSS.
|
Boolean — true si cssState correspond à currentCSSState. Par défaut, currentCSSState est identique à currentState. En l’absence d’état, elle renvoie la valeur null.
|
matchesCSSType | () | méthode |
public function matchesCSSType(cssType:String):Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Détermine si l’instance est identique au, ou est une sous-classe du, type donné. Vous ne devez généralement pas appeler cette méthode directement. Elle est appelée par la méthode mx.styles.CSSCondition.matchesStyleClient().
Paramètres
cssType:String — Objet CSSSelector.
|
Boolean — true si cssType est dans la hiérarchie des sélecteurs de types qualifiés.
|
measure | () | méthode |
protected function measure():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Calcule la taille par défaut du composant. Peut également calculer sa taille minimale par défaut. Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de la classe UIComponent.
Vous n’appelez pas cette méthode directement. Flex appelle la méthode measure() lorsque le composant est ajouté à un conteneur à l’aide de la méthode addChild() et lorsque la méthode invalidateSize() du composant est appelée.
Lorsque vous définissez une hauteur et une largeur spécifiques à un composant, Flex n’appelle pas la méthode measure(), même si vous appelez explicitement la méthode invalidateSize(). En d’autres termes, Flex appelle uniquement la méthode measure() si la propriété explicitWidth ou explicitHeight du composant a la valeur NaN.
Dans votre remplacement de cette méthode, vous devez définir les propriétés measuredWidth et measuredHeight pour définir la taille par défaut. Vous pouvez éventuellement définir les propriétés measuredMinWidth et measuredMinHeight pour définir la taille minimale par défaut.
La plupart des composants calculent ces valeurs en fonction du contenu qu’ils affichent et d’après les propriétés qui affectent l’affichage du contenu. Quelques composants disposent simplement de valeurs par défaut codées de manière irréversible.
L’objectif conceptuel de la propriété measure() est que le composant doit fournir sa propre taille naturelle ou intrinsèque comme valeur par défaut. Par conséquent, les propriétés measuredWidth et measuredHeight doivent être déterminées par des facteurs comme :
- La quantité de texte que le composant doit afficher.
- Les styles, par exemple
fontSize, de ce texte. - La taille d’une image JPEG affichée par le composant.
- Les tailles mesurées ou explicites des enfants du composant.
- Les bordures, marges et espacements.
Dans certains cas, aucune méthode intrinsèque ne permet de déterminer les valeurs par défaut. Par exemple, un simple composant GreenCircle peut simplement définir measuredWidth = 100 et measuredHeight = 100 dans sa méthode measure() pour donner une taille par défaut raisonnable. Dans d’autres cas, comme le contrôle TextArea, un calcul approprié (comme rechercher la hauteur et la largeur correctes qui permettront d’afficher tout le texte et respecteront les proportions d’un rectangle d’or) peut s’avérer trop long pour que cela en vaille la peine.
L’implémentation par défaut de la méthode measure() permet de définir les propriétés measuredWidth, measuredHeight, measuredMinWidth et measuredMinHeight sur0.
measureHTMLText | () | méthode |
public function measureHTMLText(htmlText:String):flash.text:TextLineMetrics| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Paramètres
htmlText:String — Chaîne spécifiant le texte HTML à mesurer.
|
flash.text:TextLineMetrics — Objet TextLineMetrics contenant les mesures du texte.
|
measureText | () | méthode |
public function measureText(text:String):flash.text:TextLineMetrics| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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. Ne fonctionne pas avec les composants Spark, car ils n’utilisent pas UITextField (ou UIFTETextField). Pour mesurer du texte dans les composants Spark, vous pouvez obtenir les mesures d’un composant spark.components.Label ou spark.components.RichText
Paramètres
text:String — Chaîne spécifiant le texte à mesurer.
|
flash.text:TextLineMetrics — Objet TextLineMetrics contenant les mesures du texte.
|
move | () | méthode |
public function move(x:Number, y:Number):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éplace le composant vers une position spécifiée dans son parent. L’appel de cette méthode est exactement identique à la définition des propriétés x et y du composant.
Si vous remplacez la méthode updateDisplayList() dans un composant personnalisé, appelez la méthode move() plutôt que de définir les propriétés x et y. La différence est que la méthode move() modifie l’emplacement du composant, puis distribue un événement move lors de l’appel de la méthode. En effet, le définition des propriétés x et y modifie l’emplacement du composant et distribue l’événement lors de la prochaine actualisation de l’écran.
Paramètres
x:Number — Position de gauche du composant dans son parent.
| |
y:Number — Position supérieure du composant dans son parent.
|
notifyStyleChangeInChildren | () | méthode |
public function notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Propage les modifications de style aux enfants. En règle générale, vous n’avez pas besoin d’appeler cette méthode.
Paramètres
styleProp:String — Chaîne spécifiant le nom de la propriété de style.
| |
recursive:Boolean — Notifier tous les enfants de ce composant de manière récursive.
|
owns | () | méthode |
public function owns(child:DisplayObject):Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie true si la chaîne de propriétés owner pointe de child à ce composant UIComponent.
Paramètres
child:DisplayObject — Composant UIComponent.
|
Boolean — true si l’enfant est le parent ou est administré par ce composant UIComponent.
|
parentChanged | () | méthode |
public function parentChanged(p:DisplayObjectContainer):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Appelé par Flex lorsqu’un composant UIComponent est ajouté à ou supprimé d’un parent. Les développeurs n’ont généralement pas besoin d’appeler cette méthode.
Paramètres
p:DisplayObjectContainer — Parent de cet objet IUIComponent.
|
prepareToPrint | () | méthode |
public function prepareToPrint(target:IFlexDisplayObject):Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Prépare un objet IFlexDisplayObject pour l’impression. Pour la classe UIComponent, la méthode n’effectue aucune action. Les conteneurs Flex remplacent la méthode pour préparer l’impression, par exemple en supprimant les barres de défilement sur la sortie imprimée.
Normalement, cette méthode n’est pas utilisée par les développeurs d’applications.
Paramètres
target:IFlexDisplayObject — Composant à imprimer. Il peut s’agir du composant actif ou de l’un de ses enfants.
|
Object — Objet contenant les propriétés du composant actif requises par la méthode finishPrint() pour le restaurer dans son état précédent.
|
Eléments de l’API associés
regenerateStyleCache | () | méthode |
public function regenerateStyleCache(recursive:Boolean):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
La structure Flex appelle cette méthode dans les situations suivantes :
- Lorsque vous ajoutez un composant UIComponent à un parent à l’aide de la méthode
addChild()ouaddChildAt(). - Lorsque vous modifiez la propriété
styleNamed’un composant UIComponent. - Lorsque vous définissez un style dans un sélecteur CSS à l’aide de la méthode
setStyle()de CSSStyleDeclaration.
La génération du cache de style est une opération lourde en calculs, il est donc déconseillé de modifier la propriété styleName ou de définir les styles de sélecteur sans y être contraint.
Cette méthode n’est pas appelée lorsque vous définissez un style d’instance en appelant la méthode setStyle()de l’objet UIComponent. La définition d’un style d’instance est une opération relativement rapide par rapport à la définition d’un style de sélecteur.
Il est inutile d’appeler ou de remplacer cette méthode.
Paramètres
recursive:Boolean — Régénère de façon récursive le cache du style de tous les enfants de ce composant.
|
registerEffects | () | méthode |
public function registerEffects(effects:Array):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Pour chaque événement d’effet, enregistre le gestionnaire EffectManager comme l’un des écouteurs d’événement. En règle générale, vous n’avez pas besoin d’appeler cette méthode.
Paramètres
effects:Array — Nom des événements d’effet.
|
removeStyleClient | () | méthode |
public function removeStyleClient(styleClient:IAdvancedStyleClient):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Supprime un client de style non visuel de cette instance de composant. Une fois que cette méthode a été appelée, le client de style n’héritera plus les changements de style à partir de cette instance de composant. De façon colatérale, cette méthode définit la propriété styleParent du paramètre styleClient sur null. Si le paramètre styleClient n’a pas été ajouté à cette instance de composant, aucune action n’est entreprise.
Paramètres
styleClient:IAdvancedStyleClient — L’interface IAdvancedStyleClient à supprimer de la liste de clients de style non visuels de ce composant.
|
Eléments de l’API associés
mx.styles.IAdvancedStyleClient
replayAutomatableEvent | () | méthode |
public function replayAutomatableEvent(event:Event):Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Réexécute l’événement spécifié. Un auteur de composant doit probablement appeler l’événement super.replayAutomatableEvent si le comportement de réexécution par défaut a été défini dans une super-classe.
Paramètres
event:Event — Evénement à réexécuter.
|
Boolean — true si une réexécution a réussi.
|
resolveAutomationIDPart | () | méthode |
public function resolveAutomationIDPart(criteria:Object):Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Résout un enfant en utilisant l’ID fourni. L’ID est un ensemble de propriétés tel que fourni par la méthode createAutomationIDPart().
Paramètres
criteria:Object — Ensemble de propriétés décrivant l’enfant. Le critère peut contenir des valeurs d’expressions régulières résultant dans l’association de plusieurs enfants.
|
Array — Tableau d’enfants qui correspondent au critère ou null si aucun enfant n’a pu être résolu.
|
resourcesChanged | () | méthode |
protected function resourcesChanged():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Cette méthode est appelée lors de la construction d’une classe UIComponent, puis chaque fois que ResourceManager envoie un événement "change" pour indiquer que les ressources localisées ont subi une modification.
Cet événement est distribué lorsque vous définissez la propriété localeChain de la classe ResourceManager, lorsqu’un module de ressource termine de se charger et lorsque vous appelez la méthode update() de la classe ResourceManager.
Les sous-classes doivent remplacer cette méthode et, après avoir appelé la méthode super.resourcesChanged(), effectuer les tâches appropriées en réponse aux nouvelles valeurs de ressources.
resumeBackgroundProcessing | () | méthode |
public static function resumeBackgroundProcessing():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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().
Reportez-vous à la description de la méthode suspendBackgroundProcessing() pour plus d’informations.
setActualSize | () | méthode |
public function setActualSize(w:Number, h:Number):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Dimensionne l’objet. Contrairement à la définition directe des propriétés width et height, l’appel de la méthode setActualSize() ne définit pas les propriétés explictWidth et explicitHeight. Un calcul de présentation ultérieur peut donc restaurer l’objet sur sa taille précédente. Cette méthode est principalement utilisée par les développeurs de composants qui implémentent la méthode updateDisplayList(), par des effets, et par le gestionnaire LayoutManager.
Paramètres
w:Number — Largeur de l’objet.
| |
h:Number — Hauteur de l’objet.
|
setConstraintValue | () | méthode |
public function setConstraintValue(constraintName:String, value:*):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éfinit une valeur de contrainte de présentation, ce qui revient à définir le style de contrainte pour ce composant.
Paramètres
constraintName:String — Nom de la contrainte de style, qui peut être l’un des suivants : left, right, top, bottom, verticalCenter, horizontalCenter, baseline.
| |
value:* — La valeur de la contrainte peut être spécifiée sous l’une ou l’autre forme. Elle peut être spécifiée en tant que chaîne numérique, par exemple « 10 », ou en tant que chaîne identifier:numeric. Pour la chaîne identifier:numeric, l’identifiant est l’id d’un élément ConstraintRow ou ConstraintColumn. Par exemple, la valeur « cc1:10 » indique une valeur de 10 pour la colonne ConstraintColumn portant l’id« cc1 ».
|
setCurrentState | () | méthode |
public function setCurrentState(stateName:String, playTransition: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éfinir l’état actuel.
Paramètres
stateName:String — Nom du nouvel état d’affichage.
| |
playTransition:Boolean (default = true)true, lire la transition appropriée lorsque l’état d’affichage change.
|
Eléments de l’API associés
setFocus | () | méthode |
public function setFocus():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éfinit le focus sur ce composant. Le composant peut à son tour transmettre le focus à un sous-composant.
Remarque : seules les commandes TextInput et TextArea affichent une surbrillance lorsque cette méthode définit le focus. Toutes les commandes s’affichent en surbrillance lorsque l’utilisateur les parcourt avec la touche de tabulation.
setLayoutBoundsPosition | () | méthode |
public function setLayoutBoundsPosition(x:Number, y:Number, postLayoutTransform:Boolean = true):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Définit les coordonnées utilisées par l’élément pour son affichage à l’écran.
Notez que les appels de la méthode setLayoutBoundSize() peuvent affecter la position de présentation. Vous devez donc appeler setLayoutBoundPosition() après avoir appelé setLayoutBoundSize().
Paramètres
x:Number — Coordonnée x du coin supérieur gauche du cadre de sélection.
| |
y:Number — Coordonnée y du coin supérieur gauche du cadre de sélection.
| |
postLayoutTransform:Boolean (default = true)postLayoutTransform est défini sur true, l’élément est placé de manière à faire correspondre le coin supérieur gauche de son cadre de sélection avec les coordonnées (x, y). Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille de présentation, de la position de présentation et de la matrice de transformation de présentation de l’élément.
|
setLayoutBoundsSize | () | méthode |
public function setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Définit la taille de la présentation de l’élément. Il s’agit de la taille que l’élément utilise pour son affichage à l’écran.
Si les paramètres width et/ou height ne sont pas spécifiés (NaN), Flex définit la taille de la présentation de l’élément sur la largeur et/ou la hauteur préférées.
Notez que les appels de la méthode setLayoutBoundSize() peuvent affecter la position de présentation. Vous devez donc appeler setLayoutBoundPosition() après avoir appelé setLayoutBoundSize().
Paramètres
width:Number — Largeur de la présentation de l’élément.
| |
height:Number — Hauteur de la présentation de l’élément.
| |
postLayoutTransform:Boolean (default = true)postLayoutTransform a la valeur true, les dimensions spécifiées sont celles du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille de présentation, de la position de présentation et de la matrice de transformation de présentation de l’élément.
|
setLayoutMatrix | () | méthode |
public function setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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.
La matrice est habituellement définie par les propriétés 2D du composant, telles que x, y, rotation, scaleX, scaleY, transformX et transformY. Certains composants peuvent comporter des propriétés de transformation supplémentaires appliquées au-dessus de la matrice de présentation pour déterminer la matrice calculée finale. Par exemple, UIComponent définit la propriété offsets.
Notez que la matrice de présentation Matrix est utilisée comme facteur dans les méthodes getPreferredSize(), getMinSize(), getMaxSize() et getLayoutSize() lorsqu’elle est calculée dans les coordonnées du parent, ainsi que dans getLayoutPosition() dans les coordonnées du parent et de l’enfant. Généralement, les présentations permettant de calculer la matrice de transformation appellent explicitement cette méthode et utilisent des tailles dans les coordonnées de l’enfant. Les présentations qui appellent cette méthode transmettent la valeur false à la méthode invalidateLayout afin qu’une transmission de présentation suivante ne soit pas déclenchée.
Paramètres
value:Matrix — Matrice.
| |
invalidateLayout:Boolean — La valeur true entraîne le conteneur parent à réorganiser ses enfants. En règle générale, vous transmettez la valeur true à la méthode invalidateLayout().
|
setLayoutMatrix3D | () | méthode |
public function setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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.
Cette matrice est habituellement définie par les propriétés de transformation du composant, comme x, y, z, rotationX, rotationY, rotationZ, scaleX, scaleY, scaleZ, transformX et transformY. Certains composants peuvent comporter des propriétés de transformation supplémentaires appliquées au-dessus de la matrice de présentation pour déterminer la matrice calculée finale. Par exemple, UIComponent définit la propriété offsets.
Notez que la matrice de présentation Matrix3D est utilisée comme facteur dans les méthodes getPreferredSize(), getMinSize(), getMaxSize() et getLayoutSize() lorsqu’elle est calculée dans les coordonnées du parent, ainsi que dans getLayoutPosition() dans les coordonnées du parent et de l’enfant. Généralement, les présentations permettant de calculer la matrice de transformation appellent explicitement cette méthode et utilisent des tailles dans les coordonnées de l’enfant. Les présentations qui appellent cette méthode transmettent la valeur false à la méthode invalidateLayout afin qu’une transmission de présentation suivante ne soit pas déclenchée.
Paramètres
value:Matrix3D — Matrice.
| |
invalidateLayout:Boolean — La valeur true entraîne le conteneur parent à réorganiser ses enfants. En règle générale, vous transmettez la valeur true à la méthode invalidateLayout().
|
setStretchXY | () | méthode |
protected function setStretchXY(stretchX:Number, stretchY:Number):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie un facteur d’étirement de transformation dans le sens horizontal et vertical. Le facteur d’étirement est appliqué à la matrice calculée avant toute autre transformation.
Paramètres
stretchX:Number — Composante horizontale du facteur d’étirement.
| |
stretchY:Number — Composante verticale du facteur d’étirement.
|
setStyle | () | méthode |
public function setStyle(styleProp:String, newValue:*):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éfinit une propriété de style pour cette instance de composant.
Ceci peut remplacer un style défini globalement.
L’appel de la méthode setStyle() peut entraîner une baisse des performances. Utilisez-la uniquement lorsque cela est nécessaire.
Paramètres
styleProp:String — Nom de la propriété de style.
| |
newValue:* — Nouvelle valeur du style.
|
setVisible | () | méthode |
public function setVisible(value:Boolean, noEvent:Boolean = false):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Appelé lorsque la propriété visible est modifiée. Définissez la propriété visible pour afficher ou masquer un composant au lieu d’appeler cette méthode directement.
Paramètres
value:Boolean — Nouvelle valeur de la propriété visible. Spécifiez true pour afficher le composant et false pour le masquer.
| |
noEvent:Boolean (default = false) true, ne distribuez pas d’événement. Si la valeur est false, distribuez un événement show lorsque le composant devient visible et un événement hide lorsqu’il devient invisible.
|
stateChanged | () | méthode |
protected function stateChanged(oldState:String, newState:String, recursive:Boolean):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Cette méthode est appelée lorsqu’un état change pour vérifier si des styles spécifiques à l’état s’appliquent à ce composant. S’il peut exister un pseudo-sélecteur CSS correspondant à l’état actif, le cache de style doit être régénéré pour cette instance, ainsi qu’éventuellement tous les enfants si le paramètre recursive est défini sur true.
Paramètres
oldState:String — Nom de l’état antérieur.
| |
newState:String — Nom du nouvel état.
| |
recursive:Boolean — Défini sur true pour exécuter une vérification récursive.
|
styleChanged | () | méthode |
public function styleChanged(styleProp:String):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étecte les modifications apportées aux propriétés de style. Lorsqu’une propriété de style est définie, Flex appelle la méthode styleChanged() et lui transmet le nom du style défini.
Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de la classe UIComponent. Lorsque vous créez un composant personnalisé, vous pouvez remplacer la méthode styleChanged() pour vérifier le nom de style qui lui a été transmis et traiter la modification en conséquence. Vous pouvez ainsi remplacer le comportement par défaut d’un style existant ou ajouter vos propres propriétés de style personnalisé.
Si vous traitez la propriété de style, le remplacement de la méthode styleChanged() doit appeler la méthode invalidateDisplayList() pour que Flex exécute la méthode updateDisplayList() du composant lors de la prochaine mise à jour de l’affichage.
Paramètres
styleProp:String — Nom de la propriété de style ou null si tous les styles de ce composant ont été modifiés.
|
stylesInitialized | () | méthode |
public function stylesInitialized():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Flex appelle la méthode stylesInitialized() lorsque les styles d’un composant sont d’abord initialisés.
Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de la classe UIComponent. Flex garantit que les styles du composant sont entièrement initialisés avant le premier appel des méthodes measure et updateDisplayList du composant. Cela suffit pour la plupart des composants. Si toutefois vous devez accéder rapidement aux valeurs de style, vous pouvez remplacer la fonction stylesInitialized() pour accéder aux propriétés de style dès leur première initialisation.
suspendBackgroundProcessing | () | méthode |
public static function suspendBackgroundProcessing():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Bloque le traitement en arrière-plan des méthodes placées en attente par callLater(), jusqu’à l’appel de la méthode resumeBackgroundProcessing().
Ces méthodes peuvent être utiles lorsque vous avez du code urgent qui doit s’exécuter sans interruption. Par exemple, lorsque vous définissez la propriété suspendBackgroundProcessing d’un effet sur true, la méthode suspendBackgroundProcessing() est automatiquement appelée lors du début de la lecture et la méthode resumeBackgroundProcessing est appelée lors de l’arrêt, afin d’assurer une animation fluide.
Puisque le gestionnaire LayoutManager utilise la méthode callLater(), les méthodes commitProperties(), measure() et updateDisplayList() ne sont pas appelées entre les appels des méthodes suspendBackgroundProcessing() et resumeBackgroundProcessing().
Il est possible pour une méthode externe et interne (c’est-à-dire une méthode appelée par la méthode externe) d’appeler les méthodes suspendBackgroundProcessing() et resumeBackgroundProcessing(), car ces méthodes incrémentent et décrémentent en réalité un compteur qui détermine si le traitement en arrière-plan est effectué.
transformAround | () | méthode |
public function 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| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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. Cette fonction affecte les valeurs de rotation, d’échelle et de translation fournies, puis met à jour les propriétés x/y/z, le cas échéant, pour conserver le centre de transformation fixe.
Paramètres
transformCenter:Vector3D — Point, dans les coordonnées du composant, à garder fixe par rapport à son parent.
| |
scale:Vector3D (default = null) | |
rotation:Vector3D (default = null) | |
translation:Vector3D (default = null) | |
postLayoutScale:Vector3D (default = null) | |
postLayoutRotation:Vector3D (default = null) | |
postLayoutTranslation:Vector3D (default = null) | |
invalidateLayout:Boolean (default = true)true, la taille et l’affichage du conteneur parent sont invalidés. Les présentations qui appellent cette méthode transmettent false afin qu’une transmission de présentation suivante ne soit pas déclenchée.
|
transformPointToParent | () | méthode |
public function transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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. Le résultat antérieur et postérieur à la présentation est défini sur les paramètres position et postLayoutPosition, s’ils n’ont pas la valeur null.
Paramètres
localPosition:Vector3D — Le point à transformer, spécifié dans les coordonnées locales de l’objet.
| |
position:Vector3D — Point Vector3D contenant le résultat antérieur à la présentation. Si null, le paramètre est ignoré.
| |
postLayoutPosition:Vector3D — Point Vector3D contenant le résultat postérieur à la présentation. Si null, le paramètre est ignoré.
|
updateDisplayList | () | méthode |
protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Trace l’objet et/ou dimensionne et place ses enfants. Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de la classe UIComponent.
Vous n’appelez pas cette méthode directement. Flex appelle la méthode updateDisplayList() lorsque le composant est ajouté à un conteneur par le biais de la méthode addChild() et lorsque la méthode invalidateDisplayList() du composant est appelée.
Si le composant n’a pas d’enfant, cette méthode permet de réaliser un tracé par programmation en utilisant les méthodes sur l’objet Graphics du composant, par exemple graphics.drawRect().
Si le composant a au moins un enfant, cette méthode permet d’appeler les méthodes move() et setActualSize() sur ces enfants.
Les composants peuvent réaliser un tracé par programmation, même s’ils ont des enfants. Pour ce faire, utilisez les propriétés unscaledWidth et unscaledHeight du composant comme ses limites.
Il est indispensable d’utiliser unscaledWidth et unscaledHeight à la place des propriétés width et height.
Paramètres
unscaledWidth:Number — Indique la largeur du composant, en pixels, des coordonnées du composant, quelle que soit la valeur de la propriété scaleX du composant.
| |
unscaledHeight:Number — Indique la hauteur du composant, en pixels, des coordonnées du composant, quelle que soit la valeur de la propriété scaleY du composant.
|
validateDisplayList | () | méthode |
public function validateDisplayList():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Valide la position et la taille des enfants, et trace d’autres effets visuels. Si la méthode LayoutManager.invalidateDisplayList() est appelée avec cette interface ILayoutManagerClient, la méthode validateDisplayList() est alors appelée lorsqu’il est temps de mettre à jour la liste d’affichage.
validateNow | () | méthode |
public function validateNow():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Valide et actualise les propriétés et la présentation de cet objet, puis le retrace si nécessaire. Les propriétés de traitement qui nécessitent de nombreux calculs ne sont généralement pas traitées avant la fin de l’exécution du script. Par exemple, la définition de la propriété width est retardée, car elle peut nécessiter un nouveau calcul des largeurs des enfants ou du parent de l’objet. Le fait de retarder le traitement l’empêche de se répéter lorsque le code de l’application définit la propriété width à plusieurs reprises. Cette méthode permet de remplacer manuellement ce comportement.
validateProperties | () | méthode |
public function validateProperties():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Utilisé par la logique de présentation pour valider les propriétés d’un composant par l’appel de la méthode commitProperties(). En général, les sous-classes doivent remplacer la méthode commitProperties() et non cette méthode.
validateSize | () | méthode |
public function validateSize(recursive:Boolean = false):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Paramètres
recursive:Boolean (default = false)true, cette méthode est appelée sur les enfants des objets.
|
validationResultHandler | () | méthode |
public function validationResultHandler(event:ValidationResultEvent):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Traite à la fois les événements valid et invalid d’une classe Validator assignée à ce composant.
Vous gérez en général les événements valid et invalid distribués par une classe Validator en assignant des écouteurs d’événements aux classes Validator. Si vous voulez gérer directement les événements de validation dans le composant en cours de validation, vous pouvez remplacer cette méthode pour gérer les événements valid et invalid. La méthode super.validationResultHandler(event) est généralement appelée dans le remplacement.
Paramètres
event:ValidationResultEvent — Objet d’événement pour la validation.
|
Eléments de l’API associés
verticalGradientMatrix | () | méthode |
public function verticalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Pour des raisons de performances, la matrice est stockée dans une variable statique réutilisée par tous les appels des méthodes horizontalGradientMatrix() et verticalGradientMatrix(). Par conséquent, la matrice obtenue doit être transmise à la méthode drawRoundRect() avant un nouvel appel de la méthode horizontalGradientMatrix() ou verticalGradientMatrix().
Paramètres
x:Number — Coordonnée de gauche du dégradé, en pixels.
| |
y:Number — Coordonnée supérieure du dégradé, en pixels.
| |
width:Number — Largeur du gradient, en pixels.
| |
height:Number — Hauteur du gradient, en pixels.
|
Matrix — Matrice pour le dégradé horizontal.
|
add | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.ADD| 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 composant est ajouté à un conteneur en tant que contenu enfant à l’aide de la méthode addChild(), addChildAt(), addElement() ou addElementAt(). Si le composant est ajouté au conteneur en tant qu’élément enfant ne comportant pas de contenu à l’aide de la méthode rawChildren.addChild() ou rawChildren.addChildAt(), l’événement n’est pas distribué.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constanteFlexEvent.ADD définit la valeur de la propriété type de l’objet d’événement d’un événement add.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
creationComplete | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.CREATION_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 composant a terminé sa construction, son traitement de propriétés, sa mesure, sa présentation et son tracé.
A ce stade, en fonction de sa propriété visible, le composant n’est pas visible même s’il a été tracé.
FlexEvent.CREATION_COMPLETE définit la valeur de la propriété type de l’objet d’événement d’un événement creationComplete.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
currentStateChange | Evénement |
mx.events.StateChangeEventpropriété StateChangeEvent.type =
mx.events.StateChangeEvent.CURRENT_STATE_CHANGE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué après la modification de l’état d’affichage.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constante StateChangeEvent.CURRENT_STATE_CHANGE définit la valeur de la propriététype de l’événement distribué lorsque l’état d’affichage change. La valeur de cette constante est « currentStateChange ».
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
newState | Nom de l’état d’affichage adopté. |
oldState | Nom de l’état d’affichage quitté. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
type | StateChangeEvent.CURRENT_STATE_CHANGE |
currentStateChanging | Evénement |
mx.events.StateChangeEventpropriété StateChangeEvent.type =
mx.events.StateChangeEvent.CURRENT_STATE_CHANGING| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué après la modification de la propriété currentState, mais avant celle de l’état d’affichage.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constante StateChangeEvent.CURRENT_STATE_CHANGING définit la valeur de la propriététype de l’événement distribué lorsque l’état d’affichage est sur le point de changer. La valeur de cette constante est « currentStateChanging ».
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
newState | Nom de l’état d’affichage en cours d’adoption. |
oldState | Nom de l’état d’affichage en cours d’abandon. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
type | StateChangeEvent.CURRENT_STATE_CHANGING |
dragComplete | Evénement |
mx.events.DragEventpropriété DragEvent.type =
mx.events.DragEvent.DRAG_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é 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.
Cet événement permet d’effectuer un nettoyage final éventuel pour l’opération de glisser-déposer. Par exemple, si vous faites glisser un élément de commande List d’une liste à une autre, vous pouvez supprimer l’élément de commande List de la source s’il est devenu superflu.
Si vous appelez la méthode Event.preventDefault() dans le gestionnaire d’événement pour l’événement dragComplete pour une commande Tree lors du déplacement de données d’une commande d’arborescence à une autre, la méthode empêche le dépôt.
DragEvent.DRAG_COMPLETE définit la valeur de la propriété type de l’objet d’événement d’un événement dragComplete.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
action | Action à l’origine de l’événement : DragManager.COPY, DragManager.LINK, DragManager.MOVE ou DragManager.NONE. |
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
dragInitiator | Composant qui a initié l’opération de glissement. |
dragSource | Objet DragSource contenant les données qui font l’objet du glissement. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
dragDrop | Evénement |
mx.events.DragEventpropriété DragEvent.type =
mx.events.DragEvent.DRAG_DROP| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué par la cible de dépôt lorsque l’utilisateur libère le bouton de la souris au-dessus de la cible.
Ce gestionnaire d’événement permet d’ajouter les données du déplacement à la cible de dépôt.
Si vous appelez la méthode Event.preventDefault() dans le gestionnaire d’événement pour l’événement dragDrop pour une commande Tree lors du déplacement de données d’une commande d’arborescence à une autre, la méthode empêche le dépôt.
DragEvent.DRAG_DROP définit la valeur de la propriété type de l’objet d’événement d’un événement dragDrop.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
action | Action à l’origine de l’événement : DragManager.COPY, DragManager.LINK, DragManager.MOVE ou DragManager.NONE. |
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
dragInitiator | Composant qui a initié l’opération de glissement. |
dragSource | Objet DragSource contenant les données qui font l’objet du glissement. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
dragEnter | Evénement |
mx.events.DragEventpropriété DragEvent.type =
mx.events.DragEvent.DRAG_ENTER| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué par un composant lorsque l’utilisateur passe le pointeur de la souris sur le composant pendant une opération de déplacement. Dans une application s’exécutant dans Flash Player, l’événement est distribué plusieurs fois lorsque vous déplacez la souris sur un composant. Dans une application s’exécutant dans AIR, l’événement est distribué une seule fois.
Afin d’assurer la validité de la cible de dépôt, vous devez définir un gestionnaire pour cet événement. Dans le gestionnaire, vous pouvez modifier l’aspect de la cible de dépôt pour indiquer visuellement à l’utilisateur que le composant peut accepter le déplacement. Par exemple, vous pouvez tracer une bordure autour de la cible de dépôt, ou donner le focus à la cible de dépôt.
Si vous souhaitez accepter le déplacement, appelez la méthode DragManager.acceptDragDrop(). Si vous n’appelez pas acceptDragDrop(), vous n’obtiendrez pas les autres événements de glissement.
Dans Flash Player, la valeur de la propriété action est toujours DragManager.MOVE, même si vous effectuez une copie. L’événement dragEnter se produit en effet avant que le contrôle ne reconnaisse que la touche Ctrl est enfoncée pour signaler une copie. La propriété action de l’objet d’événement pour l’événement dragOver contient une valeur qui indique le type d’opération de déplacement. Vous pouvez modifier le type d’action de déplacement en appelant la méthode DragManager.showFeedback().
Dans AIR, la valeur par défaut de la propriété action est DragManager.COPY.
En raison de la structuration des données d’une arborescence, les commandes Tree effectuent les glisser-déposer différemment des autres commandes basées sur une liste. Pour la commande Tree, le gestionnaire d’événement pour l’événement dragDrop n’effectue une action que lorsque vous déplacez ou copiez des données dans la même arborescence, ou copiez des données vers une autre arborescence. Si vous faites glisser des données d’une commande Tree et les déposez dans une autre afin de déplacer les données, le gestionnaire d’événement pour l’événement dragComplete effectue le travail d’ajout des données à l’arborescence de destination à la place du gestionnaire d’événement pour l’événement dragDrop et supprime également les données de l’arborescence source. Cette opération est nécessaire car pour réapparenter les données déplacées, Flex doit d’abord les supprimer du contrôle Tree source.
DragEvent.DRAG_ENTER définit la valeur de la propriété type de l’objet d’événement d’un événement dragEnter.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
action | Action à l’origine de l’événement, c’est-à-dire DragManager.MOVE. |
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
dragInitiator | Composant qui a initié l’opération de glissement. |
dragSource | Objet DragSource contenant les données qui font l’objet du glissement. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
Eléments de l’API associés
dragExit | Evénement |
mx.events.DragEventpropriété DragEvent.type =
mx.events.DragEvent.DRAG_EXIT| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Cet événement permet de rendre à la cible de dépôt son aspect normal s’il a été modifié dans le cadre de la gestion des événements dragEnter ou dragOver.
DragEvent.DRAG_EXIT définit la valeur de la propriété type de l’objet d’événement d’un événement dragExit.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
action | Action à l’origine de l’événement : DragManager.COPY, DragManager.LINK, DragManager.MOVE ou DragManager.NONE. |
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
dragInitiator | Composant qui a initié l’opération de glissement. |
dragSource | Objet DragSource contenant les données qui font l’objet du glissement. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
dragOver | Evénement |
mx.events.DragEventpropriété DragEvent.type =
mx.events.DragEvent.DRAG_OVER| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué par un composant lorsque l’utilisateur déplace la souris en survolant le composant pendant une opération de glissement. Dans Flash Player, l’événement est distribué lorsque vous faites glisser un élément sur une cible de dépôt valide. Dans AIR, l’événement est distribué lorsque vous faites glisser un élément sur un composant quelconque, même si le composant n’est pas une cible de dépôt valide.
Dans le gestionnaire, vous pouvez modifier l’aspect de la cible de dépôt pour indiquer visuellement à l’utilisateur que le composant peut accepter le déplacement. Par exemple, vous pouvez tracer une bordure autour de la cible de dépôt, ou donner le focus à la cible de dépôt.
Cet événement doit être géré pour effectuer une logique supplémentaire avant d’autoriser le dépôt. Il peut s’agir par exemple du dépôt de données à différents emplacements de la cible de dépôt, de la lecture de la saisie clavier pour déterminer si l’action de glisser-déposer est un déplacement ou une copie des données déplacées ou de l’émission de différents signaux visuels en fonction du type d’action de glisser-déposer.
Vous pouvez également modifier le type d’action de déplacement en modifiant la méthode DragManager.showFeedback(). La valeur par défaut de la propriété action est DragManager.MOVE.
DragEvent.DRAG_OVER définit la valeur de la propriété type de l’objet d’événement d’un événement dragOver.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
action | Action à l’origine de l’événement : DragManager.COPY, DragManager.LINK, DragManager.MOVE ou DragManager.NONE. |
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
dragInitiator | Composant qui a initié l’opération de glissement. |
dragSource | Objet DragSource contenant les données qui font l’objet du glissement. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
Eléments de l’API associés
dragStart | Evénement |
mx.events.DragEventpropriété DragEvent.type =
mx.events.DragEvent.DRAG_START| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué par l’initiateur du déplacement lors du démarrage d’une opération de déplacement. Cet événement est utilisé en interne par les commandes basées sur une liste. Il n’est pas géré lors de l’implémentation d’une opération de glisser-déposer. Si vous souhaitez contrôler le début d’une opération de glisser-déposer, utilisez l’événement mouseDown ou mouseMove.
type de l’objet d’événement d’un événement dragStart.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
action | Action à l’origine de l’événement : DragManager.COPY, DragManager.LINK, DragManager.MOVE ou DragManager.NONE. |
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
dragInitiator | Composant qui a initié l’opération de glissement. |
dragSource | Objet DragSource contenant les données qui font l’objet du glissement. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
effectEnd | Evénement |
mx.events.EffectEventpropriété EffectEvent.type =
mx.events.EffectEvent.EFFECT_END| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué après la fin d’un effet.
L’effet exécute le dernier ensemble de changements visuels avant le déclenchement de cet événement, mais ces modifications ne sont pas rendues sur l’écran. Ainsi, vous devez éventuellement utiliser la méthode callLater() pour retarder les autres modifications souhaitées en attendant le rendu des modifications à l’écran.
EffectEvent.EFFECT_END définit la valeur de la propriété type de l’objet d’événement d’un événement effectEnd.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
effectInstance | Objet d’instance d’effet de l’événement. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
effectStart | Evénement |
mx.events.EffectEventpropriété EffectEvent.type =
mx.events.EffectEvent.EFFECT_START| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué juste avant le démarrage d’un effet.
L’effet ne commence la modification des visuels qu’après le déclenchement de cet événement.
La constanteEffectEvent.EFFECT_START définit la valeur de la propriété type de l’objet d’événement d’un événement effectStart.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
effectInstance | Objet d’instance d’effet de l’événement. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
effectStop | Evénement |
mx.events.EffectEventpropriété EffectEvent.type =
mx.events.EffectEvent.EFFECT_STOP| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
L’effet distribue ensuite l’événement EFFECT_END lorsque l’effet se termine. L’utilité de l’événement EFFECT_STOP consiste à indiquer aux écouteurs que l’effet a été terminé de façon prématurée, au lieu terminer naturellement ou en raison d’un appel de la fonction end().
EffectEvent.EFFECT_STOP définit la valeur de la propriété type de l’objet d’événement d’un événement effectStop.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
effectInstance | Objet d’instance d’effet de l’événement. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
enterState | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.ENTER_STATE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué après l’entrée du composant dans un état d’affichage.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constanteFlexEvent.ENTER_STATE définit la valeur de la propriété type de l’objet d’événement d’un événement enterState.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
exitState | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.EXIT_STATE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué juste avant que le composant quitte un état d’affichage.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constanteFlexEvent.EXIT_STATE définit la valeur de la propriété type de l’objet d’événement d’un événement exitState.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
hide | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.HIDE| 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 passe de l’état visible à l’état invisible.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constanteFlexEvent.HIDE définit la valeur de la propriété type de l’objet d’événement d’un événement hide.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
initialize | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.INITIALIZE| 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 composant a terminé sa construction et dispose de toutes les propriétés d’initialisation définies.
Après la phase d’initialisation les propriétés sont traitées, le composant est mesuré, présenté et tracé, puis l’événement creationComplete est distribué.
FlexEvent.INITIALIZE définit la valeur de la propriété type de l’objet d’événement d’un événement initialize.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
invalid | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.INVALID| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué si un composant est contrôlé par un validateur et que la validation a échoué.
La constanteFlexEvent.INVALID définit la valeur de la propriété type de l’objet d’événement d’un événement invalid.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
mouseDownOutside | Evénement |
mx.events.FlexMouseEventpropriété FlexMouseEvent.type =
mx.events.FlexMouseEvent.MOUSE_DOWN_OUTSIDE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué par un composant ouvert à l’aide du gestionnaire PopUpManager lorsque l’utilisateur clique en dehors du composant.
La constanteFlexMouseEvent.MOUSE_DOWN_OUTSIDE définit la valeur de la propriété type de l’objet d’événement d’un événement mouseDownOutside.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | Indique si la touche Alt est enfoncée (true) ou non (false). |
bubbles | false |
buttonDown | Indique si le bouton principal de la souris est enfoncé (true) ou non (false). |
cancelable | false |
ctrlKey | Indique si la touche Control est enfoncée (true) ou non (false). |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, la valeur de la propriété currentTarget est myButton. Dans le cas des événements PopUpManager, l’objet est la fenêtre contextuelle. |
delta | Indique le nombre de lignes devant défiler chaque fois que l’utilisateur fait tourner la molette de sa souris d’un cran. Pour les événements PopUpManager, cette valeur est 0. |
localX | Position horizontale à laquelle l’événement est survenu. Dans le cas des événements PopUpManager, la valeur dépend du contrôle de la fenêtre contextuelle. |
localY | Position verticale à laquelle l’événement est survenu. Dans le cas des événements PopUpManager, la valeur dépend du contrôle de la fenêtre contextuelle. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. Dans le cas des événements PopUpManager, l’objet est le conteneur survolé par le pointeur de la souris. |
shiftKey | Indique si la touche Maj est enfoncée (true) ou non (false). |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. Dans le cas des événements PopUpManager, l’objet est la fenêtre contextuelle. |
mouseWheelOutside | Evénement |
mx.events.FlexMouseEventpropriété FlexMouseEvent.type =
mx.events.FlexMouseEvent.MOUSE_WHEEL_OUTSIDE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
La constanteFlexMouseEvent.MOUSE_WHEEL_OUTSIDE définit la valeur de la propriété type de l’objet d’événement d’un événement mouseWheelOutside.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
altKey | Indique si la touche Alt est enfoncée (true) ou non (false). |
bubbles | false |
buttonDown | Indique si le bouton principal de la souris est enfoncé (true) ou non (false). |
cancelable | false |
ctrlKey | Indique si la touche Control est enfoncée (true) ou non (false). |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, la valeur de la propriété currentTarget est myButton. Dans le cas des événements PopUpManager, l’objet est la fenêtre contextuelle. |
delta | Indique le nombre de lignes devant défiler chaque fois que l’utilisateur fait tourner la molette de sa souris d’un cran. Pour les événements PopUpManager, cette valeur est 0. |
localX | Position horizontale à laquelle l’événement est survenu. Dans le cas des événements PopUpManager, la valeur dépend du contrôle de la fenêtre contextuelle. |
localY | Position verticale à laquelle l’événement est survenu. Dans le cas des événements PopUpManager, la valeur dépend du contrôle de la fenêtre contextuelle. |
relatedObject | Référence à un objet de la liste d’affichage qui est associé à l’événement. Dans le cas des événements PopUpManager, l’objet est le conteneur survolé par le pointeur de la souris. |
shiftKey | Indique si la touche Maj est enfoncée (true) ou non (false). |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. Dans le cas des événements PopUpManager, l’objet est la fenêtre contextuelle. |
move | Evénement |
mx.events.MoveEventpropriété MoveEvent.type =
mx.events.MoveEvent.MOVE| 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 l’objet a été déplacé.
Vous pouvez déplacer le composant en définissant la propriété x ou y, en appelant la méthode move() ou en définissant l’une des propriétés suivantes sur le composant ou sur d’autres composants, obligeant ainsi le gestionnaire LayoutManager à modifier les propriétés x ou y du composant :
minWidthminHeightmaxWidthmaxHeightexplicitWidthexplicitHeight
Lorsque vous appelez la méthode move(), l’événement move est distribué avant le renvoi de la méthode. Dans tous les autres cas, l’événement move n’est distribué qu’après la modification de la propriété.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constanteMoveEvent.MOVE définit la valeur de la propriété type de l’objet d’événement d’un événement move.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
oldX | Coordonnée x précédente de l’objet, en pixels. |
oldY | Coordonnée y précédente de l’objet, en pixels. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
preinitialize | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.PREINITIALIZE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué au début de la séquence d’initialisation du composant. Le composant est dans un état très brut lorsque cet événement est distribué. De nombreux composants, tels que la commande Button, créent des composants enfant internes pour implémenter leur fonctionnalité. Par exemple, la commande Button crée un composant UITextField interne pour représenter son texte de libellé. Lorsque Flex distribue l’événement preinitialize, les enfants d’un composant n’ont pas encore été créés (y compris les enfants internes).
FlexEvent.PREINITIALIZE définit la valeur de la propriété type de l’objet d’événement d’un événement preinitialize.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
remove | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.REMOVE| 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 composant est supprimé d’un conteneur en tant que contenu enfant en utilisant la méthode removeChild(), removeChildAt(), removeElement() ou removeElementAt(). Si le composant est supprimé du conteneur en tant qu’enfant ne comportant pas de contenu à l’aide de la méthode rawChildren.removeChild() ou rawChildren.removeChildAt(), l’événement n’est pas distribué.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constanteFlexEvent.REMOVE définit la valeur de la propriété type de l’objet d’événement d’un événement remove.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
resize | Evénement |
mx.events.ResizeEventpropriété ResizeEvent.type =
mx.events.ResizeEvent.RESIZE| 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 composant est redimensionné.
Vous pouvez redimensionner le composant en définissant la propriété width ou height, en appelant la méthode setActualSize() ou en définissant l’une des propriétés suivantes sur le composant ou sur d’autres composants, obligeant ainsi le gestionnaire LayoutManager à modifier les propriétés width ou height du composant :
minWidthminHeightmaxWidthmaxHeightexplicitWidthexplicitHeight
L’événement resize n’est pas distribué tant que la propriété n’a pas été modifiée.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constanteResizeEvent.RESIZE définit la valeur de la propriété type de l’objet d’événement d’un événement resize.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
oldHeight | Hauteur précédente de l’objet, en pixels. |
oldWidth | Largeur précédente de l’objet, en pixels. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
show | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.SHOW| 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 passe de l’état invisible à l’état visible.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constanteFlexEvent.SHOW définit la valeur de la propriété type de l’objet d’événement d’un événement show.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
stateChangeComplete | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.STATE_CHANGE_COMPLETE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
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. L’événement est distribué immédiatement en l’absence de transition en cours entre les états. Si le composant bascule dans un autre état alors que la transition est en cours, cet événement sera distribué après que le composant aura terminé la transition vers ce nouvel état.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constanteFlexEvent.STATE_CHANGE_COMPLETE définit la valeur de la propriété type de l’objet d’événement d’un événement stateChangeComplete.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
stateChangeInterrupted | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.STATE_CHANGE_INTERRUPTED| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Distribué lorsqu’un composant interrompt une transition à son état actuel afin de basculer dans un nouvel état.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constanteFlexEvent.STATE_CHANGE_INTERRUPTED définit la valeur de la propriété type de l’objet d’événement d’un événement stateChangeInterrupted.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
toolTipCreate | Evénement |
mx.events.ToolTipEventpropriété ToolTipEvent.type =
mx.events.ToolTipEvent.TOOL_TIP_CREATE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué par le composant lorsqu’il est nécessaire de créer un composant ToolTip.
Si vous créez votre propre objet IToolTip et placez une référence correspondante dans la propriété toolTipde l’objet d’événement transmis au gestionnaire toolTipCreate, le gestionnaire ToolTipManager affiche l’élément ToolTip personnalisé. Dans le cas contraire, le gestionnaire ToolTipManager crée une instance de ToolTipManager.toolTipClass à afficher.
La séquence des événements ToolTip est toolTipStart, toolTipCreate, toolTipShow, toolTipShown, toolTipHide et toolTipEnd.
ToolTipEvent.TOOL_TIP_CREATE définit la valeur de la propriété type de l’objet d’événement d’un événement toolTipCreate.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
tooltip | Objet ToolTip auquel s’applique cet événement. |
toolTipEnd | Evénement |
mx.events.ToolTipEventpropriété ToolTipEvent.type =
mx.events.ToolTipEvent.TOOL_TIP_END| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué par le composant lorsque son objet ToolTip a été masqué et va être rapidement supprimé.
Si vous spécifiez un effet à l’aide de la propriété ToolTipManager.hideEffect, cet événement est distribué après la fin de la lecture de l’effet.
La séquence des événements ToolTip est toolTipStart, toolTipCreate, toolTipShow, toolTipShown, toolTipHide et toolTipEnd.
ToolTipEvent.TOOL_TIP_END définit la valeur de la propriété type de l’objet d’événement d’un événement toolTipEnd.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
tooltip | Objet ToolTip auquel s’applique cet événement. |
toolTipHide | Evénement |
mx.events.ToolTipEventpropriété ToolTipEvent.type =
mx.events.ToolTipEvent.TOOL_TIP_HIDE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué par le composant lorsque son composant ToolTip est sur le point d’être masqué.
Si vous spécifiez un effet à l’aide de la propriété ToolTipManager.hideEffect, cet événement est distribué avant le début de la lecture de l’effet.
La séquence des événements ToolTip est toolTipStart, toolTipCreate, toolTipShow, toolTipShown, toolTipHide et toolTipEnd.
ToolTipEvent.TOOL_TIP_HIDE définit la valeur de la propriété type de l’objet d’événement d’un événement toolTipHide.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
tooltip | Objet ToolTip auquel s’applique cet événement. |
toolTipShow | Evénement |
mx.events.ToolTipEventpropriété ToolTipEvent.type =
mx.events.ToolTipEvent.TOOL_TIP_SHOW| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué par le composant lorsque son composant ToolTip est sur le point d’être affiché.
Si vous spécifiez un effet à l’aide de la propriété ToolTipManager.showEffect, cet événement est distribué avant le début de la lecture de l’effet. Cet événement permet de modifier le composant ToolTip avant qu’il ne s’affiche.
La séquence des événements ToolTip est toolTipStart, toolTipCreate, toolTipShow, toolTipShown, toolTipHide et toolTipEnd.
ToolTipEvent.TOOL_TIP_SHOW définit la valeur de la propriété type de l’objet d’événement d’un événement toolTipShow.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
tooltip | Objet ToolTip auquel s’applique cet événement. |
toolTipShown | Evénement |
mx.events.ToolTipEventpropriété ToolTipEvent.type =
mx.events.ToolTipEvent.TOOL_TIP_SHOWN| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué par le composant lorsque son composant ToolTip a été affiché.
Si vous spécifiez un effet à l’aide de la propriété ToolTipManager.showEffect, cet événement est distribué après la fin de la lecture de l’effet.
La séquence des événements ToolTip est toolTipStart, toolTipCreate, toolTipShow, toolTipShown, toolTipHide et toolTipEnd.
ToolTipEvent.TOOL_TIP_SHOWN définit la valeur de la propriété type de l’objet d’événement d’un événement toolTipShown.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
tooltip | Objet ToolTip auquel s’applique cet événement. |
toolTipStart | Evénement |
mx.events.ToolTipEventpropriété ToolTipEvent.type =
mx.events.ToolTipEvent.TOOL_TIP_START| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué par un composant dont la propriété toolTip est définie, dès que l’utilisateur passe le pointeur de la souris sur le composant.
La séquence des événements ToolTip est toolTipStart, toolTipCreate, toolTipShow, toolTipShown, toolTipHide et toolTipEnd.
ToolTipEvent.TOOL_TIP_START définit la valeur de la propriété type de l’objet d’événement d’un événement toolTipStart.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
tooltip | Objet ToolTip auquel s’applique cet événement. |
touchInteractionEnd | Evénement |
mx.events.TouchInteractionEventpropriété TouchInteractionEvent.type =
mx.events.TouchInteractionEvent.TOUCH_INTERACTION_END| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Evénement non annulable, distribué par un composant lorsque celui-ci a terminé de réagir à un geste d’interaction tactile de l’utilisateur.
L’événement est un événement de propagation distribué sur la classe DisplayObject indiquant que l’interaction tactile a commencé (là où l’événement mouseDown / touchBegin s’est produit).
Les composants répondant aux interactions tactiles doivent écouter les événements d’interaction tactile pour se coordonner avec les autres composants en ce qui concerne le type d’interaction tactile que l’utilisateur a l’intention d’effectuer et le composant chargé de répondre à cette interaction tactile.
Un composant Scroller distribuera un événement touchInteractionEnd pour signaler aux autres composants qu’il a fini de répondre à l’interaction tactile de l’utilisateur.
La constanteTouchInteractionEvent.TOUCH_INTERACTION_END définit la valeur de la propriété type de l’objet d’événement d’un événement touchInteractionEnd.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
reason | La raison de l’événement d’interaction tactile. Voir mx.events.TouchInteractionReason. |
relatedObject | L’objet associé à cet événement d’interaction tactile. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
touchInteractionStart | Evénement |
mx.events.TouchInteractionEventpropriété TouchInteractionEvent.type =
mx.events.TouchInteractionEvent.TOUCH_INTERACTION_START| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Evénement non annulable, distribué par un composant lorsque celui-ci commence à réagir à un geste d’interaction tactile de l’utilisateur.
L’événement est un événement de propagation distribué sur la classe DisplayObject indiquant que l’interaction tactile a commencé (là où l’événement mouseDown / touchBegin s’est produit).
Les composants répondant aux interactions tactiles doivent écouter les événements d’interaction tactile pour se coordonner avec les autres composants en ce qui concerne le type d’interaction tactile que l’utilisateur a l’intention d’effectuer et le composant chargé de répondre à cette interaction tactile.
Un composant Scroller distribuera un événement touchInteractionStart pour signaler aux autres composants susceptibles de réagir à la même interaction tactile de l’utilisateur qu’il prend le contrôle de cette interaction tactile. Lorsqu’ils voient cet événement, les autres composantes doivent cesser de réagir à l’interaction tactile, supprimer toutes les éventuelles indications visuelles qu’ils réagissent à l’interaction tactile et effectuer un autre nettoyage.
La constanteTouchInteractionEvent.TOUCH_INTERACTION_START définit la valeur de la propriété type de l’objet d’événement d’un événement touchInteractionStart.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
reason | La raison de l’événement d’interaction tactile. Voir mx.events.TouchInteractionReason. |
relatedObject | L’objet associé à cet événement d’interaction tactile. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
touchInteractionStarting | Evénement |
mx.events.TouchInteractionEventpropriété TouchInteractionEvent.type =
mx.events.TouchInteractionEvent.TOUCH_INTERACTION_STARTING| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Evénement annulable, distribué par un composant tentant de réagir à un geste d’interaction tactile de l’utilisateur.
L’événement est un événement de propagation distribué sur la classe DisplayObject indiquant que l’interaction tactile a commencé (là où l’événement mouseDown / touchBegin s’est produit).
Les composants répondant aux interactions tactiles doivent écouter les événements d’interaction tactile pour se coordonner avec les autres composants en ce qui concerne le type d’interaction tactile que l’utilisateur a l’intention d’effectuer et le composant chargé de répondre à cette interaction tactile.
Un composant Scroller distribuera un événement touchInteractionStarting pour signaler aux autres composants susceptibles de réagir à la même interaction tactile de l’utilisateur qu’il souhaite prendre le contrôle de cette interaction tactile. Ceci est une opportunité pour les autres composants d’annuler l’action de Scroller et de conserver le contrôle de cette interaction tactile.
La constanteTouchInteractionEvent.TOUCH_INTERACTION_STARTING définit la valeur de la propriété type de l’objet d’événement d’un événement touchInteractionStarting.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | true |
cancelable | true |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
reason | La raison de l’événement d’interaction tactile. Voir mx.events.TouchInteractionReason. |
relatedObject | L’objet associé à cet événement d’interaction tactile. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
updateComplete | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.UPDATE_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 les méthodes commitProperties(), measure() et updateDisplayList() d’un objet ont été appelées (si nécessaire).
Il s’agit de la dernière possibilité de modifier le composant avant son affichage. Toutes les propriétés ont été validées et le composant a été mesuré et présenté.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
La constanteFlexEvent.UPDATE_COMPLETE définit la valeur de la propriété type de l’objet d’événement d’un événement updateComplete.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
valid | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.VALID| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Distribué si un composant est contrôlé par un validateur et que la validation a réussi.
La constanteFlexEvent.VALID définit la valeur de la propriété type de l’objet d’événement d’un événement valid.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
valueCommit | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.VALUE_COMMIT| 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 les valeurs sont modifiées soit par programmation, soit par interaction de l’utilisateur.
Puisqu’une modification de programmation déclenche cet événement, assurez-vous que les gestionnaires d’événements valueCommit ne modifient pas une valeur qui entraîne un autre événement valueCommit. Par exemple, ne modifiez pas la propriété dataProvider d’une commande dans un gestionnaire d’événement valueCommit.
FlexEvent.VALUE_COMMIT définit la valeur de la propriété type de l’objet d’événement d’un événement valueCommit.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
DEFAULT_MAX_HEIGHT | Constante |
public static const DEFAULT_MAX_HEIGHT:Number = 10000| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Valeur par défaut pour la propriété maxHeight.
La valeur par défaut est 10000.
DEFAULT_MAX_WIDTH | Constante |
public static const DEFAULT_MAX_WIDTH:Number = 10000| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Valeur par défaut pour la propriété maxWidth.
La valeur par défaut est 10000.
DEFAULT_MEASURED_HEIGHT | Constante |
public static const DEFAULT_MEASURED_HEIGHT:Number = 22| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Valeur par défaut pour la propriété measuredHeight. La plupart des composants calculent une valeur measuredHeight, mais certains composants basés sur un flux doivent choisir un nombre qui semble adapté.
La valeur par défaut est 22.
DEFAULT_MEASURED_MIN_HEIGHT | Constante |
public static const DEFAULT_MEASURED_MIN_HEIGHT:Number = 22| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Valeur par défaut pour la propriété measuredMinHeight. La plupart des composants calculent une valeur measuredMinHeight, mais certains composants basés sur un flux doivent choisir un nombre qui semble adapté.
La valeur par défaut est 22.
DEFAULT_MEASURED_MIN_WIDTH | Constante |
public static const DEFAULT_MEASURED_MIN_WIDTH:Number = 40| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Valeur par défaut pour la propriété measuredMinWidth. La plupart des composants calculent une valeur measuredMinWidth, mais certains composants basés sur un flux doivent choisir un nombre qui semble adapté.
La valeur par défaut est 40.
DEFAULT_MEASURED_WIDTH | Constante |
public static const DEFAULT_MEASURED_WIDTH:Number = 160| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Valeur par défaut pour la propriété measuredWidth. La plupart des composants calculent une valeur measuredWidth, mais certains composants basés sur un flux doivent choisir un nombre qui semble adapté.
La valeur par défaut est 160.
Tue Jun 12 2018, 09:30 AM Z