mx.containersCanvas Un conteneur de mise en forme Halo Canvas définit une région rectangulaire dans laquelle vous placez des conteneurs et contrôles enfant. The <mx:Canvas> tag inherits all the tag attributes of its superclass. Use the following syntax:

  <mx:Canvas>
    ...
      child tags
    ...
  </mx:Canvas>

]]>mx.containers.utilityClasses:IConstraintLayoutmx.core:Container Un conteneur de mise en forme Halo Canvas définit une région rectangulaire dans laquelle vous placez des conteneurs et contrôles enfant. Il s’agit du seul conteneur qui vous permet de spécifier explicitement la position de ses enfants au sein du conteneur, par le biais des propriétés x et y de chaque enfant.

Remarque : lorsque cela est possible, Adobe vous recommande d’utiliser les conteneurs Spark avec la classe BasicLayout plutôt que le conteneur Halo Canvas.

Flex utilise la largeur et la hauteur recommandées d’un enfant d’un conteneur de mise en forme Canvas pour définir la taille de cet enfant. Vous pouvez remplacer la valeur de largeur recommandée d’un enfant en définissant sa propriété width sur un nombre de pixels fixe ou sur un pourcentage de la taille du conteneur. Vous pouvez définir la hauteur recommandée de la même manière.

Si vous définissez une taille en pourcentage dans un conteneur Canvas, il se peut que certains composants se chevauchent. Si vous ne le souhaitez pas, réfléchissez bien aux positions et aux tailles de vos composants.

Le conteneur Canvas présente les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Taille par défaut Suffisamment importante pour contenir tous les enfants à leur taille par défaut Marge par défaut 0 pixel en haut, en bas, à gauche et à droite

mx.components.Container

Canvas Constructeur. Constructeur. measure Calcule les tailles recommandées minimale et maximale du conteneur Canvas. Calcule les tailles recommandées minimale et maximale du conteneur Canvas.

La valeur measuredWidth du conteneur Canvas correspond à la valeur la plus petite permettant de contenir tous les enfants à leur largeur recommandée sans provoquer d’écrêtement. La méthode measure() calcule la position de l’enfant le plus à droite et la position du bord droit de cet enfant, puis ajoute un espace suffisant pour l’épaisseur de la bordure du conteneur Canvas et la marge droite. La valeur measuredHeight est calculée de la même manière.

Les propriétés minWidth et minHeight du conteneur Canvas ne sont pas calculées. Par conséquent, Flex utilise la valeur par défaut 0.

Les propriétés maxWidth et maxHeight du conteneur Canvas ne sont pas calculées. La largeur et la hauteur du conteneur sont supposées être illimitées.

Toutes les valeurs décrites précédemment correspondent aux largeurs et hauteurs mesurées du conteneur Canvas. L’utilisateur peut remplacer les valeurs mesurées en spécifiant explicitement une valeur pour les propriétés suivantes :

width
height
minWidth
minHeight
maxWidth
maxHeight

Vous ne devez pas appeler cette méthode directement. La classe LayoutManager de Flex l’appelle lorsque cela est nécessaire. Au démarrage de l’application, la classe LayoutManager de Flex essaie de mesurer tous les composants, enfant comme parent, avant de définir leur taille finale.

Il s’agit d’une méthode avancée à utiliser avec des sous-classes. Si vous remplacez cette méthode, l’implémentation doit appeler la méthode super.measure() ou définir les propriétés measuredHeight et measuredWidth. Si vous le souhaitez, vous pouvez définir les propriétés facultatives suivantes :

measuredMinWidth
measuredMinHeight

Ces propriétés correspondent aux propriétés de mise en forme mentionnées précédemment. Elles ne font donc pas l’objet d’une documentation séparée.

updateDisplayList Définit la taille de chaque enfant du conteneur.unscaledWidthSpécifie la largeur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleX de ce composant. unscaledHeightSpécifie la hauteur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleY de ce composant. Définit la taille de chaque enfant du conteneur.

Le conteneur Canvas ne modifie pas les positions de ses enfants. Chaque enfant est placé en fonction des valeurs de ses propriétés x et y.

En revanche, le conteneur Canvas définit la largeur et la hauteur de chaque enfant, de sorte qu’elles correspondent aux valeurs measuredWidth et measuredHeight de cet enfant, si les valeurs width et height ne sont pas précisées. Il est également possible de permettre le redimensionnement de l’enfant en définissant les valeurs width et/ou height en pourcentage. La taille des enfants redimensionnables dépend des bords droit et inférieur du conteneur Canvas. Dans ce cas, les valeurs minWidth, minHeight, maxWidth et maxHeight de l’enfant sont respectées.

Vous ne devez pas appeler cette méthode directement. La classe LayoutManager de Flex l’appelle lorsque cela est nécessaire. Au démarrage de l’application, la classe LayoutManager de Flex appelle la méthode updateDisplayList() sur chaque composant, en commençant par l’objet Application et en progressant vers le bas.

Il s’agit d’une méthode avancée à utiliser avec des sous-classes. Si vous remplacez cette méthode, l’implémentation doit appeler la méthode super.updateDisplayList() et appeler les méthodes move() et setActualSize() sur chaque enfant. Pour les besoins de la mise en forme, vous devez obtenir la taille de ce conteneur à partir des propriétés unscaledWidth et unscaledHeight, et non à partir des propriétés width et height. Les propriétés width et height ne prennent pas en compte la valeur des propriétés scaleX et scaleY de ce conteneur.

constraintColumns constraintRows FormItemDirection La classe FormItemDirection définit les valeurs de constante de la propriété direction de la classe FormItem.Object La classe FormItemDirection définit les valeurs de constante de la propriété direction de la classe FormItem.

mx.containers.FormItem

HORIZONTAL Indique que les enfants du conteneur FormItem doivent être placés horizontalement.horizontal Indique que les enfants du conteneur FormItem doivent être placés horizontalement. VERTICAL Indique que les enfants du conteneur FormItem doivent être placés verticalement.vertical Indique que les enfants du conteneur FormItem doivent être placés verticalement. DividedBox Un conteneur DividedBox mesure et place ses enfants horizontalement ou verticalement, de la même manière qu’un conteneur Box, mais des séparateurs déplaçables sont insérés entre les enfants.The <mx:DividedBox> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:DividedBox
    Properties
    liveDragging="false|true"
    resizeToContent="false|true"
  
    Styles
    dividerAffordance="6"
    dividerAlpha="0.75"
    dividerColor="0x6F7777"
    dividerSkin="'mx.skins.BoxDividerSkin' symbol in Assets.swf"
    dividerThickness="3"
    horizontalDividerCursor="'mx.skins.cursor.HBoxDivider' symbol in Assets.swf"
    verticalDividerCursor="'mx.skins.cursor.VBoxDivider' symbol in Assets.swf"
 
    Events
    dividerPress="No default"
    dividerDrag="No default"
    dividerRelease="No default"
    >
      ...
      child tags
      ...
  </mx:DividedBox>

]]>mx.containers:Box Un conteneur DividedBox mesure et place ses enfants horizontalement ou verticalement, de la même manière qu’un conteneur Box, mais des séparateurs déplaçables sont insérés entre les enfants. Les utilisateurs peuvent faire glisser un séparateur pour redimensionner les enfants de part et d’autre.

La classe DividedBox est la classe de base des classes HDividedBox et VDividedBox, qui sont utilisées plus fréquemment.

La propriété direction d’un conteneur DividedBox, héritée d’un conteneur Box, détermine si la mise en forme est horizontale ou verticale.

Les conteneurs DividedBox, HDividedBox et VDividedBox présentent les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Taille par défaut La hauteur Vertical DividedBox est suffisamment importante pour contenir tous les enfants à leur hauteur par défaut ou explicite, l’espace vertical entre les enfants, ainsi que les marges supérieure et inférieure du conteneur. La largeur correspond à somme de la largeur par défaut ou explicite de l’enfant le plus large et des marges gauche et droite du conteneur. La largeur Horizontal DividedBox est suffisamment importante pour contenir tous les enfants à la largeur par défaut ou explicite de ces enfants, l’espace horizontal entre les enfants, ainsi que les marges gauche et droite du conteneur. La hauteur correspond à somme de la hauteur par défaut ou explicite de l’enfant le plus grand et des marges supérieure et inférieure du conteneur. Marge par défaut 0 pixel en haut, en bas, à gauche et à droite. Espace par défaut 10 pixels pour les espaces horizontal et vertical.

mx.containers.HDividedBoxmx.containers.VDividedBox

dividerRelease Distribué lorsque l’utilisateur relâche un séparateur.mx.events.DividerEvent.DIVIDER_RELEASEmx.events.DividerEvent Distribué lorsque l’utilisateur relâche un séparateur. L’événement dividerRelease est distribué après les événements dividerDrag, mais avant le redimensionnement des enfants du conteneur. Les propriétés x et y du séparateur ne sont pas mises à jour tant que cet événement n’a pas été déclenché. Par conséquent, l’appel de la méthode hDividerBox.getDividerAt(0).x retourne la valeur de la position x d’origine du premier séparateur. Si vous souhaitez obtenir la position du séparateur après le déplacement, vous pouvez y accéder une fois que l’événement updateComplete du conteneur DividerBox a été déclenché. dividerPress Distribué lorsque l’utilisateur clique sur un séparateur présent dans ce conteneur.mx.events.DividerEvent.DIVIDER_PRESSmx.events.DividerEvent Distribué lorsque l’utilisateur clique sur un séparateur présent dans ce conteneur. L’événement dividerPress est distribué avant les événements dividerDrag. dividerDrag Distribué à plusieurs reprises lorsque l’utilisateur déplace un séparateur.mx.events.DividerEvent.DIVIDER_DRAGmx.events.DividerEvent Distribué à plusieurs reprises lorsque l’utilisateur déplace un séparateur. L’événement dividerDrag est distribué après l’événement dividerPress, mais avant l’événement dividerRelease. DividedBox Constructeur. Constructeur. getDividerAt Retourne une référence à l’objet BoxDivider de ce conteneur DividedBox.Objet BoxDivider. mx.containers.dividedBoxClasses:BoxDivideriIndex de base zéro d’un séparateur, à partir de la gauche dans le cas d’un conteneur DividedBox horizontal, à partir du haut dans le cas d’un conteneur DividedBox vertical. Retourne une référence à l’objet BoxDivider de ce conteneur DividedBox. moveDivider Déplace un séparateur spécifique d’un nombre donné de pixels.iIndex de base zéro d’un séparateur, à partir de la gauche dans le cas d’un conteneur DividedBox horizontal, à partir du haut dans le cas d’un conteneur DividedBox vertical. amtNombre de pixels de déplacement du séparateur. Un nombre négatif peut être spécifié, de façon à déplacer un séparateur vers le haut ou vers la gauche. Le mouvement du séparateur est limité, comme lorsqu’un utilisateur le déplace. Déplace un séparateur spécifique d’un nombre donné de pixels. dividerClass Classe du séparateur présent entre les enfants.mx.containers.dividedBoxClasses.BoxDivider Classe du séparateur présent entre les enfants. liveDragging Si la valeur est true, les enfants voisins d’un séparateur sont redimensionnés en permanence, à mesure que l’utilisateur le déplace.falsefalse Si la valeur est true, les enfants voisins d’un séparateur sont redimensionnés en permanence, à mesure que l’utilisateur le déplace. Si la valeur est false, ils sont redimensionnés uniquement lorsque l’utilisateur relâche le bouton de la souris. numDividers Nombre de séparateurs. Nombre de séparateurs. Le nombre est toujours égal à numChildren - 1. resizeToContent Si la valeur est true, le conteneur DividedBox est redimensionné automatiquement en fonction de la taille de ses enfants.false Si la valeur est true, le conteneur DividedBox est redimensionné automatiquement en fonction de la taille de ses enfants. ApplicationControlBar Le conteneur ApplicationControlBar contient des composants fournissant des commandes globales de navigation et d’application au conteneur Halo Application. A partir de Flex 4, le composant ApplicationControlBar n’est plus nécessaire. Utilisez la propriété controlBarContent de la classe Spark Application pour spécifier l’ensemble de composants à inclure dans la zone de la barre de contrôle. Utilisez la propriété controlBarLayout de la classe Spark Application pour spécifier la mise en forme de la zone de la barre de contrôle. The <mx:ApplicationControlBar> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes. Unlike the ControlBar container, it is possible to set the backgroundColor style for an ApplicationControlBar container.

  <mx:ApplicationControlBar
    Properties
    dock="false|true"
  
    Styles
    fillAlphas="[0, 0]"
    fillColors="[0xFFFFFF, 0xFFFFFF]"
    >
    ...
      child tags
    ...
  </mx:ApplicationControlBar>

]]>mx.containers:ControlBar Le conteneur ApplicationControlBar contient des composants fournissant des commandes globales de navigation et d’application au conteneur Halo Application. Le conteneur ApplicationControlBar d’un éditeur, par exemple, peut contenir des contrôles Button permettant de définir l’épaisseur de la police, un contrôle ComboBox permettant de sélectionner la police, ainsi qu’un contrôle MenuBar permettant de sélectionner le mode d’édition. En général, un conteneur ApplicationControlBar est placé en haut d’un conteneur Halo Application.

