| Package | mx.controls |
| Classe | public class MenuBar |
| Héritage | MenuBar  UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Implémente | IFocusManagerComponent |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
La barre de menus de niveau supérieur du contrôle MenuBar est généralement toujours visible. Elle n’a pas pour but d’être utilisée comme un menu contextuel. Chaque sous-menu s’affiche lorsque l’utilisateur le sélectionne avec la souris ou le clavier. Les sous-menus ouverts disparaissent lorsqu’un élément de menu est sélectionné ou si l’utilisateur fait disparaître le menu en cliquant en dehors.
Pour plus d’informations et pour obtenir un exemple sur les attributs que vous pouvez utiliser dans le fournisseur de données pour le contrôle MenuBar, voir le contrôle Menu.
Le contrôle MenuBar possède les caractéristiques de taille par défaut suivantes :
| Caractéristique | Description |
|---|---|
| Taille par défaut | La largeur est déterminée à partir du texte du menu, sa valeur minimale étant de 27 pixels. La valeur par défaut pour la hauteur est de 22 pixels. |
Afficher la syntaxe MXML
Masquer la syntaxe MXML
The <mx:MenuBar> tag inherits all of the tag attributes of its superclass, and
adds the following tag attributes:
<mx:MenuBar
Properties
dataDescriptor="mx.controls.treeClasses.DefaultDataDescriptor"
dataProvider="undefined"
iconField="icon"
labelField="label"
labelFunction="undefined"
menuBarItemRenderer="mx.controls.menuClasses.MenuBarItem"
menuBarItems="[]"
menus="[]"
selectedIndex="-1"
showRoot="true"
Styles
backgroundSkin="mx.skins.halo.MenuBarBackgroundSkin"
borderColor="0xAAB3B3"
color="0x0B333C"
cornerRadius="0"
disabledColor="0xAAB3B3"
fillAlphas="[0.6,0.4]"
fillColors="[0xFFFFFF, 0xCCCCCC]"
focusAlpha="0.5"
focusRoundedCorners="tl tr bl br"
fontAntiAliasType="advanced|normal"
fontFamily="Verdana"
fontGridFitType="pixel|none|subpixel"
fontSharpness="0"
fontSize="10"
fontStyle="normal|italic"
fontThickness="0"
fontWeight="normal|bold"
highlightAlphas="[0.3,0.0]"
itemDownSkin="mx.skins.halo.ActivatorSkin"
itemOverSkin="mx.skins.halo.ActivatorSkin"
itemUpSkin="mx.skins.halo.ActivatorSkin"
leading="2"
menuStyleName="No default"
rollOverColor="0xB2E1FF"
selectionColor="0x7FCEFF"
textAlign="left"
textDecoration="none"
textIndent="0"
Events
itemClick="No default"
itemRollOut="No default"
itemRollOver="No default"
menuHide="No default"
menuShow="No default"
/>
Propriété MXML par défautdataProvider
Eléments de l’API associés
mx.controls.Menu
mx.controls.PopUpMenuButton
mx.controls.menuClasses.IMenuBarItemRenderer
mx.controls.menuClasses.MenuBarItem
mx.controls.menuClasses.IMenuDataDescriptor
mx.controls.treeClasses.DefaultDataDescriptor
mx.controls.PopUpMenuButton
mx.controls.menuClasses.IMenuBarItemRenderer
mx.controls.menuClasses.MenuBarItem
mx.controls.menuClasses.IMenuDataDescriptor
mx.controls.treeClasses.DefaultDataDescriptor
Propriétés publiques
| Propriété | Défini par | ||
|---|---|---|---|
 | accessibilityDescription : String
