Package | spark.layouts |
Classe | public class VerticalLayout |
Héritage | VerticalLayout LayoutBase OnDemandEventDispatcher Object |
Sous-classes | FormLayout |
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 verticale des éléments est déterminée en les disposant dans une séquence verticale, de bas en haut, en prenant en compte la marge avant le premier élément et les écarts entre les éléments.
La position horizontale des éléments est déterminée par la propriété horizontalAlign
de la mise en forme.
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 valeur de requestedRowCount
est définie, seul l’espace réservé à cette quantité d’éléments est mesuré, en commençant par le premier élément.
Pendant l’exécution de la méthode updateDisplayList()
, 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
variableRowHeight
a la valeurfalse
, définissez la hauteur de l’élément sur la valeur de la propriétérowHeight
. - Si la valeur
percentHeight
de l’élément est définie, calculez la hauteur de l’élément en distribuant la hauteur de conteneur disponible entre tous les éléments avec le paramètrepercentHeight
. La hauteur de conteneur disponible est égale à la hauteur de conteneur moins les écarts, la marge et l’espace occupé par le reste des éléments. La propriétépercentHeight
de l’élément est ignorée lorsque la présentation est virtualisée. - Définissez la hauteur de l’élément sur sa hauteur préférée.
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
horizontalAlign
a la valeur"justify"
, définissez la largeur de l’élément sur la largeur du conteneur. - Si
horizontalAlign
a la valeur"contentJustify"
, définissez la largeur de l’élément sur le maximum entre la largeur du conteneur et la largeur préférée de tous les éléments. - Si la valeur
percentWidth
de l’élément est définie, calculez la largeur de l’élément en tant que pourcentage de la largeur du conteneur. - Définissez la largeur de l’élément sur sa largeur préférée.
The <s:VerticalLayout>
tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:VerticalLayout Properties gap="6" horizontalAlign="left" paddingBottom="0" paddingLeft="0" paddingRight="0" paddingTop="0" requestedMaxRowCount="-1" requestedMinRowCount="-1" requestedRowCount="-1" rowHeight="calculated" variableRowHeight="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 | ||
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 du premier élément de présentation 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é. | VerticalLayout | ||
gap : int
Espace vertical entre les éléments de présentation, en pixels. | VerticalLayout | ||
horizontalAlign : String
Alignement horizontal des éléments de présentation. | VerticalLayout | ||
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 ligne 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é. | VerticalLayout | ||
paddingBottom : Number
Nombre de pixels entre la bordure inférieure du conteneur et le bord inférieur du dernier élément de présentation. | VerticalLayout | ||
paddingLeft : Number
Nombre de pixels entre la bordure gauche du conteneur et le bord gauche du premier élément de présentation. | VerticalLayout | ||
paddingRight : Number
Nombre de pixels entre la bordure droite du conteneur et le bord droit du premier élément de présentation. | VerticalLayout | ||
paddingTop : Number
Nombre de pixels entre la bordure supérieure du conteneur et le bord supérieur du premier élément de présentation. | VerticalLayout | ||
requestedMaxRowCount : int
La hauteur mesurée de cette présentation est suffisamment grande pour afficher au plus requestedMaxRowCount éléments de présentation. | VerticalLayout | ||
requestedMinRowCount : int
La hauteur mesurée de cette présentation est suffisamment grande pour afficher au moins les éléments de présentation requestedMinRowCount. | VerticalLayout | ||
requestedRowCount : int
La taille mesurée de cette présentation sera suffisante pour afficher les premiers éléments de présentation requestedRowCount. | VerticalLayout | ||
rowCount : int [lecture seule]
Nombre actuel d’éléments visibles. | VerticalLayout | ||
rowHeight : Number
Si la valeur de variableRowHeight est false, cette propriété spécifie la hauteur réelle de chaque enfant, en pixels. | VerticalLayout | ||
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 | ||
variableRowHeight : Boolean
Spécifie si les éléments de présentation est alloué leurs hauteur par défaut. | VerticalLayout | ||
verticalAlign : String
Alignement vertical du contenu par rapport à la hauteur du conteneur. | VerticalLayout | ||
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. | VerticalLayout | ||
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. | VerticalLayout | ||
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 |
firstIndexInView | 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 du premier élément de présentation 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é.
« Partie de la présentation » signifie que l’élément est non nul et que sa propriété includeInLayout
est égale à true
.
Notez que l’élément de présentation 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():int
Eléments de l’API associés
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 vertical 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):void
horizontalAlign | 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 des éléments de présentation. Si la valeur est "left"
, "right"
ou "center"
l’élément de présentation est aligné par rapport à la propriété contentWidth
du conteneur.
Si la valeur est égale à la valeur de "contentJustify"
, la largeur réelle de l’élément de présentation est définie sur la largeur contentWidth
du conteneur. La propriété contentWidth
du conteneur est la largeur du plus grand élément de présentation. Si tous les éléments de présentation sont inférieurs à la largeur du conteneur, définissez la largeur de tous les éléments de présentation sur la largeur du conteneur.
Si la valeur est égale à la valeur de "justify"
, la largeur réelle de l’élément de présentation est définie sur la largeur de la cible.
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):void
lastIndexInView | 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 ligne 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é.
« Partie de la présentation » signifie que l’enfant est non nul et que sa propriété includeInLayout
est égale à true
.
Notez que la ligne 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():int
Elé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 |
Nombre de pixels entre la bordure inférieure du conteneur et le bord inférieur du dernier élément de présentation.
La valeur par défaut est 0.
Implémentation
public function get paddingBottom():Number
public function set paddingBottom(value:Number):void
paddingLeft | 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):void
paddingRight | 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 premier é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):void
paddingTop | 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 de pixels entre la bordure supérieure du conteneur et le bord supérieur du premier élément de présentation.
La valeur par défaut est 0.
Implémentation
public function get paddingTop():Number
public function set paddingTop(value:Number):void
requestedMaxRowCount | propriété |
requestedMaxRowCount: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 hauteur mesurée de cette présentation est suffisamment grande pour afficher au plus requestedMaxRowCount
éléments de présentation.
Si la valeur de requestedRowCount
est définie, cette propriété n’a aucun effet.
Si la taille réelle du conteneur a été explicitement définie, cette propriété est sans effet.
La valeur par défaut est -1.
Implémentation
public function get requestedMaxRowCount():int
public function set requestedMaxRowCount(value:int):void
Eléments de l’API associés
requestedMinRowCount | propriété |
requestedMinRowCount: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 hauteur mesurée de cette présentation est suffisamment grande pour afficher au moins les éléments de présentation requestedMinRowCount
.
Si la valeur de requestedRowCount
est définie, cette propriété n’a aucun effet.
Si la taille réelle du conteneur a été explicitement définie, cette propriété est sans effet.
La valeur par défaut est -1.
Implémentation
public function get requestedMinRowCount():int
public function set requestedMinRowCount(value:int):void
Eléments de l’API associés
requestedRowCount | propriété |
requestedRowCount: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 requestedRowCount
.
Si requestedRowCount
est égal à -1, la taille mesurée sera suffisante pour tous les éléments de présentation.
Si la taille réelle du conteneur a été explicitement définie, cette propriété est sans effet.
La valeur par défaut est -1.
Implémentation
public function get requestedRowCount():int
public function set requestedRowCount(value:int):void
Eléments de l’API associés
rowCount | propriété |
rowCount: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 |
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 rowCount():int
rowHeight | propriété |
rowHeight: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 variableRowHeight
est false
, cette propriété spécifie la hauteur réelle de chaque enfant, en pixels.
Si la valeur de variableRowHeight
est true
(valeur par défaut), cette propriété est sans effet.
La valeur par défaut de cette propriété correspond à la hauteur préférée de l’élément typicalLayoutElement
.
Implémentation
public function get rowHeight():Number
public function set rowHeight(value:Number):void
variableRowHeight | propriété |
variableRowHeight:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie si éléments de mise en page sont définies sur leur hauteur par défaut. Définir cette propriété sur false
spécifie des lignes de hauteur fixe.
Si la valeur est false
, la hauteur réelle de chaque élément de présentation sera égale à la valeur de rowHeight
. Si cette propriété est définie sur false
, la présentation ignore la largeur percentHeight
des éléments de présentation.
La valeur par défaut est true.
Implémentation
public function get variableRowHeight():Boolean
public function set variableRowHeight(value:Boolean):void
verticalAlign | 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 du contenu par rapport à la hauteur du conteneur.
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.
Cette propriété n’a pas d’effet lorsque clipAndEnableScrolling
est défini sur true et que contentHeight
est supérieure à la hauteur du conteneur.
Cette propriété est sans effet sur la taille mesurée de la présentation.
La valeur par défaut est "top".
Implémentation
public function get verticalAlign():String
public function set verticalAlign(value:String):void
VerticalLayout | () | Constructeur |
public function VerticalLayout()
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 verticales du rectangle scrollRect
du conteneur et est inclus dans la mise en forme.
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 rangée.
|
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