Remarque : le conteneur Spark Application ne prend pas en charge le conteneur ApplicationControlBar. Modifiez l’habillage du conteneur Spark Application pour ajouter cette fonctionnalité.

Le conteneur ApplicationControlBar offre différents modes de fonctionnement :

Mode ancré : la barre est toujours affichée en haut de la zone de tracé de l’application et fait partie du chrome de l’application. Les barres de défilement définies au niveau de l’application ne s’appliquent pas au composant. Celui-ci reste donc toujours en haut de la zone visible et la barre est élargie pour remplir la largeur de l’application. Pour créer une barre ancrée, définissez la valeur de la propriété dock sur true.
Mode normal : la barre peut être placée n’importe où dans l’application, et sa taille et sa position sont définies comme n’importe quel autre composant. Elle défile en même temps que l’application. Pour créer une barre normale, définissez la valeur de la propriété dock sur false (valeur par défaut).

Le conteneur ApplicationControlBar présente les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Taille par défaut La hauteur correspond à somme de la hauteur par défaut ou explicite de l’enfant le plus grand et des marges supérieure et inférieure du conteneur. En mode normal, la largeur est suffisamment importante pour contenir tous les enfants à leur largeur par défaut ou explicite, l’espace horizontal entre les enfants, ainsi que les marges gauche et droite du conteneur. En mode ancré, la largeur est égale à la largeur de l’application. Si l’application n’est pas suffisamment large pour contenir tous les contrôles du conteneur ApplicationControlBar, la barre est écrêtée. Marge par défaut 5 pixels en haut. 4 pixels en bas. 8 pixels à gauche et à droite.

mx.core.Application

ApplicationControlBar Constructeur. Constructeur. dock Si la valeur est true, le conteneur ApplicationControlBar est ancré en haut de l’application.false Si la valeur est true, le conteneur ApplicationControlBar est ancré en haut de l’application. Si la valeur est false, la taille et la position du conteneur ApplicationControlBar sont définies comme pour n’importe quel autre composant. Cette propriété est prise en charge lorsque l’application est de type Application. Sinon, la valeur de dock n’est pas prise en compte. HDividedBox Le conteneur HDividedBox place ses enfants horizontalement, de la même manière qu’un conteneur HBox, mais un séparateur déplaçable est inséré entre les enfants.The <mx:HDividedBox> tag inherits all of the tag attributes of its superclass except direction and adds no new tag attributes.

]]>mx.containers:DividedBox Le conteneur HDividedBox place ses enfants horizontalement, de la même manière qu’un conteneur HBox, mais un séparateur déplaçable est inséré entre les enfants. Les utilisateurs peuvent faire glisser le séparateur pour redimensionner la zone allouée à chaque enfant. La balise <mx:HDividedBox/> est identique à <mx:DividedBox direction="horizontal"/>.

Le conteneur HDividedBox présente les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Taille par défaut La largeur est suffisamment importante pour contenir tous les enfants à leur largeur par défaut ou explicite, l’espace horizontal entre les enfants, ainsi que les marges gauche et droite du conteneur. La hauteur correspond à somme de la hauteur par défaut ou explicite de l’enfant le plus grand et des marges supérieure et inférieure du conteneur. Marge par défaut 0 pixel en haut, en bas, à gauche et à droite. Espace par défaut 10 pixels pour les espaces horizontal et vertical.

mx.containers.DividedBoxmx.containers.VDividedBox

HDividedBox Constructeur. Constructeur. Grid Un conteneur Grid permet de présenter les enfants sous forme de lignes et de colonnes de cellules, comme dans un tableau HTML.The <mx:Grid> tag inherits all of the tag attributes of its superclass, except the Box.direction property, and adds the following tag attributes:

  <mx:Grid
    Styles
    horizontalGap="8"
    verticalGap="6"
    >
      ...
    These child tags are examples only:
       <mx:GridRow id="row1">
        <mx:GridItem
          rowSpan="1"
          colSpan="1">
            <mx:Button label="Button 1"/>
        </mx:GridItem>
        ...
       </mx:GridRow>
    ...
  </mx:Grid>

]]>mx.containers:Box Un conteneur Grid permet de présenter les enfants sous forme de lignes et de colonnes de cellules, comme dans un tableau HTML. Le conteneur Grid contient une ou plusieurs lignes, chacune d’entre elles pouvant contenir une ou plusieurs cellules ou éléments. Utilisez les balises suivantes pour définir un contrôle Grid :

La balise <mx:Grid> définit un conteneur Grid.
La balise <mx:GridRow> définit une ligne de grille contenant une ou plusieurs cellules. La ligne de grille doit être un enfant de la balise <Grid>.
La balise <mx:GridItem> définit une cellule de grille et doit être un enfant de la balise <GridRow>. La balise <mx:GridItem> peut contenir un nombre illimité d’enfants.

La hauteur de toutes les cellules d’une même ligne est la même, mais la hauteur peut varier d’une ligne à une autre. La largeur de toutes les cellules d’une même colonne est la même, mais la largeur peut varier d’une colonne à une autre. Vous pouvez définir un nombre différent de cellules pour chacune des lignes ou colonnes du conteneur Grid. Par ailleurs, une cellule peut s’étendre sur plusieurs colonnes ou plusieurs lignes du conteneur.

Les conteneurs Grid, GridRow et GridItem présentent les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Hauteur de la grille Somme des hauteurs par défaut ou explicites de toutes les lignes et des espaces séparant les lignes. Largeur de la grille Somme de la largeur par défaut ou explicite de toutes les colonnes et des espaces séparant les colonnes. Hauteur de chaque ligne et de chaque cellule Hauteur par défaut ou explicite de l’élément le plus grand de la ligne. Si un conteneur GridItem n’a pas de taille explicite, sa hauteur par défaut correspond à la hauteur par défaut ou explicite de l’enfant présent dans la cellule. Largeur de chaque colonne et de chaque cellule Largeur par défaut ou explicite de l’élément le plus large de la colonne. Si un conteneur GridItem n’a pas de largeur explicite, sa largeur par défaut correspond à la largeur par défaut ou explicite de l’enfant présent dans la cellule. Espace entre les lignes et les colonnes Déterminé par les propriétés horizontalGap et verticalGap de la classe Grid. La valeur par défaut des deux espaces est de 6 pixels. Marge par défaut 0 pixel en haut, en bas, à gauche et à droite, pour les trois classes de conteneur.

mx.containers.GridRowmx.containers.GridItem

Grid Constructeur. Constructeur. measure Calcule les tailles recommandée, minimale et maximale du conteneur Grid. Calcule les tailles recommandée, minimale et maximale du conteneur Grid.

N’appelez pas cette méthode directement : il s’agit d’une méthode avancée à utiliser avec une sous-classe. La classe LayoutManager de Flex appelle la méthode measure() lorsque cela est nécessaire. Au démarrage de l’application, la classe LayoutManager de Flex essaie de mesurer tous les composants, enfant comme parent, avant de définir leur taille finale.

Pour comprendre comment le conteneur Grid calcule ses mesures, supposons que les propriétés rowSpan et colSpan de chaque conteneur sont définies sur 1. La largeur mesurée de la première colonne du conteneur Grid est égale à la plus grande des largeurs mesurées de tous les conteneurs GridItem de la première colonne. De même, la largeur mesurée de la deuxième colonne est égale à la plus grande des largeurs mesurées de tous les conteneurs GridItem de la deuxième colonne, et ainsi de suite. La largeur measuredWidth de l’ensemble du conteneur Grid correspond à la somme de toutes les largeurs mesurées des colonnes, de l’épaisseur de la bordure, des marges gauche et droite et de l’espace horizontal entre les cellules de la grille.

Les valeurs des propriétés measuredHeight, minWidth, minHeight, maxWidth et maxHeight sont toutes calculées de la même manière, en additionnant les valeurs des propriétés measuredHeight, minWidth, etc. des conteneurs GridItem.

Si la valeur de la propriété colSpan d’un conteneur GridItem est 3, la largeur measuredWidth de ce conteneur GridItem est répartie entre les trois colonnes. Si la largeur measuredWidth est divisée en parts égales, chacune des trois colonnes calcule sa largeur mesurée comme si le conteneur GridItem était présent uniquement dans cette colonne et que la largeur measuredWidth de ce conteneur GridItem était égale à un tiers de sa valeur réelle.

Cependant, la valeur measuredWidth du conteneur GridItem n’est pas toujours divisée à parts égales entre toutes les colonnes sur lesquelles le conteneur s’étend. Si certaines colonnes contiennent une propriété dont la largeur width est définie en pourcentage, la propriété measuredWidth du conteneur GridItem est divisée en conséquence, en essayant de faire en sorte que chaque colonne occupe du pourcentage demandé du conteneur Grid.

Toutes les valeurs décrites précédemment correspondent aux largeurs et hauteurs mesurées du conteneur Grid. L’utilisateur peut remplacer les valeurs mesurées en spécifiant explicitement une valeur pour les propriétés suivantes :

minHeight
minWidth
maxHeight
maxWidth
height
width

Si vous remplacez cette méthode, l’implémentation doit appeler la méthode super.measure() ou définir les propriétés measuredHeight et measuredWidth. Si vous le souhaitez, vous pouvez définir les propriétés facultatives suivantes :

measuredMinWidth
measuredMinHeight

Ces propriétés correspondent aux propriétés de mise en forme mentionnées précédemment. Elles ne font donc pas l’objet d’une documentation séparée.

updateDisplayList Définit la taille et la position de chaque enfant du conteneur Grid.unscaledWidthSpécifie la largeur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleX de ce composant. unscaledHeightSpécifie la hauteur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleY de ce composant. Définit la taille et la position de chaque enfant du conteneur Grid.

N’appelez pas cette méthode directement : il s’agit d’une méthode avancée à utiliser avec une sous-classe. La classe LayoutManager de Flex appelle la méthode updateDisplayList lorsque cela est nécessaire. Au démarrage de l’application, la classe LayoutManager de Flex appelle la méthode updateDisplayList() sur chaque composant, en commençant par la racine et en progressant vers le bas.

Le conteneur Grid suit les mêmes règles de mise en forme que le conteneur VBox. La position et la taille des conteneurs GridRow sont calculées de la même manière que lorsqu’un conteneur VBox détermine la position et la taille de ses enfants. De même, un conteneur GridRow place ses conteneurs GridItem en utilisant un algorithme de mise en forme similaire à celui d’un conteneur HBox.

La seule différence réside dans le fait que tous les conteneurs GridRow fonctionnent de façon coordonnée : ils choisissent tous la même position et la même taille pour leurs enfants, de sorte que les colonnes du conteneur Grid soient alignées.

Si vous remplacez cette méthode, l’implémentation doit appeler la méthode super.updateDisplayList() et appeler les méthodes move() et setActualSize() sur chaque enfant. Pour les besoins de la mise en forme, vous devez obtenir la taille de ce conteneur à partir des propriétés unscaledWidth et unscaledHeight, et non à partir des propriétés width et height. Les propriétés width et height ne prennent pas en compte les valeurs des propriétés scaleX et scaleY de ce conteneur.

