| Package | spark.layouts |
| Classe | public class HorizontalLayout |
| Héritage | HorizontalLayout  LayoutBase OnDemandEventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
La position horizontale des éléments est déterminée en les disposant dans une séquence horizontale, de gauche à droite, en prenant en compte la marge avant le premier élément et les écarts entre les éléments.
La position verticale des éléments est déterminée par la propriété verticalAlign de la présentation.
Pendant l’exécution de la méthode measure(), la taille par défaut du conteneur est calculée en accumulant les tailles préférées des éléments, y compris les écarts et la marge. Lorsque la propriété requestedColumnCount est définie sur une valeur autre que -1, seul l’espace pour ce nombre d’éléments est mesuré en commençant par le premier élément.
Pendant l’exécution de la méthode updateDisplayList(), la largeur de chaque élément est calculée selon les règles suivantes, répertoriées dans leur ordre de priorité respectif (les largeurs minimale et maximale de l’élément sont toujours respectées) :
- Si
variableColumnWidtha la valeurfalse, définissez la largeur de l’élément sur la valeur de la propriétécolumnWidth. - Si la valeur
percentWidthde l’élément est définie, calculez la largeur de l’élément en distribuant la largeur de conteneur disponible entre tous les éléments avec le paramètrepercentWidth. La largeur de conteneur disponible est égale à la largeur de conteneur moins les écarts, la marge et l’espace occupé par le reste des éléments. La propriétépercentWidthde l’élément est ignorée lorsque la présentation est virtualisée. - Définissez la largeur de l’élément sur sa largeur préférée.
La hauteur de chaque élément est calculée selon les règles suivantes, répertoriées dans leur ordre de priorité respectif (les hauteurs minimale et maximale de l’élément sont toujours respectées) :
- Si
verticalAligna la valeur"justify", définissez la hauteur de l’élément sur la hauteur du conteneur. - Si
verticalAligna la valeur"contentJustify", définissez la hauteur de l’élément sur le maximum entre la hauteur du conteneur et la hauteur préférée de tous les éléments. - Si la propriété
percentHeightde l’élément est définie, calculez la hauteur de l’élément en tant que pourcentage de la hauteur du conteneur. - Définissez la hauteur de l’élément sur sa hauteur préférée.
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <s:HorizontalLayout> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:HorizontalLayout
Properties
columnWidth="calculated"
gap="6"
paddingBottom="0"
paddingLeft="0"
paddingRight="0"
paddingTop="0"
requestedColumnCount="-1"
requestedMaxColumnCount="-1"
requestedMinColumnCount="-1"
variableColumnWidth="true"
verticalAlign="top"
/>
| Propriété | Défini par | ||
|---|---|---|---|
 | clipAndEnableScrolling : Boolean