Accesseur pratique pour la propriété description de l’objet accessibilityProperties de ce composant UIComponent. | UIComponent | |
| accessibilityEnabled : Boolean
Accesseur pratique pour la propriété silent de l’objet accessibilityProperties de ce composant UIComponent. | UIComponent | |
| accessibilityImplementation : AccessibilityImplementation
Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject. | InteractiveObject | |
| accessibilityName : String
Accesseur pratique pour la propriété name de l’objet accessibilityProperties de ce composant UIComponent. | UIComponent | |
| accessibilityProperties : AccessibilityProperties
Options d’accessibilité actuelles de l’objet d’affichage. | DisplayObject | |
| accessibilityShortcut : String
Accesseur pratique pour la propriété shortcut de l’objet accessibilityProperties de ce composant UIComponent. | UIComponent | |
| activeEffects : Array [lecture seule]
Liste des effets en cours de lecture sur le composant, sous forme d’un tableau d’instances EffectInstance. | UIComponent | |
| alpha : Number
Indique la valeur de transparence alpha de l’objet spécifié. | DisplayObject | |
| 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 | |
| dataDescriptor : IMenuDataDescriptor
Objet qui accède aux objets du fournisseur de données et les manipule. | MenuBar | ||
| dataProvider : Object
Hiérarchie des objets qui s’affichent en tant qu’éléments MenuBar et menus. | MenuBar | ||
| 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 | |
| hasRoot : Boolean [lecture seule]
Indicateur précisant que le fournisseur de données actuel comporte un nœud racine. Par exemple, un nœud supérieur unique dans une structure hiérarchique. | MenuBar | ||
| 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 | |
| iconField : String
Nom du champ dans le fournisseur de données qui détermine l’icône à afficher pour chaque élément de menu. | MenuBar | ||
| 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 | |
| labelField : String
Nom du champ dans le fournisseur de données qui détermine le texte à afficher pour chaque élément de menu. | MenuBar | ||
| labelFunction : Function
Fonction qui détermine le texte à afficher pour chaque élément de menu. | MenuBar | ||
| 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 | |
| menuBarItemRenderer : IFactory
Rendu d’élément utilisé par le contrôle MenuBar pour la barre de menus de niveau supérieur du contrôle MenuBar. | MenuBar | ||
| menuBarItems : Array
Tableau contenant les objets MenuBarItem qui rendent chaque élément de la barre de menus de niveau supérieur d’un contrôle MenuBar. | MenuBar | ||
| menus : Array
Tableau contenant les objets Menu correspondant aux sous-menus contextuels de ce contrôle MenuBar. | MenuBar | ||
| 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 | |
| selectedIndex : int
Index du contrôle MenuBar de l’objet Menu actuellement ouvert ou du dernier objet Menu ouvert si aucun n’est actuellement ouvert. | MenuBar | ||
| showInAutomationHierarchy : Boolean
Indicateur qui détermine si un objet d’automatisation s’affiche dans la hiérarchie d’automatisation. | UIComponent | |
| showRoot : Boolean
Indicateur booléen spécifiant si le nœud racine du fournisseur de données doit être affiché. | MenuBar | ||
| 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és protégées
| 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 | |
| menuBarItemStyleFilters : Object [lecture seule]
Jeu de styles à transmettre de MenuBar aux éléments barre de menus. | MenuBar | ||
| 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éthodes publiques
| Méthode | Défini par | ||
|---|---|---|---|
MenuBar()
Constructeur. | MenuBar | ||
|
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 une référence à l’objet Menu à l’index de l’élément MenuBar spécifié. La valeur 0 correspond à l’objet Menu contenu à l’index de l’élément MenuBar le plus à gauche. | MenuBar | ||
|
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 | |
Renvoie la classe d’une icône, le cas échant, d’un élément de données, en fonction de la propriété iconField. | MenuBar | ||
Renvoie la chaîne que la fonctionnalité de rendu doit afficher pour l’objet de données spécifié, en fonction des propriétés labelField et labelFunction. | MenuBar | ||
|
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éthodes protégées
| 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 | |
[override]
Calcule la largeur et la hauteur préférées du contrôle MenuBar en fonction des largeurs par défaut des éléments MenuBar. | MenuBar | ||
|
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 | |
Actualise l’habillage d’arrière-plan du contrôle MenuBar. | MenuBar | ||
|
Trace l’objet et/ou dimensionne et place ses enfants. | UIComponent | |
Evénements
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| Distribué lorsque le composant est ajouté à un conteneur en tant que contenu enfant à l’aide de la méthode addChild(), addChildAt(), addElement() ou addElementAt(). | UIComponent | ||
| Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage. | DisplayObject | ||
| Envoyé lorsqu’un objet d’affichage est ajouté dans la liste d’affichage de la scène, directement ou par l’intermédiaire d’une arborescence secondaire qui contient l’objet d’affichage. | DisplayObject | ||
| Distribué lorsque la sélection change après une interaction de l’utilisateur. | MenuBar | |||
| 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 | ||
| Diffusé lorsque l’utilisateur sélectionne un élément dans un sous-menu contextuel. | MenuBar | |||
| Distribué lorsque le pointeur de la souris cesse de survoler un élément de menu. | MenuBar | |||
| Distribué lorsque le pointeur de la souris survole un élément de menu. | MenuBar | |||
| 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é à la fermeture d’un sous-menu contextuel. | MenuBar | |||
| Distribué lorsqu’un sous-menu contextuel s’ouvre ou lorsque l’utilisateur sélectionne un élément d’une barre de menus sans menu déroulant. | MenuBar | |||
| 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 | ||
Styles
Les styles sont soit communs soit associés à un thème spécifique. Si le style est commun, il peut être utilisé avec n’importe quel thème. Si un style est associé à un thème spécifique, il ne peut être utilisé que si votre application utilise ce thème.
Styles communs
| Style | Description | Défini par | ||
|---|---|---|---|---|
backgroundSkin | 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 d’arrière-plan du contrôle MenuBar. La classe d’habillage par défaut est basée sur le thème. Par exemple, avec le thème Halo, la classe d’habillage par défaut est | MenuBar | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance verticale en pixels du bord supérieur de la zone de contenu à la position de la ligne de base de la commande. | UIComponent | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance verticale, en pixels, entre le bord inférieur du composant et le bord inférieur de la zone de contenu de son conteneur parent. | UIComponent | ||
color | 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 texte dans le composant, y compris l’étiquette du composant. La valeur par défaut du thème Halo est 0x0B333C. La valeur par défaut du thème Spark est 0x000000.
| MenuBar | ||
direction | Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 4 Versions du moteur d’exécution: Flash10, AIR 1.5 Direction du texte affiché par le composant. Les valeurs autorisées sont FTE et TLF utilisent cette valeur dans leur algorithme de mise en forme de texte bidirectionnel, lequel mappe l’ordre des caractères Unicode sur ordre des glyphes. Remarque : ce style s’applique uniquement lorsqu’un composant MX composant spécifie UIFTETextField comme classe La "ltr". | MenuBar | ||
disabledColor | 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 texte dans le composant s’il est désactivé. La valeur par défaut est 0xAAB3B3. | MenuBar | ||
| Type: uint Format: Color Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Couleur de surbrillance du composant lorsque la validation échoue. | UIComponent | ||
focusAlpha | Type: Number 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 Indique la valeur de transparence Alpha de l’habillage du focus. La valeur par défaut du thème Halo est 0.4. La valeur par défaut du thème est Spark 0.55.
| MenuBar | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Mode de fusion utilisé par le rectangle de focus. | UIComponent | ||
focusRoundedCorners | 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 Indique quels coins du rectangle de focus doivent être arrondis. Cette valeur est une chaîne séparée par des espaces pouvant contenir toute combinaison de "tl", "tr", "bl" et "br". Par exemple, pour indiquer que les coins du côté droit doivent être arrondis, mais que les coins du côté gauche doivent être carrés, utilisez "tr br". La propriété de style cornerRadius indique le rayon des coins arrondis. La valeur par défaut dépend de la classe du composant. Si elle n’est pas remplacée pour la classe, la valeur par défaut est "tl tr bl br".
| MenuBar | ||
| Type: Class Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Habillage utilisé pour tracer le rectangle de focus. | UIComponent | ||
| Type: Number Format: Length Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Epaisseur du contour du rectangle de focus, en pixels. | UIComponent | ||
fontAntiAliasType | Type: String 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 Définit la propriété antiAliasType des objets TextField internes. Les valeurs possibles sont "normal" (flash.text.AntiAliasType.NORMAL) et "advanced" (flash.text.AntiAliasType.ADVANCED).
La valeur par défaut est Ce style n’a aucun effet pour les polices système. Ce style s’applique à l’intégralité du texte d’un sous-contrôle TextField : vous ne pouvez pas l’appliquer à certains caractères seulement et non à d’autres. La valeur par défaut est "advanced".Eléments de l’API associés | MenuBar | ||
fontFamily | Type: String 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 Nom de la police à utiliser. A la différence d’une implémentation CSS complète, les listes de valeurs séparées par des virgules ne sont pas prises en charge. Vous pouvez utiliser n’importe quel nom de famille de polices. Si vous spécifiez un nom de police générique, il est converti dans la police de périphérique appropriée. La police par défaut du thème Halo est "Verdana". La police par défaut du thème Spark est "Arial".
| MenuBar | ||
fontGridFitType | Type: String 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 Définit la propriété gridFitType des objets TextField internes représentant le texte dans les contrôles Flex. Les valeurs possibles sont "none" (flash.text.GridFitType.NONE), "pixel" (flash.text.GridFitType.PIXEL) et "subpixel" (flash.text.GridFitType.SUBPIXEL).
Cette propriété s’applique uniquement lorsque vous utilisez une police imbriquée et lorsque la propriété Ce style n’a aucun effet pour les polices système. Ce style s’applique à l’ensemble du texte d’un sous-contrôle TextField. Vous ne pouvez pas l’appliquer uniquement à certains caractères et pas à d’autres. La valeur par défaut est "pixel".Eléments de l’API associés | MenuBar | ||
fontSharpness | Type: Number 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 Définit la propriété sharpness des objets TextField internes représentant le texte dans les contrôles Flex. Cette propriété spécifie la netteté du contour des glyphes. Les nombres possibles vont de -400 à 400.
Cette propriété s’applique uniquement lorsque vous utilisez une police imbriquée et lorsque la propriété Ce style n’a aucun effet pour les polices système. Ce style s’applique à l’ensemble du texte d’un sous-contrôle TextField. Vous ne pouvez pas l’appliquer uniquement à certains caractères et pas à d’autres. La valeur par défaut est 0.Eléments de l’API associés | MenuBar | ||
fontSize | Type: Number Format: Length 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 Hauteur du texte, en pixels. Dans le thème Halo, la valeur par défaut est 10 pour tous les contrôles sauf ColorPicker. Pour le contrôle ColorPicker avec thème Halo, la valeur par défaut est 11. Dans le thème Spark, la valeur par défaut est 12 pour tous les contrôles sauf ColorPicker. Pour le contrôle ColorPicker avec thème Spark, la valeur par défaut est 11. | MenuBar | ||
fontStyle | Type: String 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 Détermine si le texte doit être en italique. Les valeurs reconnues sont "normal" et "italic".
La valeur par défaut est "normal". | MenuBar | ||
fontThickness | Type: Number 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 Définit la propriété thickness des sous-contrôles TextField internes qui représentent le texte des contrôles Flex. Cette propriété spécifie l’épaisseur du contour des glyphes. Les nombres possibles vont de -200 à 200.
Cette propriété s’applique uniquement lorsque vous utilisez une police imbriquée et lorsque la propriété Ce style n’a aucun effet sur les polices système. Ce style s’applique à l’ensemble du texte d’un sous-contrôle TextField. Vous ne pouvez pas l’appliquer uniquement à certains caractères et pas à d’autres. La valeur par défaut est 0.Eléments de l’API associés | MenuBar | ||
fontWeight | Type: String 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 Détermine si le texte doit être en gras. Les valeurs reconnues sont normal et bold. La valeur par défaut du contrôle Button est bold. La valeur par défaut de tous les autres contrôles est normal.
| MenuBar | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance horizontale, en pixels, entre le centre de la zone de contenu et celui du composant. | UIComponent | ||
| Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 4.5 Versions du moteur d’exécution: Flash10, AIR 2.5 Le principal mode d’interaction pour ce composant. | UIComponent | ||
itemDownSkin | 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 lorsqu’un élément MenuBar est sélectionné. La classe d’habillage par défaut est basée sur le thème. Par exemple, avec le thème Halo, la classe d’habillage par défaut est | MenuBar | ||
itemOverSkin | 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 lorsque le focus est placé sur un élément MenuBar. La classe d’habillage par défaut est basée sur le thème. Par exemple, avec le thème Halo, la classe d’habillage par défaut est | MenuBar | ||
itemSkin | 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 par défaut d’un élément MenuBar. La classe d’habillage par défaut est basée sur le thème. Par exemple, avec le thème Halo, la classe d’habillage par défaut est | MenuBar | ||
itemUpSkin | 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 lorsqu’un élément MenuBar n’est pas sélectionné. La classe d’habillage par défaut est basée sur le thème. Par exemple, avec le thème Halo, la classe d’habillage par défaut est | MenuBar | ||
kerning | Type: Boolean 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 Valeur booléenne indiquant si le crénage est activé ( true) ou désactivé (false). Le crénage ajuste le pas entre certaines paires de caractères pour améliorer la lisibilité et ne doit être employé que si nécessaire, dans les titres en grande police, par exemple. Le crénage est supporté uniquement pour les polices incorporées. Certaines polices, telles que Verdana, et les polices à espacement fixe, telles que Courier New, ne prennent pas en charge le crénage.
La valeur par défaut est false. | MenuBar | ||
| Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 4.1 Versions du moteur d’exécution: Flash10, AIR 1.5 Spécifie la direction de mise en forme souhaitée d’un composant. | UIComponent | ||
leading | Type: Number Format: Length 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 Espace vertical supplémentaire entre les lignes de texte. La valeur par défaut est 2. La valeur par défaut du contrôle ComboBox est 0. | MenuBar | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance horizontale, en pixels, du bord gauche du composant au bord gauche de la zone de contenu de son conteneur parent. | UIComponent | ||
letterSpacing | Type: Number 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 Nombre de pixels supplémentaires devant apparaître entre chaque caractère. Une valeur positive augmente l’espacement des caractères par rapport à l’espacement normal, alors qu’une valeur négative le réduit. La valeur par défaut est 0. | MenuBar | ||
locale | Type: String Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 4 Versions du moteur d’exécution: Flash10, AIR 1.5 Paramètres régionaux du texte affiché par ce composant. FTE et TLF utilisent ces paramètres régionaux pour mapper des caractères Unicode à des glyphes de police et rechercher des polices de rechange. Remarque : ce style s’applique uniquement lorsqu’un composant MX spécifie UIFTETextField comme classe "en". | MenuBar | ||
menuStyleName | 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 Nom de la déclaration CSSStyleDeclaration qui spécifie les styles des contrôles Menu affichés par ce contrôle MenuBar. Par défaut, le contrôle Menu utilise les styles héritables du contrôle MenuBar. Vous pouvez utiliser ce sélecteur de classe pour définir les valeurs de toutes les propriétés de style de la classe Menu, notamment undefined. | MenuBar | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance horizontale, en pixels, du bord droit du composant au bord droit de la zone de contenu de son conteneur parent. | UIComponent | ||
rollOverColor | 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 d’arrière-plan de l’élément de menu lorsque l’utilisateur le survole avec la souris. La valeur par défaut du thème Halo est 0xB2E1FF. La valeur par défaut du thème Spark est 0xCEDBEF.
| MenuBar | ||
selectionColor | 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 d’arrière-plan de l’élément de menu lorsqu’il est sélectionné. La valeur par défaut du thème Halo est 0x7FCEFF. La valeur par défaut du thème Spark est 0xA8C6EE.
| MenuBar | ||
| Type: Boolean Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 4.5 Versions du moteur d’exécution: Flash10, AIR 1.5 Montrer l’erreur bordure ou enveloppe lorsque ce composant n’est pas valide. | UIComponent | ||
| Type: Boolean Héritage CSS: Oui Version du langage: ActionScript 3.0 Version du produit: Flex 4.5 Versions du moteur d’exécution: Flash10, AIR 1.5 Afficher l’erreur-bulle lorsque ce composant n’est pas valide et que l’utilisateur pointe le curseur dessus | UIComponent | ||
textAlign | Type: String 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 Alignement du texte au sein d’un conteneur. Les valeurs possibles sont "left", "right" ou "center".
La valeur par défaut de la plupart des composants est | MenuBar | ||
textDecoration | Type: String 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 Détermine si le texte est souligné. Les valeurs possibles sont "none" et "underline".
La valeur par défaut est "none". | MenuBar | ||
textFieldClass | Type: Class Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 4 Versions du moteur d’exécution: Flash10, AIR 1.5 Classe implémentant l’instance IUITextField qui permet à ce composant de rendre le texte. Elle peut être définie sur la classe mx.core.UITextField (pour utiliser la classe TextField classique intégrée à Flash Player) ou la classe mx.core.UIFTETextField (pour utiliser Text Layout Framework, qui permet d’améliorer le rendu du texte et d’obtenir notamment une mise en forme bidirectionnelle). La valeur par défaut est mx.core.UITextField. | MenuBar | ||
textIndent | Type: Number Format: Length 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 Décalage de la première ligne de texte par rapport au côté gauche du conteneur (en pixels). La valeur par défaut est 0. | MenuBar | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance verticale, en pixels, entre le bord supérieur du composant et le bord supérieur de la zone de contenu de son conteneur parent. | UIComponent | ||
| Type: String Héritage CSS: Non Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Distance verticale, en pixels, du centre de la zone de contenu du composant au centre du composant. | UIComponent | ||
Styles du thème Spark
| Style | Description | Défini par | ||
|---|---|---|---|---|
| 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 | ||
cornerRadius | Type: Number Format: Length Héritage CSS: Non Thème : halo, spark Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Rayon des angles des composants. Les composants suivants prennent ce style en charge : Alert, Button, ComboBox, LinkButton, MenuBar, NumericStepper, Panel, ScrollBar, Tab, TitleWindow et tous les composants qui prennent en charge une propriété borderStyle définie sur "solid". La valeur par défaut dépend de la classe du composant ; si elle n’est pas remplacée pour la classe, la valeur par défaut est 0 pour le thème Halo et 2 pour le thème Spark.
| MenuBar | ||
symbolColor | 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 d’un symbole de composant. Les exemples incluent la coche d’un composant CheckBox ou la flèche d’un bouton ScrollBar. La valeur par défaut est 0x000000. | MenuBar | ||
Styles du thème Halo
| Style | Description | Défini par | ||
|---|---|---|---|---|
borderColor | Type: uint Format: Color Héritage CSS: Non 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 la bordure. Les contrôles suivants prennent ce style en charge : Button, CheckBox, ComboBox, MenuBar, NumericStepper, ProgressBar, RadioButton, ScrollBar, Slider et tous les composants qui prennent en charge le style borderStyle. La valeur par défaut dépend de la classe du composant. Si elle n’est pas remplacée par la classe, la valeur par défaut est 0xB7BABC.
| MenuBar | ||
cornerRadius | Type: Number Format: Length Héritage CSS: Non Thème : halo, spark Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Rayon des angles des composants. Les composants suivants prennent ce style en charge : Alert, Button, ComboBox, LinkButton, MenuBar, NumericStepper, Panel, ScrollBar, Tab, TitleWindow et tous les composants qui prennent en charge une propriété borderStyle définie sur "solid". La valeur par défaut dépend de la classe du composant ; si elle n’est pas remplacée pour la classe, la valeur par défaut est 0 pour le thème Halo et 2 pour le thème Spark.
| MenuBar | ||
fillAlphas | Type: Array Héritage CSS: Non Thème : halo Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Transparences Alpha utilisées pour le remplissage d’arrière-plan des contrôles. Utilisez la valeur [1, 1] pour rendre l’arrière-plan des contrôles opaque. La valeur par défaut est [ 0.6, 0.4 ]. | MenuBar | ||
fillColors | Type: Array Format: Color Héritage CSS: Non Thème : halo Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Couleurs utilisées pour teindre l’arrière-plan du contrôle. Transmettez la même couleur pour les deux valeurs d’un contrôle à l’aspect plat. La valeur par défaut est [ 0xFFFFFF, 0xCCCCCC ]. | MenuBar | ||
highlightAlphas | Type: Array Héritage CSS: Non Thème : halo Version du langage: ActionScript 3.0 Version du produit: Flex 3 Versions du moteur d’exécution: Flash9, AIR 1.1 Transparences Alpha utilisées pour le remplissage de surbrillance des contrôles. La première valeur indique la transparence du haut de la surbrillance et la seconde valeur indique la transparence du bas de la surbrillance. La surbrillance couvre la moitié supérieure de l’habillage. La valeur par défaut est [ 0.3, 0.0 ]. | MenuBar | ||
| 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. | UIComponent | ||
Effets
Constantes publiques
Détails de la propriété
dataDescriptor | propriété |
dataDescriptor:IMenuDataDescriptor| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Objet qui accède aux objets du fournisseur de données et les manipule. Le contrôle MenuBar délègue au descripteur de données pour obtenir des informations sur ses données. Ces données sont ensuite utilisées pour analyser et déplacer la source de données. Le descripteur de données défini pour le contrôle MenuBar est utilisé pour tous les menus enfant et les sous-menus.
Lorsque vous spécifiez cette propriété comme attribut dans MXML, vous devez utiliser une référence au descripteur de données et pas le nom de chaîne du descripteur. Utilisez le format suivant pour définir la propriété :
<mx:MenuBar id="menubar" dataDescriptor="{new MyCustomDataDescriptor()}"/>
Vous pouvez également spécifier la propriété dans MXML comme sous-balise imbriquée, comme le montre l’exemple suivant :
<mx:MenuBar>
<mx:dataDescriptor>
<myCustomDataDescriptor>
</mx:dataDescriptor>
...
Valeur par défaut d’une instance interne de la classe DefaultDataDescriptor.
Implémentation
public function get dataDescriptor():IMenuDataDescriptor public function set dataDescriptor(value:IMenuDataDescriptor):voiddataProvider | propriété |
dataProvider:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Hiérarchie des objets qui s’affichent en tant qu’éléments MenuBar et menus. Les enfants de niveau supérieur deviennent tous des éléments MenuBar et leurs enfants deviennent les éléments des menus et sous-menus. Le contrôle MenuBar gère l’objet de données source de la manière suivante :
- Une chaîne contenant du texte XML valide est convertie en objet XML.
- Un objet XMLNode est converti en objet XML.
- Un objet XMLList est converti en objet XMLListCollection.
- N’importe quel objet qui implémente l’interface ICollectionView est distribué à un objet ICollectionView.
- Un objet Array est converti en objet ArrayCollection.
- Tout autre type d’objet est enroulé dans un objet Array (l’objet étant sa seule entrée).
La valeur par défaut est "undefined".
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 collectionChange .
Implémentation
public function get dataProvider():Object public function set dataProvider(value:Object):voidhasRoot | propriété |
hasRoot: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 |
Indicateur précisant que le fournisseur de données actuel comporte un nœud racine. Par exemple, un nœud supérieur unique dans une structure hiérarchique. XML et Object sont des exemples de types dotés de nœuds racine, tandis que List and Array n’en ont pas.
Implémentation
public function get hasRoot():BooleaniconField | propriété |
iconField: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 du champ dans le fournisseur de données qui détermine l’icône à afficher pour chaque élément de menu. Par défaut, le contrôle MenuBar n’essaie pas d’afficher les icônes avec le texte dans un élément de menu. En spécifiant un champ d’icône, vous pouvez définir un graphique qui est créé et affiché en tant qu’icône dans un élément de menu.
Le contrôle MenuItemRenderer recherche dans le fournisseur de données une propriété dont le nom est défini par la propriété iconField. Si la valeur de la propriété est une classe, cette dernière est instanciée et sera probablement une instance d’un objet IFlexDisplayObject. Si la valeur de la propriété est une chaîne, elle regarde si une classe de ce nom existe dans l’application. Si elle n’en trouve pas, elle recherchera également une propriété de ce nom dans le document et s’attendra à ce que cette propriété s’associe à une classe.
La valeur par défaut est "icon".
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 iconFieldChanged .
Implémentation
public function get iconField():String public function set iconField(value:String):voidlabelField | propriété |
labelField: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 du champ dans le fournisseur de données qui détermine le texte à afficher pour chaque élément de menu. Si le fournisseur de données est un tableau de chaînes, Flex utilise chaque valeur de chaîne comme libellé. Si le fournisseur de données est un objet E4X XML, vous devez définir explicitement cette propriété. Utilisez par exemple
La valeur par défaut est "label".
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 labelFieldChanged .
Implémentation
public function get labelField():String public function set labelField(value:String):voidlabelFunction | propriété |
public var labelFunction:Function| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Fonction qui détermine le texte à afficher pour chaque élément de menu. La fonction libellé doit trouver le ou les champs appropriés dans le fournisseur de données et renvoyer une chaîne à afficher. Si vous omettez cette propriété, Flex utilise le contenu du champ ou de l’attribut spécifié par la propriété labelField. Si vous spécifiez cette propriété, Flex ignore toute valeur de la propriété labelField. La propriété labelFunction permet de gérer la mise en forme et la localisation.
La fonction libellé doit prendre un seul argument, qui est l’élément dans le fournisseur de données et renvoyer une chaîne.
myLabelFunction(item:Object):String
La valeur par défaut est "undefined".
menuBarItemRenderer | propriété |
menuBarItemRenderer:IFactory| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Rendu d’élément utilisé par le contrôle MenuBar pour la barre de menus de niveau supérieur du contrôle MenuBar.
Vous pouvez définir un rendu d’élément pour les sous-menus contextuels du contrôle MenuBar. Comme chaque sous-menu contextuel est une instance du contrôle Menu, utilisez la classe MenuItemRenderer pour définir un rendu d’élément pour les sous-menus contextuels. Pour définir le rendu d’élément d’un sous-menu contextuel, accédez à l’objet Menu à l’aide la propriété menus.
La valeur par défaut est "mx.controls.menuClasses.MenuBarItem".
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 menuBarItemRendererChanged .
Implémentation
public function get menuBarItemRenderer():IFactory public function set menuBarItemRenderer(value:IFactory):voidEléments de l’API associés
menuBarItems | propriété |
public var menuBarItems: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 objets MenuBarItem qui rendent chaque élément de la barre de menus de niveau supérieur d’un contrôle MenuBar. Par défaut, cette propriété contient des instances de la classe MenuBarItem. Il est déconseillé d’ajouter directement les éléments au tableau menuBarItems. Pour ajouter des éléments de la barre de menus, ajoutez-les directement au fournisseur de données du contrôle MenuBar.
La valeur par défaut est [ ].
Eléments de l’API associés
menuBarItemStyleFilters | propriété |
menuBarItemStyleFilters: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 |
Jeu de styles à transmettre de MenuBar aux éléments barre de menus.
Implémentation
protected function get menuBarItemStyleFilters():ObjectEléments de l’API associés
menus | propriété |
public var menus: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 objets Menu correspondant aux sous-menus contextuels de ce contrôle MenuBar. Chaque élément MenuBar peut disposer d’un objet Menu correspondant dans le tableau, même si l’élément ne comporte pas de sous-menu contextuel. Flex ne renseigne pas initialement le tableau menus. En revanche, il crée les menus de façon dynamique, selon les besoins. Il est déconseillé d’ajouter directement les éléments au tableau menus. Pour ajouter des menus contextuels, ajoutez-les directement au fournisseur de données du contrôle MenuBar.
La valeur par défaut est [ ].
selectedIndex | propriété |
selectedIndex:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Index du contrôle MenuBar de l’objet Menu actuellement ouvert ou du dernier objet Menu ouvert si aucun n’est actuellement ouvert.
La valeur par défaut est -1.
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 valueCommit .
Implémentation
public function get selectedIndex():int public function set selectedIndex(value:int):voidshowRoot | propriété |
showRoot: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 booléen spécifiant si le nœud racine du fournisseur de données doit être affiché. Si le fournisseur de données comporte un nœud racine et si la propriété showRoot est définie sur false, les éléments du contrôle MenuBar correspondent aux descendants immédiats du nœud racine. Cet indicateur n’a aucun effet sur les fournisseurs de données sans nœud racine, comme les contrôles Lists et Arrays.
La valeur par défaut est true.
Implémentation
public function get showRoot():Boolean public function set showRoot(value:Boolean):voidEléments de l’API associés
Détails du constructeur
MenuBar | () | Constructeur |
public function MenuBar()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
Détails de la méthode
getMenuAt | () | méthode |
public function getMenuAt(index:int):Menu| 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 référence à l’objet Menu à l’index de l’élément MenuBar spécifié. La valeur 0 correspond à l’objet Menu contenu à l’index de l’élément MenuBar le plus à gauche.
Paramètres
index:int — Index de l’instance Menu à renvoyer.
|
Menu — Référence à l’objet Menu contenu à l’index spécifié.
|
itemToIcon | () | méthode |
public function itemToIcon(data:Object):Class| 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 classe d’une icône, le cas échant, d’un élément de données, en fonction de la propriété iconField. Le champ de l’élément peut renvoyer une chaîne tant que cette chaîne représente le nom d’une classe dans l’application. Le champ de l’élément peut également être une chaîne qui est le nom d’une variable dans le document qui contient la classe de l’icône.
Paramètres
data:Object — Elément à partir duquel extraire la classe d’une icône
|
Class — Icône de l’élément, comme référence de classe ou null si aucune n’existe.
|
itemToLabel | () | méthode |
public function itemToLabel(data:Object):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 la chaîne que la fonctionnalité de rendu doit afficher pour l’objet de données spécifié, en fonction des propriétés labelField et labelFunction. Si la méthode ne peut pas convertir le paramètre en chaîne, elle renvoie un espace unique.
Paramètres
data:Object — Objet à afficher.
|
String — Chaîne à afficher en fonction des données.
|
measure | () | méthode |
override 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 largeur et la hauteur préférées du contrôle MenuBar en fonction des largeurs par défaut des éléments MenuBar.
updateBackground | () | méthode |
protected function updateBackground():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Actualise l’habillage d’arrière-plan du contrôle MenuBar. Cette méthode est appelée lorsque les enfants du contrôle MenuBar sont créés ou lorsque des styles changent sur le contrôle MenuBar.
Détails de l’événement
change | Evénement |
Type d’objet d’événement:
propriété MenuEvent.type =
mx.events.MenuEventpropriété MenuEvent.type =
mx.events.MenuEvent.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é lorsque la sélection change après une interaction de l’utilisateur. Cet événement est également distribué lorsque l’utilisateur change la sélection du menu en cours dans un sous-menu déroulant. Lorsque l’événement se produit sur la barre de menus, la propriété menu de l’objet MenuEvent a la valeur null. Lorsqu’il se produit dans un sous-menu déroulant, la propriété menu contient une référence à l’objet Menu qui représente le sous-menu déroulant.
Les valeurs des propriétés de l’objet d’événement de ce type d’événement sont les suivantes. Toutes les propriétés ne sont pas pertinentes pour chaque catégorie d’événements. Pour plus d’informations, voir les descriptions détaillées des propriétés.
| Propriété | Valeur |
|---|---|
bubbles | false |
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. |
index | Index de l’élément de menu sélectionné dans le menu. |
item | Elément sélectionné dans le fournisseur dataProvider. |
itemRenderer | Fonctionnalité de rendu d’élément de l’élément de menu sélectionné. |
label | Texte du libellé de l’élément de menu sélectionné. |
menu | Instance Menu spécifique associée à cet événement ou null si un élément MenuBar distribue l’événement. |
menuBar | Instance MenuBar constituant le parent du contrôle Menu sélectionné ou null si le contrôle Menu n’est pas apparenté à un contrôle MenuBar. |
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 | MenuEvent.CHANGE |
itemClick | Evénement |
Type d’objet d’événement:
propriété MenuEvent.type =
mx.events.MenuEventpropriété MenuEvent.type =
mx.events.MenuEvent.ITEM_CLICK| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Diffusé lorsque l’utilisateur sélectionne un élément dans un sous-menu contextuel.
La constante de type d’événement MenuEvent.ITEM_CLICK indique que l’utilisateur a sélectionné un élément de menu.Les valeurs des propriétés de l’objet d’événement de ce type d’événement sont les suivantes. Toutes les propriétés ne sont pas pertinentes pour chaque catégorie d’événements. Pour plus d’informations, voir les descriptions détaillées des propriétés.
| Propriété | Valeur |
|---|---|
bubbles | false |
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. |
index | Index de l’élément de menu sélectionné dans le menu. |
item | Elément sélectionné dans le fournisseur dataProvider. |
itemRenderer | Fonctionnalité de rendu ListItemRenderer de l’élément de menu sélectionné. |
label | Texte du libellé de l’élément de menu sélectionné. |
menu | Instance Menu spécifique associée à cet événement ou null si un élément MenuBar distribue l’événement. |
menuBar | Instance MenuBar constituant le parent du contrôle Menu sélectionné ou null si le contrôle Menu n’est pas apparenté à un contrôle MenuBar. |
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 | MenuEvent.ITEM_CLICK |
itemRollOut | Evénement |
Type d’objet d’événement:
propriété MenuEvent.type =
mx.events.MenuEventpropriété MenuEvent.type =
mx.events.MenuEvent.ITEM_ROLL_OUT| 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 pointeur de la souris cesse de survoler un élément de menu.
La constante de type MenuEvent.ITEM_ROLL_OUT indique que le pointeur de la souris s’est éloigné d’un élément de menu après l’avoir survolé.Les valeurs des propriétés de l’objet d’événement de ce type d’événement sont les suivantes. Toutes les propriétés ne sont pas pertinentes pour chaque catégorie d’événements. Pour plus d’informations, voir les descriptions détaillées des propriétés.
| Propriété | Valeur |
|---|---|
bubbles | false |
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. |
index | Index dans le menu de l’élément de menu qui a fait l’objet d’une sortie de survol. |
item | Elément du fournisseur dataProvider correspondant à l’élément de menu qui a fait l’objet d’une sortie de survol. |
itemRenderer | Fonctionnalité de rendu ListItemRenderer de l’élément de menu qui a fait l’objet d’une sortie de survol. |
label | Texte du libellé de l’élément de menu qui a fait l’objet d’une sortie de survol. |
menu | Instance Menu spécifique associée à cet événement ou null si un élément MenuBar distribue l’événement. |
menuBar | Instance MenuBar constituant le parent du contrôle Menu sélectionné ou null si le contrôle Menu n’est pas apparenté à un contrôle MenuBar. |
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 | MenuEvent.ITEM_ROLL_OUT |
itemRollOver | Evénement |
Type d’objet d’événement:
propriété MenuEvent.type =
mx.events.MenuEventpropriété MenuEvent.type =
mx.events.MenuEvent.ITEM_ROLL_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é lorsque le pointeur de la souris survole un élément de menu.
La constante de type MenuEvent.ITEM_ROLL_OVER indique que le pointeur de la souris a survolé un élément de menu.Les valeurs des propriétés de l’objet d’événement de ce type d’événement sont les suivantes. Toutes les propriétés ne sont pas pertinentes pour chaque catégorie d’événements. Pour plus d’informations, voir les descriptions détaillées des propriétés.
| Propriété | Valeur |
|---|---|
bubbles | false |
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. |
index | Index dans le menu de l’élément de menu survolé. |
item | Elément associé à l’élément de navigation survolé dans le fournisseur dataProvider. |
itemRenderer | Fonctionnalité de rendu ListItemRenderer de l’élément de menu survolé. |
label | Texte du libellé de l’élément de menu survolé. |
menu | Instance Menu spécifique associée à cet événement ou null si un élément MenuBar distribue l’événement. |
menuBar | Instance MenuBar constituant le parent du contrôle Menu sélectionné ou null si le contrôle Menu n’est pas apparenté à un contrôle MenuBar. |
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 | MenuEvent.ITEM_ROLL_OVER |
menuHide | Evénement |
Type d’objet d’événement:
propriété MenuEvent.type =
mx.events.MenuEventpropriété MenuEvent.type =
mx.events.MenuEvent.MENU_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é à la fermeture d’un sous-menu contextuel.
La constante de type MenuEvent.MENU_HIDE indique qu’un menu ou un sous-menu s’est fermé.Les valeurs des propriétés de l’objet d’événement de ce type d’événement sont les suivantes. Toutes les propriétés ne sont pas pertinentes pour chaque catégorie d’événements. Pour plus d’informations, voir les descriptions détaillées des propriétés.
| Propriété | Valeur |
|---|---|
bubbles | false |
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. |
index | -1. Cette propriété n’est pas définie pour ce type d’événement. |
item | null. Cette propriété n’est pas définie pour ce type d’événement. |
itemRenderer | null. Cette propriété n’est pas définie pour ce type d’événement. |
label | null. Cette propriété n’est pas définie pour ce type d’événement. |
menu | Instance Menu spécifique associée à cet événement ou null si un élément MenuBar distribue l’événement. |
menuBar | Instance MenuBar constituant le parent du contrôle Menu sélectionné ou null si le contrôle Menu n’est pas apparenté à un contrôle MenuBar. |
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 | MenuEvent.MENU_HIDE |
menuShow | Evénement |
Type d’objet d’événement:
propriété MenuEvent.type =
mx.events.MenuEventpropriété MenuEvent.type =
mx.events.MenuEvent.MENU_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 sous-menu contextuel s’ouvre ou lorsque l’utilisateur sélectionne un élément d’une barre de menus sans menu déroulant.
La constante de type MenuEvent.MENU_SHOW indique que le pointeur de la souris a survolé un menu ou un sous-menu ouvert.Les valeurs des propriétés de l’objet d’événement de ce type d’événement sont les suivantes. Toutes les propriétés ne sont pas pertinentes pour chaque catégorie d’événements. Pour plus d’informations, voir les descriptions détaillées des propriétés.
| Propriété | Valeur |
|---|---|
bubbles | false |
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. |
index | -1. Cette propriété n’est pas définie pour ce type d’événement. |
item | null. Cette propriété n’est pas définie pour ce type d’événement. |
itemRenderer | null. Cette propriété n’est pas définie pour ce type d’événement. |
label | null. Cette propriété n’est pas définie pour ce type d’événement. |
menu | Instance Menu spécifique associée à cet événement ou null si un élément MenuBar distribue l’événement. |
menuBar | Instance MenuBar constituant le parent du contrôle Menu sélectionné ou null si le contrôle Menu n’est pas apparenté à un contrôle MenuBar. |
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 | MenuEvent.MENU_SHOW |
Exemples Comment utiliser cet exemple
MenuBarExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Halo MenuBar control. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx"
initialize="initCollections();">
<fx:Script>
<![CDATA[
import mx.collections.*;
import mx.controls.Alert;
import mx.events.MenuEvent;
[Bindable]
public var menuBarCollection:XMLListCollection;
private var menubarXML:XMLList =
<>
<menuitem label="Menu1" data="top">
<menuitem label="MenuItem 1-A" data="1A"/>
<menuitem label="MenuItem 1-B" data="1B"/>
</menuitem>
<menuitem label="Menu2" data="top">
<menuitem label="MenuItem 2-A" type="check" data="2A"/>
<menuitem type="separator"/>
<menuitem label="MenuItem 2-B" >
<menuitem label="SubMenuItem 3-A" type="radio"
groupName="one" data="3A"/>
<menuitem label="SubMenuItem 3-B" type="radio"
groupName="one" data="3B"/>
</menuitem>
</menuitem>
</>;
// Event handler to initialize the MenuBar control.
private function initCollections():void {
menuBarCollection = new XMLListCollection(menubarXML);
}
// Event handler for the MenuBar control's itemClick event.
private function menuHandler(evt:MenuEvent):void {
// Don't open the Alert for a menu bar item that
// opens a popup submenu.
if (evt.item.@data != "top") {
Alert.show("Label: " + evt.item.@label + "\n" +
"Data: " + evt.item.@data, "Clicked menu item");
}
}
]]>
</fx:Script>
<s:Panel title="Halo MenuBar Control Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<s:VGroup left="10" right="10" top="10" bottom="10">
<s:Label width="100%" color="blue" text="Select a menu item."/>
<mx:MenuBar labelField="@label" itemClick="menuHandler(event);"
dataProvider="{menuBarCollection}" />
</s:VGroup>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z