TileDirection La classe TileDirection définit les valeurs de constante de la propriété direction du conteneur Tile.Object La classe TileDirection définit les valeurs de constante de la propriété direction du conteneur Tile.

mx.containers.Tile

HORIZONTAL Indique que les enfants du conteneur Tile doivent être placés horizontalement, c’est-à-dire en commençant par la première ligne.horizontal Indique que les enfants du conteneur Tile doivent être placés horizontalement, c’est-à-dire en commençant par la première ligne. VERTICAL Indique que les enfants du conteneur Tile doivent être placés verticalement, c’est-à-dire en commençant par la première colonne.vertical Indique que les enfants du conteneur Tile doivent être placés verticalement, c’est-à-dire en commençant par la première colonne. TabNavigator Le conteneur MX TabNavigator étend le conteneur MX ViewStack en incluant un conteneur TabBar permettant l’accès aux différents conteneurs Halo enfants.The <mx:TabNavigator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:TabNavigator
    Styles
    fillAlphas="[0.60, 0.40, 0.75, 0.65]"
    fillColors="[0xFFFFFF, 0xCCCCCC, 0xFFFFFF, 0xEEEEEE]"
    firstTabStyleName="Value of the tabStyleName property"
    focusAlpha="0.4"
    focusRoundedCorners="tl tr bl br"
    horizontalAlign="left|center|right"
    horizontalGap="-1"
    lastTabStyleName="Value of the tabStyleName property"
    selectedTabTextStyleName="undefined"
    tabHeight="undefined"
    tabOffset="0"
    tabStyleName="Name of CSS style declaration that specifies styles for the tabs"
    tabWidth="undefined"
    >
      ...
      child tags
      ...
  </mx:TabNavigator>

]]>mx.managers:IFocusManagerComponentmx.containers:ViewStack Le conteneur MX TabNavigator étend le conteneur MX ViewStack en incluant un conteneur TabBar permettant l’accès aux différents conteneurs Halo enfants.

Remarque : les enfants directs d’un conteneur de navigateur MX doivent être des conteneurs MX (de présentation MX ou navigateur MX) ou le conteneur Spark NavigatorContent. Vous ne pouvez pas imbriquer directement un contrôle ou un conteneur Spark autre que le conteneur NavigatorContent dans un navigateur. Ils doivent être les enfants d’un conteneur MX enfant.

Comme les conteneurs ViewStack, un conteneur TabNavigator contient une collection de conteneurs enfant, dans laquelle un seul enfant est visible à la fois. Flex crée automatiquement un conteneur TabBar en haut du conteneur TabNavigator, chaque onglet correspondant à un conteneur enfant. Chaque onglet peut contenir ses propres libellé et icône. Lorsque l’utilisateur clique sur un onglet, le conteneur enfant correspondant devient visible en tant qu’enfant sélectionné du conteneur TabNavigator.

Lorsque le conteneur enfant actuellement visible change, vous pouvez utiliser la propriété hideEffect du conteneur masqué et la propriété showEffect du conteneur enfant devenu visible pour appliquer un effet aux conteneurs enfant. Le conteneur TabNavigator attend que l’effet hideEffect du conteneur enfant masqué soit terminé avant de faire apparaître le nouveau conteneur enfant. Vous pouvez interrompre un effet en cours en modifiant la propriété selectedIndex du conteneur TabNavigator pendant la lecture d’un effet.

Pour définir l’apparence des onglets dans un conteneur TabNavigator, vous pouvez définir les propriétés de style dans un sélecteur de type Tab, comme l’illustre l’exemple suivant :

  <fx:Style>
    @namespace mx "library://ns.adobe.com/flex/mx"
    mx|Tab {
       fillColors: #006699, #cccc66;
       upSkin: ClassReference("CustomSkinClass");
       overSkin: ClassReference("CustomSkinClass");
       downSkin: ClassReference("CustomSkinClass");
    }  
  </fx:Style>

Le sélecteur de type Tab définit les valeurs de la classe masquée mx.controls.tabBarClasses.Tab. Les valeurs par défaut du sélecteur de type Tab sont définies dans le fichier defaults.css.

Vous pouvez également définir les styles dans un sélecteur de classe que vous spécifiez par le biais de la propriété de style tabStyleName. Exemple :

  <fx:Style>
    @namespace mx "library://ns.adobe.com/flex/mx"
    mx|TabNavigator {
       tabStyleName:myTabStyle;
    }
 
    .myTabStyle {
       fillColors: #006699, #cccc66;
       upSkin: ClassReference("CustomSkinClass");
       overSkin: ClassReference("CustomSkinClass");
       downSkin: ClassReference("CustomSkinClass");
    }
  </fx:Style>

Le conteneur TabNavigator présente les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Taille par défaut Largeur et hauteur par défaut ou explicites du premier enfant actif et des onglets, à leurs hauteur et largeur explicites ou par défaut. La hauteur par défaut des onglets dépend de la police, du style et de l’habillage appliqués au conteneur TabNavigator. Règles de redimensionnement de conteneur Par défaut, la taille des conteneurs TabNavigator est déterminée une seule fois, en fonction de la taille du premier conteneur enfant. Ils ne sont pas redimensionnés lorsque vous accédez à d’autres conteneurs enfant. Pour forcer un redimensionnement des conteneurs TabNavigator lorsque vous accédez à un autre conteneur enfant, définissez la propriété resizeToContent sur true. Règles de mise en forme des enfants Si l’enfant est plus grand que le conteneur TabNavigator, il est écrêté. Si l’enfant est plus petit que le conteneur TabNavigator, il est placé dans l’angle supérieur gauche de ce conteneur. Marge par défaut 0 pixel en haut, en bas, à gauche et à droite.

mx.containers.ViewStackmx.controls.TabBar

TabNavigator Constructeur. Constructeur. getTabAt Retourne l’onglet qui se trouve à l’index spécifié dans le contrôle TabBar du navigateur.Onglet qui se trouve à l’index spécifié. mx.controls:ButtonindexIndex dans le contrôle TabBar du navigateur. Retourne l’onglet qui se trouve à l’index spécifié dans le contrôle TabBar du navigateur. measure Calcule les tailles par défaut ainsi que les valeurs minimale et maximale de ce conteneur TabNavigator. Calcule les tailles par défaut ainsi que les valeurs minimale et maximale de ce conteneur TabNavigator. Pour plus d’informations sur la méthode measure(), voir la méthode UIComponent.measure().

Le conteneur TabNavigator utilise la même logique de mesure que le conteneur ViewStack, à deux exceptions près. Tout d’abord, il augmente la valeur des propriétés measuredHeight et measuredMinHeight de manière à les adapter aux onglets. Il augmente ensuite la valeur de la propriété measuredWidth si cela est nécessaire, pour faire en sorte que la largeur de chaque onglet soit d’au moins 30 pixels.

mx.core.UIComponent.measure()mx.containers.ViewStack.measure()

updateDisplayList Réagit aux changements de taille en définissant la taille et la position des onglets et des enfants de ce conteneur.unscaledWidthSpécifie la largeur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleX de ce composant. unscaledHeightSpécifie la hauteur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleY de ce composant. Réagit aux changements de taille en définissant la taille et la position des onglets et des enfants de ce conteneur. Pour plus d’informations sur la méthode updateDisplayList(), voir la méthode UIComponent.updateDisplayList().

Un conteneur TabNavigator place son conteneur TabBar en haut. La largeur du conteneur TabBar correspond à celle du conteneur TabNavigator et la hauteur du conteneur TabBar est basée sur la propriété tabHeight.

Un conteneur TabNavigator définit la taille de ses conteneurs enfant et les place sous le conteneur TabBar en utilisant la même logique que dans un conteneur ViewStack.

mx.core.UIComponent.updateDisplayList()

tabBar Référence au conteneur TabBar présent dans ce conteneur TabNavigator.mx.controls:TabBar Référence au conteneur TabBar présent dans ce conteneur TabNavigator. tabBarStyleFilters Jeu de styles à transmettre entre le conteneur TabNavigator et le navigateur tabBar. Jeu de styles à transmettre entre le conteneur TabNavigator et le navigateur tabBar.

mx.styles.StyleProxy

HBox Le conteneur Halo HBox place ses enfants dans une seule ligne horizontale. The <mx:HBox> tag inherits all of the tag attributes of its superclass, except direction, and adds no new tag attributes.

]]>mx.containers:Box Le conteneur Halo HBox place ses enfants dans une seule ligne horizontale. Utilisez la balise <mx:HBox> plutôt que la balise <mx:Box> en tant que raccourci, pour éviter de devoir définir la propriété direction sur "horizontal".

Remarque : lorsque cela est possible, Adobe vous recommande d’utiliser les conteneurs Spark avec la classe HorizontalLayout plutôt que le conteneur Halo HBox.

Le conteneur HBox présente les caractéristiques de taille par défaut suivantes :

mx.components.Containermx.containers.Boxmx.containers.VBox

HBox Constructeur. Constructeur. VBox Le conteneur Halo VBox place ses enfants dans une seule colonne verticale. The <mx:VBox> tag inherits all of the tag attributes of its superclass, except direction, and adds no new tag attributes.

]]>mx.containers:Box Le conteneur Halo VBox place ses enfants dans une seule colonne verticale. Utilisez la balise <mx:VBox> plutôt que la balise <mx:Box> en tant que raccourci, pour éviter de devoir définir la propriété direction sur "vertical".

Remarque : lorsque cela est possible, Adobe vous recommande d’utiliser les conteneurs Spark avec la classe VerticalLayout plutôt que le conteneur Halo VBox.

Le conteneur VBox présente les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Taille par défaut La hauteur est suffisamment importante pour contenir tous les enfants à leur hauteur par défaut ou explicite, l’espace vertical entre les enfants, ainsi que les marges supérieure et inférieure du conteneur. La largeur correspond à somme de la largeur par défaut ou explicite de l’enfant le plus large et des marges gauche et droite du conteneur. Marge par défaut 0 pixel en haut, en bas, à gauche et à droite.

mx.components.Containermx.containers.Boxmx.containers.HBox

VBox Constructeur. Constructeur. TitleWindow Un conteneur de mise en forme TitleWindow se compose d’une barre de titre, d’une légende, d’une bordure et d’une zone de contenu permettant d’accueillir son enfant. The <mx:TitleWindow> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:TitleWindow
   Properties
   showCloseButton="false|true"
 
   Styles
   closeButtonDisabledSkin="'CloseButtonDisabled' symbol in Assets.swf"
   closeButtonDownSkin="'CloseButtonDown' symbol in Assets.swf"
   closeButtonOverSkin="'CloseButtonOver' symbol in Assets.swf"
   closeButtonUpSkin="'CloseButtonUp' symbol in Assets.swf"
  
   Events
   close="No default"
   >
    ...
      child tags
    ...
  />

]]>mx.containers:Panel Un conteneur de mise en forme TitleWindow se compose d’une barre de titre, d’une légende, d’une bordure et d’une zone de contenu permettant d’accueillir son enfant. Les conteneurs TitleWindow sont généralement utilisés pour envelopper des modules d’application autonomes. Vous pouvez par exemple insérer un formulaire dans un conteneur TitleWindow. Lorsque l’utilisateur remplit le formulaire, vous pouvez fermer le conteneur TitleWindow par programmation ou laisser l’utilisateur le fermer à l’aide du bouton Fermer.

Le conteneur TitleWindow présente les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Taille par défaut La hauteur est suffisamment importante pour contenir tous les enfants dans la zone de contenu à leur hauteur par défaut ou explicite, la barre de titre et la bordure, l’espace vertical entre les enfants, ainsi que les marges supérieure et inférieure du conteneur. La largeur correspond soit à la somme de la largeur par défaut ou explicite de l’enfant le plus large et des marges gauche et droite des bordures du conteneur, soit à la largeur du texte de titre, la valeur la plus grande étant prise en compte. bordures 10 pixels à gauche et à droite. 2 pixels en haut. 0 pixel en bas. marge 4 pixels en haut, en bas, à gauche et à droite.