Si la valeur est true, indique d’écrêter les enfants aux limites de la fenêtre. | LayoutBase | |
| columnCount : int [lecture seule]
Renvoie le nombre actuel d’éléments visibles. | HorizontalLayout | ||
| columnWidth : Number
Si la valeur de la propriété variableColumnWidth est false, cette propriété spécifie la largeur réelle de chaque élément de présentation, en pixels. | HorizontalLayout | ||
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| dropIndicator : DisplayObject
Objet DisplayObject utilisé par cette présentation pour l’indicateur de dépôt au cours d’une opération glisser-déposer. | LayoutBase | |
| firstIndexInView : int [lecture seule]
Index de la première colonne faisant partie de la présentation et situé dans le rectangle le défilement de la cible de présentation, ou -1 si rien n’a encore été affiché. | HorizontalLayout | ||
| gap : int
Espace horizontal entre les éléments de présentation, en pixels. | HorizontalLayout | ||
| horizontalAlign : String
Alignement horizontal du contenu par rapport à la largeur du conteneur. | HorizontalLayout | ||
| horizontalScrollPosition : Number
Coordonnée x de l’origine de la fenêtre dans le système de coordonnées du composant, où la valeur par défaut (0,0) correspond à l’angle supérieur gauche du composant. | LayoutBase | |
| lastIndexInView : int [lecture seule]
Index de la dernière colonne faisant partie de la présentation et situé dans le rectangle de défilement de la cible de présentation, ou -1 si rien n’a encore été affiché. | HorizontalLayout | ||
| paddingBottom : Number
Nombre minimal de pixels séparant le bord inférieur du conteneur et le bas de tous les éléments de présentation du conteneur. | HorizontalLayout | ||
| paddingLeft : Number
Nombre de pixels entre la bordure gauche du conteneur et le bord gauche du premier élément de présentation. | HorizontalLayout | ||
| paddingRight : Number
Nombre de pixels entre la bordure droite du conteneur et le bord droit du dernier élément de présentation. | HorizontalLayout | ||
| paddingTop : Number
Le nombre minimum de pixels séparant le bord supérieur de conteneur et la partie supérieure de tous les éléments de présentation du conteneur. | HorizontalLayout | ||
| requestedColumnCount : int
La taille mesurée de cette présentation sera suffisante pour afficher les premiers éléments de présentation requestedColumnCount. | HorizontalLayout | ||
| requestedMaxColumnCount : int
La largeur mesurée de cette présentation est suffisamment grande pour afficher au plus requestedMaxColumnCount éléments de présentation. | HorizontalLayout | ||
| requestedMinColumnCount : int
La largeur mesurée de cette présentation est suffisamment grande pour afficher au moins les éléments de présentation requestedMinColumnCount. | HorizontalLayout | ||
| target : GroupBase
Le conteneur GroupBase dont les éléments sont mesurés, dimensionnés et positionnés par cette mise en forme. | LayoutBase | |
| typicalLayoutElement : ILayoutElement
Utilisé par les présentations lorsque des tailles de ligne/colonne fixes sont demandées mais qu’une taille spécifique n’est pas spécifié. | LayoutBase | |
| useVirtualLayout : Boolean
Un conteneur peut contenir n’importe quel nombre d’enfants. | LayoutBase | |
| variableColumnWidth : Boolean
Si la valeur est true, elle indique que les éléments de présentation doivent se voir allouer leur largeur préférée. | HorizontalLayout | ||
| verticalAlign : String
Alignement vertical des éléments de présentation. | HorizontalLayout | ||
| verticalScrollPosition : Number
Coordonnée y de l’origine de la fenêtre dans le système de coordonnées du composant, où la valeur par défaut est (0,0) correspondant au coin supérieur gauche du composant. | LayoutBase | |
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | HorizontalLayout | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | OnDemandEventDispatcher | |
|
Calcule l’emplacement de dépôt dans le fournisseur de données de la cible de dépôt pour l’objet dragEvent spécifié. | LayoutBase | |
|
Lorsque useVirtualLayout est true, cette méthode peut être utilisée par la cible de mise en forme pour effacer les informations de mise en forme en cache lors de la modification de la cible. | LayoutBase | |
|
Distribue un événement dans le flux d’événements. | OnDemandEventDispatcher | |
|
Appelée par la cible après ajout d’un élément de présentation et avant validation de la taille et de la liste d’affichage de la cible. | LayoutBase | |
|
Cette méthode doit être appelée par la cible après suppression d’un élément de présentation et avant validation de la taille et de la liste d’affichage de la cible. | LayoutBase | |
Renvoie 1.0 si l’index spécifié n’est pas entièrement visible, 0.0 s’il ne l’est plus ou une valeur comprise entre 0.0 et 1.0 qui représente le pourcentage de l’index partiellement visible. | HorizontalLayout | ||
|
Renvoie les limites de présentation de l’élément spécifié en tant que rectangle ou null si l’index n’est pas valide, l’élément correspondant est nul ou includeInLayout=false, ou si la propriété target de la mise en forme est nulle. | LayoutBase | |
|
Renvoie la modification de la position de défilement horizontal pour traiter différentes options de défilement. | LayoutBase | |
| getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int
Méthode de délégation qui détermine vers quel élément naviguer en fonction de l’élément actuel mis en focus et de l’entrée utilisateur en termes de constante NavigationUnit. | LayoutBase | |
|
Calcule les deltas horizontalScrollPosition et verticalScrollPosition requis pour faire défiler l’élément à l’index spécifié afin de l’afficher. | LayoutBase | |
|
Renvoie la modification de la position de défilement vertical pour traiter différentes options de défilement. | LayoutBase | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | OnDemandEventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Masque l’indicateur de dépôt créé par la méthode showDropIndicator() précédemment affiché, le supprime de la liste d’affichage et stoppe également l’opération de glissement-défilement. | LayoutBase | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Mesure la taille par défaut de la cible en fonction de son contenu et éventuellement la taille minimale par défaut de la cible. | LayoutBase | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | OnDemandEventDispatcher | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Définit la taille, la position et les parents de l’indicateur de dépôt en fonction de l’emplacement de dépôt spécifié. | LayoutBase | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Dimensionne et positionne les éléments de la cible. | LayoutBase | |
|
Appelé par la cible à la fin de sa liste updateDisplayList pour que la présentation mette à jour son rectangle scrollRect. | LayoutBase | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | OnDemandEventDispatcher | |
columnCount | propriété |
columnCount:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie le nombre actuel d’éléments visibles.
La valeur par défaut est -1.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .
Implémentation
public function get columnCount():intcolumnWidth | propriété |
columnWidth:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Si la valeur de la propriété variableColumnWidth est false, cette propriété spécifie la largeur réelle de chaque élément de présentation, en pixels.
Si la valeur de la propriété variableColumnWidth est true (valeur par défaut), cette propriété est sans effet.
La valeur par défaut de cette propriété correspond à la largeur préférée de l’élément spécifié par la propriété typicalLayoutElement.
Implémentation
public function get columnWidth():Number public function set columnWidth(value:Number):voidfirstIndexInView | propriété |
firstIndexInView:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Index de la première colonne faisant partie de la présentation et situé dans le rectangle le défilement de la cible de présentation, ou -1 si rien n’a encore été affiché. Notez que la colonne ne peut être que partiellement visible.
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 indexInViewChanged .
Implémentation
public function get firstIndexInView():intEléments de l’API associés
fractionOfElementInView
gap | propriété |
gap:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Espace horizontal entre les éléments de présentation, en pixels. Notez que l’écart n’est appliqué qu’entre les éléments de présentation ; aussi, si un seul élément est présent, l’écart est sans effet sur la présentation.
La valeur par défaut est 6.
Implémentation
public function get gap():int public function set gap(value:int):voidhorizontalAlign | propriété |
horizontalAlign:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Alignement horizontal du contenu par rapport à la largeur du conteneur. Si la valeur est "left", "right"ou "center" l’élément de présentation est aligné par rapport à la propriété contentWidth du conteneur.
Cette propriété n’a pas d’effet lorsque clipAndEnableScrolling est défini sur true et que contentWidth est supérieur à la largeur du conteneur.
Cette propriété est sans effet sur la taille mesurée de la présentation.
La valeur par défaut est "left".
Implémentation
public function get horizontalAlign():String public function set horizontalAlign(value:String):voidlastIndexInView | propriété |
lastIndexInView:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Index de la dernière colonne faisant partie de la présentation et situé dans le rectangle de défilement de la cible de présentation, ou -1 si rien n’a encore été affiché. Notez que la colonne ne peut être que partiellement visible.
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 indexInViewChanged .
Implémentation
public function get lastIndexInView():intEléments de l’API associés
fractionOfElementInView
paddingBottom | propriété |
paddingBottom:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Le nombre minimum de pixels séparant le bord inférieur de conteneur et le bas de tous les éléments de présentation du conteneur.
La valeur par défaut est 0.
Implémentation
public function get paddingBottom():Number public function set paddingBottom(value:Number):voidpaddingLeft | propriété |
paddingLeft:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Nombre de pixels entre la bordure gauche du conteneur et le bord gauche du premier élément de présentation.
La valeur par défaut est 0.
Implémentation
public function get paddingLeft():Number public function set paddingLeft(value:Number):voidpaddingRight | propriété |
paddingRight:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Nombre de pixels entre la bordure droite du conteneur et le bord droit du dernier élément de présentation.
La valeur par défaut est 0.
Implémentation
public function get paddingRight():Number public function set paddingRight(value:Number):voidpaddingTop | propriété |
paddingTop:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Nombre minimal de pixels séparant le bord supérieur du conteneur et le haut de tous les éléments de présentation du conteneur.
La valeur par défaut est 0.
Implémentation
public function get paddingTop():Number public function set paddingTop(value:Number):voidrequestedColumnCount | propriété |
requestedColumnCount:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
La taille mesurée de cette présentation sera suffisante pour afficher les premiers éléments de présentation requestedColumnCount. Si requestedColumnCount est égal à -1, la taille mesurée sera suffisante pour tous les éléments de présentation.
Si la taille réelle du container utilisant cette présentation a été explicitement définie, cette propriété est sans effet.
La valeur par défaut est -1.
Implémentation
public function get requestedColumnCount():int public function set requestedColumnCount(value:int):voidEléments de l’API associés
requestedMaxColumnCount | propriété |
requestedMaxColumnCount:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
La largeur mesurée de cette présentation est suffisamment grande pour afficher au plus requestedMaxColumnCount éléments de présentation.
Si la valeur de requestedColumnCount est définie, cette propriété n’a aucun effet.
Si la taille réelle du container utilisant cette présentation a été explicitement définie, cette propriété est sans effet.
La valeur par défaut est -1.
Implémentation
public function get requestedMaxColumnCount():int public function set requestedMaxColumnCount(value:int):voidEléments de l’API associés
requestedMinColumnCount | propriété |
requestedMinColumnCount:int| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
La largeur mesurée de cette présentation est suffisamment grande pour afficher au moins les éléments de présentation requestedMinColumnCount.
Si la valeur de requestedColumnCount est définie, cette propriété n’a aucun effet.
Si la taille réelle du container utilisant cette présentation a été explicitement définie, cette propriété est sans effet.
La valeur par défaut est -1.
Implémentation
public function get requestedMinColumnCount():int public function set requestedMinColumnCount(value:int):voidEléments de l’API associés
variableColumnWidth | propriété |
variableColumnWidth:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Si la valeur est true, elle indique que les éléments de présentation doivent se voir allouer leur largeur préférée.
Définir cette propriété sur false spécifie des colonnes de largeur fixe. La largeur réelle de chaque élément de présentation est la valeur de la propriété columnWidth. La présentation ne tient pas compte de la propriété percentWidth des éléments d’une présentation.
La valeur par défaut est true.
Implémentation
public function get variableColumnWidth():Boolean public function set variableColumnWidth(value:Boolean):voidverticalAlign | propriété |
verticalAlign:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Alignement vertical des éléments de présentation.
Si la valeur est "bottom", "middle"ou "top" les éléments de présentation sont alignés par rapport à la propriété contentHeight du conteneur.
Si la valeur est "contentJustify", la hauteur réelle de l’élément de présentation est définie sur la propriété contentHeight du conteneur. La hauteur de contenu du conteneur est la hauteur de l’enfant le plus grand. Si tous les éléments de présentation sont inférieurs à la hauteur du conteneur, définissez la hauteur de tous les éléments de présentation sur la hauteur du conteneur.
Si la valeur est "justify", la hauteur réelle de l’élément de présentation est définie sur la hauteur du conteneur.
Si la valeur est baseline, les éléments sont positionnés de sorte que leur texte soit aligné sur le maximum de l’ascension du texte des éléments.
La valeur par défaut est "top".
Implémentation
public function get verticalAlign():String public function set verticalAlign(value:String):voidHorizontalLayout | () | Constructeur |
public function HorizontalLayout()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Constructeur.
fractionOfElementInView | () | méthode |
public function fractionOfElementInView(index:int):Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie 1.0 si l’index spécifié n’est pas entièrement visible, 0.0 s’il ne l’est plus ou une valeur comprise entre 0.0 et 1.0 qui représente le pourcentage de l’index partiellement visible.
Un index est visible si l’élément de présentation non nul correspondant se trouve dans les limites horizontales du rectangle scrollRect du conteneur et est inclus dans la présentation.
Si l’index spécifié est partiellement visible, la valeur renvoyée est le pourcentage de l’élément de présentation correspondant qui est visible.
Paramètres
index:int — Index de la colonne.
|
Number — Pourcentage de l’élément spécifié visible. Renvoie 0.0 si l’index spécifié n’est pas valide ou s’il correspond à un élément nul, ou un élément ILayoutElement pour lequel includeInLayout comporte la valeur false.
|
Tue Jun 12 2018, 09:30 AM Z