Box  - AS3 Flex

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.

La valeur par défaut est BoxDirection.VERTICAL.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement directionChanged .

Constructeur.

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.

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.

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 renvoyé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é.

Paramètres

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.

Paramètres