mx.core.Applicationmx.managers.PopUpManagermx.containers.Panel

close Distribué lorsque l’utilisateur sélectionne le bouton de fermeture.3985 mx.events.CloseEvent.CLOSEmx.events.CloseEventévénement close Distribué lorsque l’utilisateur sélectionne le bouton de fermeture. TitleWindow Constructeur. Constructeur. showCloseButton Détermine si un bouton de fermeture doit ou non être affiché dans le conteneur TitleWindow.3986 false Si la valeur est true, le bouton de fermeture est affiché. Détermine si un bouton de fermeture doit ou non être affiché dans le conteneur TitleWindow. La valeur par défaut est false. Définissez cette propriété sur true pour afficher le bouton de fermeture. La sélection du bouton de fermeture génère un événement close, mais le conteneur TitleWindow n’est pas fermé pour autant. Vous devez écrire un gestionnaire pour l’événement close et fermer le conteneur TitleWindow à partir de ce gestionnaire. FormHeading Le conteneur FormHeading permet d’afficher un titre pour un groupe de contrôles présents dans un conteneur Form.The <mx:FormHeading> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:FormHeading
    Properties
    label=""
  
    Styles
    color="0x0B333C"
    disabledColor="0xAAB3B3"
    fontAntiAliasType="advanced|normal"
    fontFamily="Verdana"
    fontGridFitType="pixel|subpixel|none"
    fontSharpness="0"
    fontSize="12"
    fontStyle="normal|italic"
    fontThickness="0"
    fontWeight="normal|bold"
    indicatorGap="14"
    labelWidth="Calculated"
    leading="2"
    paddingLeft="0"
    paddingRight="0"
    paddingTop="0"
    textAlign="Calculated"
    textDecoration="none|underline"
    textIndent="0"
  />

]]>mx.core:UIComponent Le conteneur FormHeading permet d’afficher un titre pour un groupe de contrôles présents dans un conteneur Form. Le côté gauche du titre est aligné sur le côté gauche des contrôles du formulaire. Vous pouvez insérer plusieurs conteneurs FormHeading dans un même conteneur Form.

mx.containers.Formmx.containers.FormItem

FormHeading Constructeur. Constructeur. label Texte de titre du formulaire. Texte de titre du formulaire. Accordion Un conteneur de navigateur MX Accordion a une collection de conteneurs MX enfant ou de conteneurs Spark NavigatorContent, mais uniquement l’un d’entre eux est visible à la fois. The <mx:Accordion> tag inherits all of the tag attributes of its superclass, with the exception of scrolling-related attributes, and adds the following tag attributes:

  <mx:Accordion
    Properties
    headerRenderer="IFactory"
    historyManagementEnabled="true|false"
    resizeToContent="false|true"
    selectedChild"A reference to the first child"
    selectedIndex="undefined"
  
    Styles
    headerHeight="depends on header font styles"
    headerStyleName="No default"
    horizontalGap="8"
    openDuration="250"
    openEasingFunction="undefined"
    paddingBottom="-1"
    paddingTop="-1"
    textRollOverColor="0xB333C"
    textSelectedColor="0xB333C"
    verticalGap="-1"
  
    Events
    change="No default"
    >
      ...
      child tags
      ...
  </mx:Accordion>

]]>Un conteneur Accordion permet d’accéder à différentes vues enfant. mx.managers:IHistoryManagerClientmx.managers:IFocusManagerComponentmx.core:Container Un conteneur de navigateur MX Accordion a une collection de conteneurs MX enfant ou de conteneurs Spark NavigatorContent, mais uniquement l’un d’entre eux est visible à la fois. Il crée et gère les boutons de navigateur (en-têtes d’accordéon) que vous pouvez utiliser pour accéder aux différents enfants. Un bouton de navigateur est associé à chaque conteneur enfant. Chaque bouton de navigateur appartient au conteneur Accordion et non à l’enfant. Lorsque l’utilisateur clique sur un bouton de navigateur, le conteneur enfant associé s’affiche. La transition vers le nouvel enfant fait appel à une animation pour bien faire comprendre à l’utilisateur qu’un enfant disparaît et qu’un autre apparaît.

Le conteneur Accordion n’étend pas le conteneur ViewStack, mais il implémente l’ensemble des propriétés, méthodes, styles et événements du conteneur ViewStack, par exemple selectedIndex et selectedChild.

Un conteneur Accordion présente les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Taille par défaut Largeur et hauteur de l’enfant actuellement actif. Règles de redimensionnement de conteneur Par défaut, la taille des conteneurs Accordion est déterminée une seule fois, en fonction de la taille du premier conteneur enfant. Par défaut, ils ne sont pas redimensionnés lorsque vous accédez à d’autres conteneurs enfant. Pour forcer un redimensionnement des conteneurs Accordion lorsque vous accédez à un autre conteneur enfant, définissez la propriété resizeToContent sur true. Règles de définition de la taille des enfants La taille des enfants est définie sur leur taille par défaut. L’enfant est écrêté s’il est plus grand que le conteneur Accordion. Si l’enfant est plus petit que le conteneur Accordion, il est placé dans l’angle supérieur gauche de ce conteneur. Marge par défaut -1 pixel en haut, en bas, à gauche et à droite.

mx.containers.accordionClasses.AccordionHeader

change Distribué lorsque le conteneur enfant sélectionné change.3012 mx.events.IndexChangedEvent.CHANGEmx.events.IndexChangedEventévénement change Distribué lorsque le conteneur enfant sélectionné change. Accordion Constructeur. Constructeur. getHeaderAt Retourne une référence au bouton de navigateur d’un conteneur enfant.Objet Button représentant le bouton de navigateur. mx.controls:ButtonindexIndex de base zéro de l’enfant. Retourne une référence au bouton de navigateur d’un conteneur enfant. loadState stateEtat de l’objet à charger. La valeur est null lors du chargement de l’état initial de l’application. saveState Etat de cet objet. contentHeight Hauteur de la zone dans laquelle le contenu est affiché, en pixels. Hauteur de la zone dans laquelle le contenu est affiché, en pixels. Vous pouvez remplacer cet accesseur de lecture si votre contenu n’occupe pas l’intégralité de la zone du conteneur. contentWidth Largeur de la zone dans laquelle le contenu est affiché, en pixels. Largeur de la zone dans laquelle le contenu est affiché, en pixels. Vous pouvez remplacer cet accesseur de lecture si votre contenu n’occupe pas l’intégralité de la zone du conteneur. headerRenderer Fabrique utilisée pour créer les boutons de navigation de chaque enfant.mx.core:IFactory Fabrique utilisée pour créer les boutons de navigation de chaque enfant. La valeur par défaut est une fabrique qui crée un objet mx.containers.accordionClasses.AccordionHeader. L’objet créé doit être une sous-classe de Button et implémenter l’interface mx.core.IDataRenderer. La propriété data contient le contenu associé à l’en-tête.

mx.containers.accordionClasses.AccordionHeader

historyManagementEnabled Si la valeur est true, cette propriété active la gestion d’historique dans ce conteneur Accordion.true Si la valeur est true, cette propriété active la gestion d’historique dans ce conteneur Accordion. Lorsque l’utilisateur accède aux différents enfants, le navigateur mémorise les enfants visités. L’utilisateur peut cliquer ensuite sur les boutons Précédent et Suivant pour parcourir l’historique de navigation.

mx.managers.HistoryManager

resizeToContent Si la valeur est true, ce conteneur Accordion est redimensionné automatiquement, en fonction de la taille de son enfant actuel.false Si la valeur est true, ce conteneur Accordion est redimensionné automatiquement, en fonction de la taille de son enfant actuel. selectedChild Référence au conteneur enfant actuellement visible.3401 mx.core:INavigatorContentSpécifie la vue enfant actuellement affichée. Référence au conteneur enfant actuellement visible. La valeur par défaut est une référence au premier enfant. En l’absence d’enfant, la valeur de cette propriété est null.

Remarque : vous pouvez définir cette propriété uniquement dans une instruction ActionScript, pas dans du code MXML.

selectedIndex Index de base zéro du conteneur de l’enfant actuellement visible.3402 0 Spécifie l’index de la vue enfant actuellement affichée. Index de base zéro du conteneur de l’enfant actuellement visible. Les index des enfants utilisent la plage de valeurs 0, 1, 2, ..., n - 1, où n correspond au nombre d’enfants. La valeur par défaut est 0, ce qui correspond au premier enfant. En l’absence d’enfant, la valeur de cette propriété est -1. ControlBar Le conteneur ControlBar permet de placer des contrôles au bas d’un conteneur Halo Panel ou Halo TitleWindow. A partir de Flex 4, le composant ControlBar n’est plus nécessaire. Utilisez la propriété controlBarContent de la classe Spark Panel pour spécifier l’ensemble de composants à inclure dans la zone de la barre de contrôle. Utilisez la propriété controlBarLayout de la classe Spark Panel pour spécifier la mise en forme de la zone de la barre de contrôle. The <mx:ControlBar> tag inherits all the tag attributes but adds no additional attributes:

  <mx:ControlBar>
    ...
      child tags
    ...
  </mx:ControlBar>

]]>mx.containers:Box Le conteneur ControlBar permet de placer des contrôles au bas d’un conteneur Halo Panel ou Halo TitleWindow. La balise <mx:ControlBar> doit être la dernière balise enfant de la balise englobant le conteneur Halo Panel ou Halo TitleWindow.

Remarque : le conteneur Spark Panel ne prend pas en charge le conteneur ControlBar. Modifiez l’habillage du conteneur Spark Panel pour ajouter cette fonctionnalité.

Le conteneur ControlBar est un conteneur Box doté de propriétés d’arrière-plan et de style par défaut.

Le conteneur ControlBar présente les caractéristiques de taille par défaut suivantes :

mx.containers.Panel

ControlBar Constructeur. Constructeur. GridItem Le conteneur GridItem définit une cellule de grille dans un conteneur GridRow.The <mx:GridItem> tag must be a child of the <GridRow> tag, which defines a grid row. The <mx:GridItem> container inherits the tag attributes of its superclass, and adds the following tag attributes.

  <mx:Grid>
    <mx:GridRow>
      <mx:GridItem
        rowSpan="1"
        colSpan="1">
          child components
      </mx:GridItem>
      ...
    </mx:GridRow>
    ...
  </mx:Grid>

]]>mx.containers:HBox Le conteneur GridItem définit une cellule de grille dans un conteneur GridRow (le conteneur GridRow définit à son tour une ligne dans un conteneur Grid). Le conteneur GridItem peut contenir un nombre illimité d’enfants, mis en forme comme dans un conteneur HBox. Si vous ne souhaitez pas faire appel à une mise en forme HBox, créez un conteneur en tant qu’enfant du contrôle GridItem (par exemple un conteneur VBox) et placez les autres composants dans ce conteneur enfant.

Les conteneurs GridItem présentent les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Hauteur de chaque ligne et de chaque cellule Hauteur par défaut ou explicite de l’élément le plus grand de la ligne. Si un conteneur GridItem n’a pas de taille explicite, sa hauteur par défaut correspond à la hauteur par défaut ou explicite de l’enfant présent dans la cellule. Largeur de chaque colonne et de chaque cellule Largeur par défaut ou explicite de l’élément le plus large de la colonne. Si un conteneur GridItem n’a pas de largeur explicite, sa largeur par défaut correspond à la largeur par défaut ou explicite de l’enfant présent dans la cellule. Espace entre les lignes et les colonnes Déterminé par les propriétés horizontalGap et verticalGap de la classe Grid. La valeur par défaut des deux espaces est de 6 pixels. Marge par défaut 0 pixel en haut, en bas, à gauche et à droite, pour les trois classes de conteneur.

mx.containers.Gridmx.containers.GridRow

GridItem Constructeur. Constructeur. colSpan Nombre de colonnes sur lesquelles s’étend la cellule dans le conteneur Grid.1 Nombre de colonnes sur lesquelles s’étend la cellule dans le conteneur Grid. rowSpan Nombre de lignes sur lesquelles s’étend la cellule dans le conteneur Grid.1 Nombre de lignes sur lesquelles s’étend la cellule dans le conteneur Grid. Vous ne pouvez pas étendre une cellule au-delà du nombre de lignes du conteneur Grid. Panel Un conteneur Halo Panel se compose d’une barre de titre, d’une légende, d’une bordure et d’une zone de contenu permettant d’accueillir ses enfants. Spécifie l’effet à lire avant de commencer la lecture d’un effet Resize. Pour désactiver l’effet par défaut Dissolve de sorte que les enfants soient instantanément masqués, définissez la valeur de la propriété resizeStartEffect sur "none". "Dissolve" Flash 9 AIR 1.1 3.0 Flex 3 Spécifie l’effet à lire au terme de la lecture d’un effet Resize. Pour désactiver l’effet par défaut Dissolve de sorte que les enfants soient instantanément masqués, définissez la valeur de la propriété resizeEndEffect sur "none". "Dissolve" Flash 9 AIR 1.1 3.0 Flex 3 The <mx:Panel> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:Panel
   Properties
   layout="vertical|horizontal|absolute"
   status=""
   title=""
   titleIcon="null"
  
   Styles
   borderAlpha="0.4"
   borderThicknessBottom="NaN"
   borderThicknessLeft="10"
   borderThicknessRight="10"
   borderThicknessTop="2"
   controlBarStyleName="null"
   cornerRadius="4"
   dropShadowEnabled="true|false"
   footerColors="null"
   headerColors="null"
   headerHeight="Based on style of title"
   highlightAlphas="[0.3,0]"
   horizontalAlign="left|center|right"
   horizontalGap="8"
   modalTransparency="0.5"
   modalTransparencyBlur="3"
   modalTransparencyColor="#DDDDDD"
   modalTransparencyDuration="100"
   paddingBottom="0"
   paddingTop="0"
   roundedBottomCorners="false|true"
   shadowDirection="center|left|right"
   shadowDistance="2"
   statusStyleName="windowStatus"
   titleBackgroundSkin="TitleBackground"
   titleStyleName="windowStyles"
   verticalAlign="top|middle|bottom"
   verticalGap="6"
  
   Effects
   resizeEndEffect="Dissolve"
   resizeStartEffect="Dissolve"
   >
      ...
      child tags
      ...
  </mx:Panel>

]]>mx.containers.utilityClasses:IConstraintLayoutmx.core:IFontContextComponentmx.core:Container Un conteneur Halo Panel se compose d’une barre de titre, d’une légende, d’une bordure et d’une zone de contenu permettant d’accueillir ses enfants. Les conteneurs Panel sont généralement utilisés pour envelopper des modules d’application de niveau supérieur. Vous pouvez par exemple insérer un panier d’achats dans un conteneur Panel.

Remarque : lorsque cela est possible, Adobe vous recommande d’utiliser le conteneur Spark Panel plutôt que le conteneur Halo Panel.

Le conteneur Panel présente les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Taille par défaut La hauteur est suffisamment importante pour contenir tous les enfants à leur hauteur par défaut, l’espace vertical entre les enfants, les marges supérieure et inférieure, les bordures supérieure et inférieure ainsi que la barre de titre. La largeur correspond soit à la somme de la largeur par défaut de l’enfant le plus large et des marges gauche et droite du conteneur, soit à la somme de la largeur du texte de titre et de la bordure, la somme la plus grande des deux étant prise en compte. Marge 4 pixels en haut, en bas, à gauche et à droite.

spark.components.Panelmx.containers.ControlBarmx.containers.VBox

Panel Constructeur. Constructeur. getHeaderHeight Retourne la hauteur de l’en-tête.Hauteur de l’en-tête, en pixels. Retourne la hauteur de l’en-tête. measure Calcule les tailles minimale et maximale par défaut du conteneur Panel. Calcule les tailles minimale et maximale par défaut du conteneur Panel. Pour plus d’informations sur la méthode measure(), voir la méthode UIComponent.measure().

La méthode measure() appelle tout d’abord la méthode VBox.measure(), puis vérifie que les valeurs measuredWidth et measuredMinWidth sont suffisamment importantes pour permettre l’affichage du titre et du conteneur ControlBar.

mx.core.UIComponent.measure()

startDragging Appelée lorsque l’utilisateur commence à faire glisser un conteneur Panel qui a été ouvert sous forme de fenêtre contextuelle par la classe PopUpManager.event Appelée lorsque l’utilisateur commence à faire glisser un conteneur Panel qui a été ouvert sous forme de fenêtre contextuelle par la classe PopUpManager. stopDragging Appelée lorsque l’utilisateur arrête de faire glisser un conteneur Panel qui a été ouvert sous forme de fenêtre contextuelle par la classe PopUpManager. Appelée lorsque l’utilisateur arrête de faire glisser un conteneur Panel qui a été ouvert sous forme de fenêtre contextuelle par la classe PopUpManager. controlBar Référence à la barre des commandes de ce conteneur Panel, si celui-ci en possède une.mx.core:IUIComponent Référence à la barre des commandes de ce conteneur Panel, si celui-ci en possède une. statusTextField Sous-contrôle UITextField affichant l’état.mx.core:IUITextField Sous-contrôle UITextField affichant l’état. Le champ d’état est un enfant du sous-contrôle titleBar.

titleBar

titleBar Sous-contrôle TitleBar affichant la barre de titre du conteneur Panel.mx.core:UIComponent Sous-contrôle TitleBar affichant la barre de titre du conteneur Panel. titleTextField Sous-contrôle UITextField affichant le titre.mx.core:IUITextField Sous-contrôle UITextField affichant le titre. Le champ de titre est un enfant du sous-contrôle titleBar.

titleBar

closeButtonStyleFilters Jeu de styles à transmettre entre le conteneur Panel et le bouton de fermeture. Jeu de styles à transmettre entre le conteneur Panel et le bouton de fermeture.

mx.styles.StyleProxy

constraintColumns constraintRows fontContext Fabrique de modules fournissant le contexte des polices de ce composant.mx.core:IFlexModuleFactory Fabrique de modules fournissant le contexte des polices de ce composant. layout Spécifie le mécanisme de mise en forme utilisé par ce conteneur."vertical" Spécifie le mécanisme de mise en forme utilisé par ce conteneur. Les conteneurs Panel peuvent utiliser un positionnement "vertical", "horizontal" ou "absolute". Le positionnement vertical place les composants enfant verticalement, du haut du conteneur vers le bas, dans l’ordre spécifié. Le positionnement horizontal place les composants enfant horizontalement, de la gauche du conteneur vers la droite, dans l’ordre spécifié. Le positionnement absolu ne réalise pas de mise en forme automatique et vous oblige à définir explicitement la position de chaque composant enfant. status Texte de la zone d’état de la barre de titre."" Texte de la zone d’état de la barre de titre. titleIcon Icône affichée dans la barre de titre.null Icône affichée dans la barre de titre. title Titre ou légende affiché dans la barre de titre.3991 "" Obtient ou définit le titre ou la légende affiché dans la barre de titre Titre ou légende affiché dans la barre de titre. Tile Un conteneur Halo Tile place ses enfants dans une grille de cellules de même taille. Les composants conteneur spécifiques à la présentation de Flex 3 ont été remplacés par un composant Group plus générique appliquant une présentation générique. Pour que le nouveau composant Group se comporte de manière similaire, définissez la propriété layout sur TileLayout ou utilisez le conteneur TileGroup. The <mx:Tile> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:Tile
    Properties
    direction="horizontal|vertical"
    tileHeight="NaN"
    tileWidth="NaN"
 
    Sttles
    horizontalAlign="left|center|right"
    horizontalGap="8"
    paddingBottom="0"
    paddingTop="0"
    verticalAlign="top|middle|bottom"
    verticalGap="6"
    >
      ...
      child tags
     ...
  </mx:Tile>

]]>mx.core:Container Un conteneur Halo Tile place ses enfants dans une grille de cellules de même taille. Vous pouvez spécifier la taille des cellules à l’aide des propriétés tileWidth et tileHeight, ou laisser le conteneur Tile déterminer la taille des cellules, en fonction de l’enfant le plus grand. La propriété direction d’un conteneur Tile détermine si ses cellules sont mises en forme horizontalement ou verticalement, en commençant par l’angle supérieur gauche du conteneur Tile.

Remarque : lorsque cela est possible, Adobe vous recommande d’utiliser les conteneurs Spark avec la classe TileLayout plutôt que le conteneur Halo Tile.

Un conteneur Tile présente les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Direction Horizontale. Taille par défaut de toutes les cellules Hauteur par défaut ou explicite de l’élément le plus grand. Largeur par défaut ou explicite de l’élément le plus large. Toutes les cellules ont la même taille par défaut. Taille par défaut du conteneur Tile Flex calcule la racine carrée du nombre d’enfants et arrondit la valeur à l’entier le plus proche. Par exemple, s’il y a 26 enfants, la racine carrée est 5,1 et la valeur est alors arrondie à 6. Flex met ensuite en forme le conteneur Tile en utilisant une grille composée de six lignes et six colonnes. La hauteur par défaut du conteneur Tile est égale au produit (hauteur par défaut des cellules Tile) x (arrondi de la racine carrée du nombre d’enfants), auquel viennent s’ajouter les éventuels espaces entre les enfants et les marges. La largeur par défaut est égale au produit (largeur par défaut des cellules Tile) x (arrondi de la racine carrée du nombre d’enfants), auquel viennent s’ajouter les éventuels espaces entre les enfants et les marges. Taille minimale du conteneur Tile Taille par défaut d’une cellule. Flex attribue suffisamment d’espace pour afficher au moins une cellule. Marge par défaut 0 pixel en haut, en bas, à gauche et à droite.

mx.components.Container

Tile Constructeur. Constructeur. measure Calcule les tailles minimale et maximale par défaut du conteneur Tile. Calcule les tailles minimale et maximale par défaut du conteneur Tile. Pour plus d’informations sur la méthode measure(), voir la méthode UIComponent.measure().

Cette méthode commence par calculer la taille de chaque cellule Tile. Pour comprendre comment la taille des cellules est déterminée, voir les propriétés tileWidth et tileHeight.

La taille mesurée d’un conteneur Tile contenant des enfants est suffisante pour afficher les cellules dans une grille N par N contenant autant de lignes que de colonnes, ainsi que les marges et les bordures du conteneur Tile. Il existe cependant des cas particuliers, comme dans les exemples suivants :

Si une largeur explicite est définie pour un conteneur Tile horizontal, cette valeur détermine le nombre horizontal de cellules. En outre, la hauteur requise pour contenir tous les enfants est calculée, afin d’obtenir une grille M par N.
Si une hauteur explicite est définie pour un conteneur Tile vertical, cette valeur détermine le nombre vertical de cellules. En outre, la hauteur requise pour contenir tous les enfants est calculée, afin d’obtenir une grille N par M.

En l’absence d’enfant, la taille mesurée correspond à la taille la plus petite permettant de contenir les marges et les bordures.

La taille minimale mesurée d’un conteneur Tile contenant des enfants correspond à la taille la plus petite permettant de contenir une cellule Tile, les marges et les bordures. En l’absence d’enfant, la taille mesurée minimale correspond à la taille la plus petite permettant de contenir les marges et les bordures.

mx.core.UIComponent.measure()

updateDisplayList Définit la position et la taille des enfants de ce conteneur.unscaledWidthSpécifie la largeur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleX de ce composant. unscaledHeightSpécifie la hauteur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleY de ce composant. Définit la position et la taille des enfants de ce conteneur. Pour plus d’informations sur la méthode updateDisplayList(), voir la méthode UIComponent.updateDisplayList().

Cette méthode place les enfants dans une grille de type damier contenant des cellules de même taille, au sein de la zone de contenu du conteneur Tile (zone située entre les marges). Pour comprendre comment la taille des cellules est déterminée, voir les propriétés tileWidth et tileHeight.

La séparation entre les cellules est déterminée par les styles horizontalGap et verticalGap. La position de chaque enfant au sein de sa cellule est déterminée par les styles horizontalAlign et verticalAlign.

L’enchaînement des enfants est déterminé par la propriété direction. La première cellule est toujours placée dans le coin supérieur gauche de la zone de contenu. Si la valeur de la propriété direction est "horizontal", les cellules sont placées de gauche à droite dans la ligne qui se trouve le plus en haut, puis de gauche à droite dans la deuxième ligne, et ainsi de suite. Si la valeur de la propriété direction est "vertical", les cellules sont placées de haut en bas dans la colonne qui se trouve le plus à gauche, puis de haut en bas dans la deuxième colonne, et ainsi de suite.

Si une valeur percentWidth ou percentHeight est définie pour un enfant, celui-ci est redimensionné dans cette direction pour occuper le pourcentage spécifié de sa cellule Tile.

mx.core.UIComponent.updateDisplayList()

direction Détermine la manière dont les enfants sont placés dans le conteneur."horizontal" Détermine la manière dont les enfants sont placés dans le conteneur. Valeurs MXML possibles : "horizontal" et "vertical". En langage ActionScript, vous pouvez définir la direction à l’aide des valeurs TileDirection.HORIZONTAL ou TileDirection.VERTICAL. La valeur par défaut est "horizontal" (si le conteneur est un conteneur Legend, qui est une sous-classe de Tile, la valeur par défaut est "vertical").

Le premier enfant est toujours placé dans le coin supérieur gauche du conteneur Tile. Si la valeur de la propriété direction est "horizontal", les enfants sont placés de gauche à droite dans la ligne qui se trouve le plus en haut, puis de gauche à droite dans la deuxième ligne, et ainsi de suite. Si la valeur de la propriété direction est "vertical", les enfants sont placés de haut en bas dans la colonne qui se trouve le plus à gauche, puis de haut en bas dans la deuxième colonne, et ainsi de suite.

TileDirection

tileHeight Hauteur de chaque cellule Tile, en pixels.NaN Hauteur de chaque cellule Tile, en pixels. Si la valeur de cette propriété est NaN (valeur par défaut), la hauteur de chaque cellule dépend de la hauteur de l’enfant le plus grand. Si vous définissez cette propriété, la valeur spécifiée remplace ce calcul. tileWidth Largeur de chaque cellule Tile, en pixels.NaN Largeur de chaque cellule Tile, en pixels. Si la valeur de cette propriété est NaN (valeur par défaut), la largeur de chaque cellule dépend de la largeur de l’enfant le plus large. Si vous définissez cette propriété, la valeur spécifiée remplace ce calcul. VDividedBox Le conteneur VDividedBox place ses enfants verticalement, de la même manière qu’un conteneur VBox, mais un séparateur déplaçable est inséré entre les enfants.The <mx:VDividedBox> tag inherits all of the tag attributes of its superclass, except direction, and adds no new tag attributes.

]]>mx.containers:DividedBox Le conteneur VDividedBox place ses enfants verticalement, de la même manière qu’un conteneur VBox, mais un séparateur déplaçable est inséré entre les enfants. Les utilisateurs peuvent faire glisser le séparateur pour redimensionner la zone allouée à chaque enfant. La balise <mx:VDividedBox/> est identique à <mx:DividedBox direction="vertical"/>.

Un conteneur VDividedBox présente les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Taille par défaut La hauteur est suffisante pour contenir tous les enfants à leur hauteur par défaut ou explicite, l’espace vertical entre les enfants, ainsi que les marges supérieure et inférieure du conteneur. La largeur correspond à somme de la largeur par défaut ou explicite de l’enfant le plus large et des marges gauche et droite du conteneur. Marge par défaut 0 pixel en haut, en bas, à gauche et à droite. Espace par défaut 10 pixels pour les espaces horizontal et vertical.

mx.containers.DividedBoxmx.containers.HDividedBox

VDividedBox Constructeur. Constructeur. BoxDirection La classe BoxDirection définit les valeurs de constante de la propriété direction du conteneur Box.Object La classe BoxDirection définit les valeurs de constante de la propriété direction du conteneur Box.

mx.containers.Box

HORIZONTAL Indique que les enfants du conteneur Box doivent être placés horizontalement.horizontal Indique que les enfants du conteneur Box doivent être placés horizontalement. VERTICAL Indique que les enfants du conteneur Box doivent être placés verticalement.vertical Indique que les enfants du conteneur Box doivent être placés verticalement. Form Le conteneur Form permet de définir la mise en forme d’un formulaire, de marquer des champs de formulaire comme étant obligatoires ou facultatifs, de traiter les messages d’erreur et de lier vos données de formulaire au modèle de données Flex, afin de vérifier et de valider les données.The <mx:Form> tag inherits all the tag attributes of its superclass and adds the following tag attributes:

  <mx:Form
    Styles
    horizontalGap="8"
    indicatorGap="14"
    labelWidth="Calculated"
    paddingBottom="16"
    paddingTop="16"
    verticalGap="6"
    >
    ...
      child tags
    ...
  </mx:Form>

]]>mx.core:Container Le conteneur Form permet de définir la mise en forme d’un formulaire, de marquer des champs de formulaire comme étant obligatoires ou facultatifs, de traiter les messages d’erreur et de lier vos données de formulaire au modèle de données Flex, afin de vérifier et de valider les données. Il vous permet également d’utiliser des feuilles de style pour configurer l’apparence de vos formulaires.

Le tableau ci-dessous décrit les composants à utiliser pour créer des formulaires dans Flex :

ComposantBaliseDescription Form <mx:Form> Définit le conteneur du formulaire dans son ensemble, y compris la mise en forme globale du formulaire. Utilisez le contrôle FormHeading et le conteneur FormItem pour définir le contenu. Vous pouvez également insérer d’autres types de composants dans un conteneur Form. FormHeading <mx:FormHeading> Définit un titre dans votre formulaire. Vous pouvez insérer plusieurs contrôles FormHeading dans un même conteneur Form. FormItem <mx:FormItem> Contient un ou plusieurs enfants de formulaire, disposés horizontalement ou verticalement. Les enfants peuvent être des contrôles ou d’autres conteneurs. Un même conteneur Form peut contenir plusieurs conteneurs FormItem.

mx.containers.FormHeadingmx.containers.FormItem

Form Constructeur. Constructeur. measure Calcule les tailles recommandée, minimale et maximale du conteneur Form. Calcule les tailles recommandée, minimale et maximale du conteneur Form. Pour plus d’informations sur la méthode measure, voir la méthode UIComponent.measure().

La méthode Form.measure() définit la propriété measuredWidth de sorte qu’elle corresponde à la somme de la largeur de l’enfant le plus large, des valeurs des propriétés de style paddingLeft et paddingRight et de la largeur de la bordure.

La valeur de la propriété measuredHeight correspond à la somme des valeurs measuredHeight de tous les enfants et des espaces verticalGap entre chaque enfant. Les valeurs des propriétés de style paddingTop et paddingBottom et la hauteur de la bordure sont également ajoutées.

La valeur de la propriété measuredMinWidth correspond à la largeur minimale la plus grande des enfants. Si une valeur en pourcentage est définie pour la propriété width de l’enfant, la propriété minWidth est utilisée. Dans le cas contraire, la propriété measuredWidth est utilisée. Les valeurs des propriétés de style paddingLeft et paddingRight et la largeur de la bordure sont également ajoutées.

La valeur de la propriété measuredMinHeight correspond à la valeur de la propriété measuredHeight.

updateDisplayList Réagit aux changements de taille en définissant la taille et la position des enfants de ce conteneur.unscaledWidthSpécifie la largeur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleX de ce composant. unscaledHeightSpécifie la hauteur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleY de ce composant. Réagit aux changements de taille en définissant la taille et la position des enfants de ce conteneur. Pour plus d’informations sur la méthode updateDisplayList(), voir la méthode UIComponent.updateDisplayList().

La méthode Form.updateDisplayList() place les enfants dans une colonne verticale, en les séparant par un espace correspondant à la valeur de la propriété de style verticalGap. Les propriétés de style paddingLeft, paddingRight, paddingTop et paddingBottom sont appliquées.

Si la largeur d’un enfant est définie en pourcentage, il est élargi horizontalement de sorte qu’il corresponde au pourcentage spécifié pour le conteneur Form. Dans le cas contraire, sa largeur correspond à la valeur de la propriété measuredWidth. La hauteur de chaque enfant correspond à la valeur de sa propriété measuredHeight.

Cette méthode appelle la méthode super.updateDisplayList() avant toute autre opération.

maxLabelWidth Largeur maximale des libellés des conteneurs FormItem de ce conteneur Form, en pixels. Largeur maximale des libellés des conteneurs FormItem de ce conteneur Form, en pixels. ViewStack Un conteneur de navigateur MX ViewStack se compose d’une collection de conteneurs enfant empilés les uns sur les autres, mais un seul d’entre eux est visible à la fois.The <mx:ViewStack> tag inherits the tag attributes of its superclass, with the exception of scrolling-related attributes, and adds the following tag attributes:

  <mx:ViewStack
    Properties
    historyManagementEnabled="false|true"
    resizeToContent="false|true"
    selectedIndex="0"
    
    Styles
    horizontalGap="8"
    paddingBottom="0"
    paddingTop="0"
    verticalGap="6"
    
    Events
    change="No default"
    >
      ...
      child tags
      ...
  </mx:ViewStack>

]]>mx.managers:IHistoryManagerClientmx.core:ISelectableListmx.core:Container Un conteneur de navigateur MX ViewStack se compose d’une collection de conteneurs enfant empilés les uns sur les autres, mais un seul d’entre eux est visible à la fois. Lorsqu’un autre conteneur enfant est sélectionné, il semble remplacer l’ancien conteneur, car il s’affiche au même endroit. Cependant, l’ancien conteneur existe toujours : il est simplement devenu invisible.

Un conteneur ViewStack ne fournit pas d’interface utilisateur permettant de sélectionner le conteneur enfant actuellement visible. En général, vous définissez la propriété selectedIndex ou selectedChild en langage ActionScript en réponse à une action de l’utilisateur. Vous pouvez également associer un contrôle MX LinkBar, TabBar, ButtonBar, ToggleButtonBar ou Spark ButtonBar à un conteneur ViewStack pour fournir une interface de navigation. Pour ce faire, spécifiez le conteneur ViewStack comme valeur de la propriété dataProvider du conteneur LinkBar, TabBar ou ToggleButtonBar.

Vous pouvez décider d’utiliser un conteneur de navigateur plus complexe que le conteneur ViewStack, par exemple un conteneur TabNavigator ou Accordion. Outre le fait qu’ils contiennent une collection de conteneurs enfant, ces conteneurs fournissent leurs propres contrôles d’interface utilisateur permettant d’accéder à leurs différents enfants.

Lorsque le conteneur enfant actuellement visible change, vous pouvez utiliser la propriété hideEffect du conteneur masqué et la propriété showEffect du conteneur enfant devenu visible pour appliquer un effet aux conteneurs enfant. Le conteneur ViewStack attend que l’effet hideEffect du conteneur enfant masqué soit terminé avant de faire apparaître le nouveau conteneur enfant. Vous pouvez interrompre un effet en cours en modifiant la propriété selectedIndex du conteneur ViewStack pendant la lecture d’un effet.

Le conteneur ViewStack présente les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Taille par défaut Largeur et hauteur de l’enfant initialement actif. Règles de redimensionnement de conteneur Par défaut, la taille des conteneurs ViewStack est déterminée une seule fois, en fonction de la taille du premier conteneur enfant. Ils ne sont pas redimensionnés lorsque vous accédez à d’autres conteneurs enfant. Pour forcer un redimensionnement des conteneurs ViewStack lorsque vous accédez à un autre conteneur enfant, définissez la propriété resizeToContent sur true. Règles de définition de la taille des enfants La taille des enfants est définie sur leur taille par défaut. Si l’enfant est plus grand que le conteneur ViewStack, il est écrêté. Si l’enfant est plus petit que le conteneur ViewStack, il est placé dans l’angle supérieur gauche de ce conteneur. Marge par défaut 0 pixel en haut, en bas, à gauche et à droite.

mx.controls.LinkBarmx.controls.ButtonBarmx.controls.TabBarmx.controls.ToggleButtonBarspark.components.ButtonBarmx.managers.HistoryManagermx.managers.LayoutManager

change Distribué lorsque le conteneur enfant sélectionné change.mx.events.IndexChangedEvent.CHANGEmx.events.IndexChangedEvent Distribué lorsque le conteneur enfant sélectionné change. ViewStack Constructeur. Constructeur. commitSelectedIndex Valide l’index sélectionné.newIndex Valide l’index sélectionné. Cette fonction est appelée au cours de la phase de validation des propriétés lorsque la propriété selectedIndex (ou selectedItem) a changé. loadState stateEtat de l’objet à charger. La valeur est null lors du chargement de l’état initial de l’application. measure Calcule les tailles par défaut ainsi que les valeurs minimale et maximale du conteneur ViewStack. Calcule les tailles par défaut ainsi que les valeurs minimale et maximale du conteneur ViewStack. Pour plus d’informations sur la méthode measure(), voir la méthode UIComponent.measure().

La taille par défaut d’un conteneur ViewStack correspond à la taille par défaut de son enfant actuellement sélectionné, à laquelle viennent s’ajouter les marges et les bordures. Si le conteneur ViewStack ne contient pas d’enfant, sa taille par défaut correspond à la taille la plus petite permettant de contenir les marges et les bordures.

La taille minimale d’un conteneur ViewStack correspond à la taille minimale de son enfant actuellement sélectionné, à laquelle viennent s’ajouter les marges et les bordures. Si le conteneur ViewStack ne contient pas d’enfant, sa taille minimale correspond à la taille la plus petite permettant de contenir les marges et les bordures.

Cette méthode ne modifie pas la taille maximale d’un conteneur ViewStack : celle-ci reste illimitée.

mx.core.UIComponent.measure()

saveState Etat de cet objet. updateDisplayList Réagit aux changements de taille en définissant la taille et la position des enfants de ce conteneur.unscaledWidthSpécifie la largeur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleX de ce composant. unscaledHeightSpécifie la hauteur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleY de ce composant. Réagit aux changements de taille en définissant la taille et la position des enfants de ce conteneur. Pour plus d’informations sur la méthode updateDisplayList(), voir la méthode UIComponent.updateDisplayList().

Un seul des enfants est visible à la fois. Par conséquent, un conteneur ViewStack définit uniquement la taille et la position de cet enfant.

L’enfant sélectionné est placé dans l’angle supérieur gauche du conteneur ViewStack, de façon à ce que les marges et les bordures du conteneur puissent être affichées.

Si une valeur width ou height est définie en pourcentage pour un enfant, celui-ci est redimensionné dans cette direction pour occuper le pourcentage spécifié de la zone de contenu du conteneur ViewStack (c’est-à-dire la zone qui se trouve entre les marges).

mx.core.UIComponent.updateDisplayList()

contentHeight Hauteur de la zone dans laquelle le contenu est affiché, en pixels. Hauteur de la zone dans laquelle le contenu est affiché, en pixels. Vous pouvez remplacer cet accesseur de lecture si votre contenu n’occupe pas l’intégralité de la zone du conteneur ViewStack. contentWidth Largeur de la zone dans laquelle le contenu est affiché, en pixels. Largeur de la zone dans laquelle le contenu est affiché, en pixels. Vous pouvez remplacer cet accesseur de lecture si votre contenu n’occupe pas l’intégralité de la zone du conteneur ViewStack. contentX Coordonnée x de la zone du conteneur ViewStack dans laquelle s’affiche le contenu, en pixels. Coordonnée x de la zone du conteneur ViewStack dans laquelle s’affiche le contenu, en pixels. La valeur par défaut est égale à la valeur de la propriété de style paddingLeft, dont la valeur par défaut est 0. Remplacez la méthode get() si vous ne souhaitez pas que la mise en forme du contenu commence à la coordonnée x = 0. contentY Coordonnée y de la zone du conteneur ViewStack dans laquelle s’affiche le contenu, en pixels. Coordonnée y de la zone du conteneur ViewStack dans laquelle s’affiche le contenu, en pixels. La valeur par défaut est égale à la valeur de la propriété de style paddingTop, dont la valeur par défaut est 0. Remplacez la méthode get() si vous ne souhaitez pas que la mise en forme du contenu commence à la coordonnée y = 0. historyManagementEnabled Si la valeur est true, la gestion d’historique est activée dans ce conteneur ViewStack.false Si la valeur est true, la gestion d’historique est activée dans ce conteneur ViewStack. Lorsque l’utilisateur accède aux différents enfants, le navigateur mémorise les enfants visités. L’utilisateur peut cliquer ensuite sur les boutons Précédent et Suivant pour parcourir l’historique de navigation.

mx.managers.HistoryManager

resizeToContent Si la valeur est true, le conteneur ViewStack est redimensionné automatiquement, en fonction de la taille de son enfant actuel.false Si la valeur est true, le conteneur ViewStack est redimensionné automatiquement, en fonction de la taille de son enfant actuel. selectedChild Référence au conteneur enfant actuellement visible.mx.core:INavigatorContent Référence au conteneur enfant actuellement visible. La valeur par défaut est une référence au premier enfant. En l’absence d’enfant, la valeur de cette propriété est null.

Remarque : vous pouvez définir cette propriété uniquement dans une instruction ActionScript, pas dans du code MXML.

selectedIndex Index de base zéro du conteneur de l’enfant actuellement visible. Index de base zéro du conteneur de l’enfant actuellement visible. Les index des enfants utilisent la plage de valeurs 0, 1, 2, ..., n - 1, où n correspond au nombre d’enfants. La valeur par défaut est 0, ce qui correspond au premier enfant. En l’absence d’enfant, la valeur de cette propriété est -1.

Remarque : lorsque vous ajoutez un nouvel enfant à un conteneur ViewStack, la propriété selectedIndex est ajustée automatiquement si cela est nécessaire, de sorte que l’enfant sélectionné reste sélectionné.

GridRow Le conteneur GridRow définit une ligne dans un conteneur Grid et contient des conteneurs GridCell.The <mx:GridRow> must be a child of the <mx:Grid> tag, and has one or more child <mx:GridItem> tags that define the grid cells.

The <mx:GridRow> container inherits the tag attributes of its superclass, and adds the following tag attributes:

  <mx:Grid>
    <mx:GridRow
    Styles
      horizontalAlign="left|center|right"
      verticalAlign="top|middle|bottom"
    >
      <mx:GridItem
        child components
      </mx:GridItem>
      ...
    </mx:GridRow>
    ...
  </mx:Grid>

]]>mx.containers:HBox Le conteneur GridRow définit une ligne dans un conteneur Grid et contient des conteneurs GridCell.

Les conteneurs GridRow présentent les caractéristiques de taille par défaut suivantes :

mx.containers.Gridmx.containers.GridItem

GridRow Constructeur. Constructeur. updateDisplayList Définit la taille et la position de chaque enfant du conteneur GridRow.unscaledWidthSpécifie la largeur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleX de ce composant. unscaledHeightSpécifie la hauteur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleY de ce composant. Définit la taille et la position de chaque enfant du conteneur GridRow. Pour plus d’informations sur l’algorithme de mise en forme Grid, voir la méthode Grid.updateDisplayList().

Vous ne devez pas appeler cette méthode directement. La classe LayoutManager de Flex l’appelle lorsque cela est nécessaire. Au démarrage de l’application, la classe LayoutManager de Flex appelle la méthode updateDisplayList() sur chaque composant, en commençant par la racine et en progressant vers le bas.

FormItem Le conteneur FormItem définit un libellé et un ou plusieurs enfants, disposés horizontalement ou verticalement.The <mx:FormItem> tag inherits all of the tag attributes of its superclass, except paddingLeft, and adds the following tag attributes:

  <mx:FormItem
    Properties
    direction="vertical|horizontal"
    label=""
    required="false|true"
  
    Styles
    horizontalAlign="left|center|right"
    horizontalGap="8"
    indicatorGap="14"
    indicatorSkin="'mx.containers.FormItem.Required' symbol in Assets.swf"
    labelStyleName=""
    labelWidth="Calculated"
    paddingBottom="0"
    paddingRight="0"
    paddingTop="0"
    verticalGap="6"
    >
    ...
      child tags
    ...
  </mx:FormItem>

]]>mx.core:Container Le conteneur FormItem définit un libellé et un ou plusieurs enfants, disposés horizontalement ou verticalement. Les enfants peuvent être des contrôles ou d’autres conteneurs. Un même conteneur Form peut contenir plusieurs conteneurs FormItem.

mx.containers.Formmx.containers.FormItemDirectionmx.containers.FormHeadingmx.controls.FormItemLabel

FormItem Constructeur. Constructeur. measure Calcule les tailles recommandée, minimale et maximale du conteneur FormItem. Calcule les tailles recommandée, minimale et maximale du conteneur FormItem. Pour plus d’informations sur la méthode measure(), voir la méthode UIComponent.measure().

La méthode FormItem.measure() commence par déterminer le nombre de colonnes à utiliser. Si la valeur de la propriété direction est FormItemDirection.HORIZONTAL, tous les contrôles sont placés dans une même ligne, si cela est possible. S’il est impossible de placer les contrôles dans une seule ligne, ils sont répartis sur deux colonnes. Si cela ne fonctionne pas, utilisez une seule colonne. Si la valeur de la propriété direction est FormItemDirection.VERTICAL, les contrôles sont placés dans une même colonne (comme avec le conteneur VBox).

Un conteneur FormItem contient deux zones : la zone de libellé et la zone des contrôles. La taille du libellé est toujours la même, quelle que soit la direction des contrôles. La taille de la zone des contrôles dépend du nombre de lignes et de colonnes utilisées.

La largeur du libellé dépend de la propriété de style labelWidth. Si la valeur de cette propriété est undefined (valeur par défaut), la largeur du libellé le plus grand du conteneur Form parent est utilisée.

Si tous les éléments se trouvent sur une même ligne, la largeur de la zone des contrôles correspond à la somme des largeurs de tous les enfants et des espaces horizontalGap qui les séparent.

Si tous les éléments se trouvent sur une même colonne, la largeur de la zone des contrôles correspond à la largeur de l’enfant le plus large.

Si les enfants sont placés dans plusieurs lignes et plusieurs colonnes, la largeur de colonne correspond à la largeur de l’élément le plus large et la largeur de la zone des contrôles correspond au produit de la largeur de colonne et du nombre de colonnes, auquel s’ajoute l’espace horizontalGap séparant chaque colonne.

La propriété measuredWidth correspond à la somme de la largeur de la zone de libellé, de la largeur de la zone des contrôles et de la valeur de la propriété de style indicatorGap. Les valeurs des propriétés de style paddingLeft et paddingRight et la largeur de la bordure sont également ajoutées.

La valeur de la propriété measuredHeight correspond à la somme des hauteurs recommandées de toutes les lignes des enfants et de l’espace verticalGap séparant chaque enfant. Les valeurs des propriétés de style paddingTop et paddingBottom et la hauteur de la bordure sont également ajoutées.

La propriété measuredMinWidth correspond à la somme de la largeur de la zone de libellé, de la largeur minimale de la zone des contrôles et de la valeur de la propriété de style indicatorGap. Les valeurs des propriétés de style paddingLeft et paddingRight et la largeur de la bordure sont également ajoutées.

La valeur de la propriété measuredMinHeight correspond à la somme des hauteurs minimales de toutes les lignes des enfants et de l’espace verticalGap séparant chaque enfant. Les valeurs des propriétés de style paddingTop et paddingBottom et la hauteur de la bordure sont également ajoutées.

Pour plus d’informations sur la manière dont sont placés les contrôles FormItem, voir la méthode FormItem.measure().

Le libellé est aligné dans la zone de libellé en fonction de la propriété de style textAlign. Tous les libellés d’un formulaire sont alignés les uns avec les autres.

Si la valeur de la propriété required est true, un symbole indiquant que le champ est obligatoire est placé entre le libellé et les contrôles.

Les contrôles sont placés dans des colonnes, comme expliqué dans la documentation de la méthode measure(). La propriété de style horizontalAlign définit où sont placés les contrôles dans le sens horizontal.

Lorsque la valeur de la propriété direction est "vertical", tous les enfants pour lesquels aucune valeur width n’est spécifiée utilisent la valeur measuredWidth, arrondie au quart le plus proche de la largeur de la zone des contrôles. Cela évite d’obtenir des bords de contrôles irréguliers.

Cette méthode appelle la méthode super.updateDisplayList() avant toute autre opération.

direction Direction des sous-composants du conteneur FormItem.FormItemDirection.VERTICAL Direction des sous-composants du conteneur FormItem. Valeurs MXML possibles : "vertical" ou "horizontal". La valeur par défaut est "vertical". Valeurs ActionScript possibles : FormItemDirection.VERTICAL ou FormItemDirection.HORIZONTAL.

Si la valeur de la propriété direction est "vertical", les enfants du conteneur FormItem sont empilés verticalement à droite du libellé FormItem. Si la valeur de la propriété direction est "horizontal", les enfants sont placés dans une même ligne (si possible) ou dans deux colonnes de même taille.

Si vous souhaitez contrôler de manière plus précise la mise en forme des enfants FormItem, vous pouvez utiliser un conteneur tel que Grid ou Tile comme enfant direct du conteneur FormItem, afin d’y placer les contrôles souhaités.

mx.containers.FormItemDirection

itemLabel Référence en lecture seule au sous-composant FormItemLabel affichant le libellé du conteneur FormItem.mx.controls:Label Référence en lecture seule au sous-composant FormItemLabel affichant le libellé du conteneur FormItem. label Libellé de texte du conteneur FormItem."" Libellé de texte du conteneur FormItem. Ce libellé s’affiche à gauche des composants enfant de l’élément de formulaire. La position du libellé dépend de la propriété de style textAlign. required Si la valeur est true, un indicateur est affiché pour indiquer que l’utilisateur doit saisir une information dans l’enfant FormItem.false Si la valeur est true, un indicateur est affiché pour indiquer que l’utilisateur doit saisir une information dans l’enfant FormItem. Si la valeur est false, aucun indicateur ne s’affiche.

Cette propriété contrôle uniquement l’affichage de l’indicateur. Vous devez joindre un validateur aux enfants si vous souhaitez que la saisie soit validée.

Box Un conteneur Halo Box place ses enfants dans une seule colonne verticale ou dans une seule ligne horizontale. The <mx:Box> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:Box
    Properties
    direction="vertical|horizontal"
    Styles
    horizontalAlign="left|center|right"
    horizontalGap="8"
    paddingBottom="0"
    paddingTop="0"
    verticalAlign="top|middle|bottom"
    verticalGap="6"
    >
    ...
      child tags
    ...
  </mx:Box>

]]>mx.core:Container Un conteneur Halo Box place ses enfants dans une seule colonne verticale ou dans une seule ligne horizontale. La propriété direction définit si la mise en forme doit être verticale (par défaut) ou horizontale.

Remarque : lorsque cela est possible, Adobe vous recommande d’utiliser les conteneurs Spark avec la classe HorizontalLayout ou VerticalLayout plutôt que le conteneur Halo Box.

La classe Box est la classe de base des classes VBox et HBox. Utilisez les balises <mx:Box>, <mx:VBox> et <mx:HBox> pour définir des conteneurs Box.

Un conteneur Box présente les caractéristiques de taille par défaut suivantes :

CaractéristiqueDescription Taille par défaut Vertical Box La hauteur est suffisamment importante pour contenir tous les enfants à leur hauteur par défaut ou explicite, l’espace vertical entre les enfants, ainsi que les marges supérieure et inférieure du conteneur. La largeur correspond à somme de la largeur par défaut ou explicite de l’enfant le plus large et des marges gauche et droite du conteneur. Horizontal Box La largeur est suffisamment importante pour contenir tous les enfants à leur largeur par défaut, l’espace horizontal entre les enfants, ainsi que les marges gauche et droite du conteneur. La hauteur correspond à somme de la hauteur par défaut ou explicite de l’enfant le plus grand et des marges supérieure et inférieure du conteneur. Marge par défaut 0 pixel en haut, en bas, à gauche et à droite.

mx.components.Containermx.containers.HBoxmx.containers.VBox

Box Constructeur. Constructeur. measure Calcule les tailles par défaut ainsi que les valeurs minimale et maximale du conteneur Box. Calcule les tailles par défaut ainsi que les valeurs minimale et maximale du conteneur Box.

Si la propriété direction du conteneur Box est définie sur BoxDirection.HORIZONTAL, la valeur de sa propriété measuredWidth est égale à la somme des largeurs par défaut de tous ses enfants, des épaisseurs des bordures, des marges gauche et droite et de l’espace horizontal entre les enfants. La valeur de la propriété measuredHeight correspond à la valeur la plus élevée parmi les hauteurs par défaut des enfants, à laquelle viennent s’ajouter les bordures et les marges. Si la propriété direction du conteneur Box est définie sur BoxDirection.VERTICAL, ces deux valeurs sont inversées.

Les propriétés minWidth et minHeight du conteneur Box sont calculées de la même manière, mais en combinant les largeurs minimales et les hauteurs minimales des enfants. Si la propriété width de l’enfant est une valeur exprimée en pourcentage, la largeur minimale du conteneur Box est égale à la valeur de la propriété minWidth de l’enfant. Si la propriété width de l’enfant n’est pas définie ou que sa valeur est fixe, l’enfant n’est ni agrandi, ni réduit, et la largeur minimale du conteneur Box est donc égale à la valeur de la propriété explicitWidth de l’enfant. La hauteur minimale de l’enfant est calculée de la même manière.

Les propriétés maxWidth et maxHeight du conteneur Box ne sont pas calculées. La largeur et la hauteur du conteneur Box sont supposées être illimitées.

Toutes les valeurs décrites précédemment correspondent aux largeurs et hauteurs mesurées du conteneur Box. L’utilisateur peut remplacer les valeurs mesurées en spécifiant explicitement une valeur pour les propriétés suivantes :

width
height
minWidth
minHeight
maxWidth
maxHeight

Vous ne devez pas appeler la méthode measure() directement. La classe LayoutManager de Flex l’appelle lorsque cela est nécessaire. Au démarrage de l’application, la classe LayoutManager de Flex essaie de mesurer tous les composants, enfant comme parent, avant de définir leur taille finale.

measuredMinWidth
measuredMinHeight

Ces propriétés correspondent aux propriétés de mise en forme mentionnées précédemment. Elles ne font donc pas l’objet d’une documentation séparée.

pixelsToPercent Méthode utilisée pour convertir un nombre de pixels en pourcentage, par rapport au contenu de ce conteneur.Pourcentage équivalent à la valeur pxl dans les conditions de mise en forme actuelles de ce conteneur. Une valeur négative indique que le conteneur doit être agrandi pour correspondre à la taille demandée. pxlNombre de pixels à convertir en pourcentage. Méthode utilisée pour convertir un nombre de pixels en pourcentage, par rapport au contenu de ce conteneur.

La valeur de pourcentage est exacte uniquement tant que la taille ou la mise en forme du conteneur ne change pas. Dès que le conteneur est redimensionné ou que sa mise en forme change, la valeur retournée par cette méthode risque d’être obsolète.

Cette méthode peut par exemple être utilisée pour restaurer la taille d’un composant sur un nombre précis de pixels après l’avoir masqué.

updateDisplayList Définit la taille et la position de chaque enfant du conteneur Box.unscaledWidthSpécifie la largeur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleX de ce composant. unscaledHeightSpécifie la hauteur du composant (en pixels) dans les coordonnées du composant, quelle que soit la valeur de la propriété scaleY de ce composant. Définit la taille et la position de chaque enfant du conteneur Box.

Pour comprendre l’algorithme de mise en forme du conteneur Box, supposons que la direction du conteneur Box soit horizontale.

Tous les enfants du conteneur Box sont placés côte à côte sur une même ligne horizontale, séparés par un espace défini par le nombre de pixels de la propriété horizontalGap. Au départ, les largeurs des enfants pour lesquels aucune valeur de largeur explicite n’est définie correspondent aux valeurs de leurs propriétés measuredWidth.

Si la somme des valeurs des propriétés measuredWidth des enfants est supérieure ou inférieure à la largeur du conteneur Box et que la propriété width de certains enfants est définie en pourcentage, ces enfants sont agrandis ou réduits jusqu’à ce que tous les enfants puissent être affichés dans le conteneur Box. Cependant, aucun enfant n’est réduit au point que sa largeur devienne inférieure à la valeur de sa propriété minWidth, ni agrandi au point que sa largeur devienne supérieure à la valeur de sa propriété maxWidth. Un espace supplémentaire est ajouté (ou retiré) proportionnellement à la valeur percentWidth de l’enfant et réparti entre tous les enfants agrandis (ou réduits). Par exemple, si la valeur percentWidth d’un enfant est de 40 %, sa taille est agrandie deux fois plus qu’un enfant dont la valeur de la propriété percentWidth est 20 %, et ce, jusqu’à ce que l’ensemble de l’espace disponible soit occupé ou que les tailles recommandées soient atteintes.

Une fois que tous les enfants dont la taille est flexible ont été agrandis ou réduits, Flex vérifie que la somme des largeurs des enfants correspond à la largeur du conteneur Box. Si cela n’est pas le cas, les enfants sont tous décalés en fonction de la valeur de la propriété horizontalAlign du conteneur Box, de sorte que les enfants soient alignés sur le bord gauche ou droit du conteneur Box, ou centrés au milieu de ce conteneur.

Pour déterminer la hauteur de chaque enfant, Flex examine la valeur de la propriété height de l’enfant. Si la propriété height n’est pas définie, la hauteur de l’enfant correspond à la valeur de sa propriété measuredHeight. Si la valeur height est définie en pixels, cette valeur est utilisée. Si la propriété height est définie en pourcentage, la hauteur de l’enfant est agrandie ou réduite de sorte qu’elle corresponde au pourcentage spécifié pour la hauteur du conteneur, sans pour autant réduire la hauteur de l’enfant au point qu’elle devienne inférieure à la valeur de sa propriété minHeight, ni l’agrandir au point de dépasser la valeur de sa propriété maxHeight.

La position verticale de chaque enfant est déterminée par la propriété verticalAlign du conteneur Box. Chaque enfant est décalé de manière à être aligné sur le bord supérieur ou inférieur du conteneur Box, ou à être centré dans le conteneur Box.

Si la valeur de la propriété direction du conteneur Box est vertical, les mêmes règles s’appliquent, à ceci près que les largeurs et les hauteurs sont inversées. Les enfants sont placés dans une même colonne verticale.

Vous ne devez pas appeler cette méthode directement. La classe LayoutManager de Flex l’appelle lorsque cela est nécessaire. Au démarrage de l’application, la classe LayoutManager de Flex appelle la méthode updateDisplayList() sur chaque composant, en commençant par l’objet Application et en progressant vers le bas.

Il s’agit d’une méthode avancée à utiliser avec des sous-classes. Si vous remplacez cette méthode, l’implémentation doit appeler la méthode super.updateDisplayList() et appeler les méthodes move() et setActualSize() sur chaque enfant. Pour les besoins de la mise en forme, vous devez obtenir la taille de ce conteneur à partir des propriétés unscaledWidth et unscaledHeight, et non à partir des propriétés width et height. Les propriétés width et height ne prennent pas en compte les valeurs des propriétés scaleX et scaleY de ce conteneur.

direction Direction dans laquelle ce conteneur Box place ses enfants.BoxDirection.VERTICAL Direction dans laquelle ce conteneur Box place ses enfants. Valeurs MXML possibles : "horizontal" et "vertical". Valeurs possibles en langage ActionScript : BoxDirection.HORIZONTAL et BoxDirection.VERTICAL.