Package | spark.layouts |
Classe | public class ConstraintLayout |
Héritage | ConstraintLayout LayoutBase OnDemandEventDispatcher Object |
Sous-classes | FormItemLayout |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Remarque : les contrôles basés sur une liste Spark (le contrôle List Spark et ses sous-classes, telles que ButtonBar, ComboBox, DropDownList et TabBar) ne prennent pas en charge la classe BasicLayout. N’utilisez pas BasicLayout avec les contrôles basés sur une liste Spark.
Les contraintes prises en charge par élément sont left
, right
, top
, bottom
, , baseline
, percentWidth
et percentHeight
. Les tailles minimale et maximale de l’élément seront toujours respectées.
Les colonnes et les lignes peuvent avoir une taille explicite ou un contenu explicite (s’ils n’ont pas de taille explicite). Les régions de taille explicite seront définies à leur taille spécifiée, alors que les régions de taille de contenu seront dimensionnées pour accueillir uniquement les éléments qui leur sont affectés par les contraintes. Si un élément recouvre plusieurs régions de taille de contenu, l’espace sera réparti également entre les régions de taille de contenu.
La taille mesurée du conteneur est calculée en fonction des éléments, de leurs contraintes, de leur taille préférée et de la taille des lignes et des colonnes. La taille de chaque ligne et de chaque colonne est juste suffisante pour accueillir tous les éléments qui lui sont affectés par les contraintes à leur taille préférée, les contraintes étant satisfaites. La taille mesurée du conteneur est suffisante pour accueillir toutes les colonnes et les lignes ainsi que tout autre élément laissé à sa taille préférée, les contraintes étant satisfaites.
Lors d’un appel de la méthode updateDisplayList()
, la taille de l’élément est calculée selon les règles suivantes, répertoriées dans leur ordre de priorité respectif (les tailles minimale et maximale de l’élément sont toujours respectées) :
- Si la valeur
percentWidth
oupercentHeight
de l’élément est définie, la taille de l’élément est calculée en tant que pourcentage de la taille du conteneur, où la taille disponible est la taille du conteneur moins les contraintesleft
,right
,top
oubottom
. - Si l’élément comporte des contraintes left et right, sa largeur est définie sur la largeur du conteneur moins les contraintes
left
etright
. - Si l’élément comporte des contraintes
top
etbottom
, sa hauteur est définie sur la hauteur du conteneur moins les contraintestop
etbottom
. - L’élément est défini sur sa largeur et/ou hauteur préférée.
La position de l’élément est calculée selon les règles suivantes, répertoriées dans leur ordre de priorité respectif :
- Si la ligne de base de l’élément est spécifiée, l’élément est positionné dans la direction verticale de sorte que sa position
baselinePosition
(généralement la ligne de base de sa première ligne de texte) soit alignée sur la contraintebaseline
. - Si les contraintes
top
ouleft
de l’élément sont spécifiées, l’élément est positionné de sorte que le coin supérieur gauche de ses limites de présentation soit décalé par rapport au coin supérieur gauche du conteneur par les valeurs spécifiées. - Si les contraintes
bottom
ouright
de l’élément sont spécifiées, l’élément est positionné de sorte que le coin inférieur droit de ses limites de présentation soit décalé par rapport au coin inférieur droit du conteneur par les valeurs spécifiées. - Lorsqu’aucune contrainte ne détermine la position dans la direction horizontale ou verticale, l’élément est positionné en fonction de ses coordonnées x et y.
La taille du contenu du conteneur est calculée comme la taille maximale des coordonnées de l’angle inférieur droit de tous les éléments de mise en page et régions de contraintes.
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 | ||
constraintColumns : Vector.<ConstraintColumn>
Un vecteur des instances de ConstraintColumn qui partitionne le conteneur cible. | ConstraintLayout | ||
constraintRows : Vector.<ConstraintRow>
Un vecteur des instances de ConstraintRow qui partitionne le conteneur cible. | ConstraintLayout | ||
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 | ||
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 | ||
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 | ||
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. | ConstraintLayout | ||
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 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 |
Méthode | Défini par | ||
---|---|---|---|
Calcule la longueur de défilement pour l’objet dropLocation spécifié lors d’une opération glisser-déposer. | LayoutBase | ||
Renvoie l’index dans lequel un nouvel élément doit être inséré lorsque l’utilisateur relâche la souris sur les coordonnées spécifiées à l’issue d’un glisser-déposer. | LayoutBase | ||
Calcule les limites de l’indicateur de dépôt qui fournit des informations visuelles à l’utilisateur sur l’emplacement d’insertion des éléments à l’issue d’une opération glisser-déposer. | LayoutBase | ||
Renvoie les limites du premier élément de présentation qui englobe ou est au-dessus du bord supérieur du rectangle scrollRect. | LayoutBase | ||
Renvoie les limites du premier élément de présentation qui englobe ou est en dessous du bord inférieur du rectangle scrollRect. | LayoutBase | ||
Renvoie les limites du premier élément de présentation qui englobe ou est à gauche du bord gauche du rectangle scrollRect. | LayoutBase | ||
Renvoie les limites du premier élément de présentation qui englobe ou est à droite du bord droit du rectangle scrollRect. | LayoutBase | ||
Renvoie les limites du rectangle de défilement de la cible dans les coordonnées de présentation. | LayoutBase | ||
Positionne les éléments de la cible de mise en forme à l’aide de la largeur et de la hauteur actuelles des colonnes et des lignes. | ConstraintLayout | ||
measureAndPositionColumnsAndRows(constrainedWidth:Number = NaN, constrainedHeight:Number = NaN):void
Utilisé par FormItemLayout pour mesurer et définir de nouvelles largeurs de colonne et hauteurs de rangée avant la présentation des éléments. | ConstraintLayout | ||
Appelé lorsque les propriétés verticalScrollPosition ou horizontalScrollPosition changent. | LayoutBase |
constraintColumns | propriété |
constraintColumns:Vector.<ConstraintColumn>
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Un vecteur des instances de ConstraintColumn qui partitionne le conteneur cible. L’instance ConstraintColumn qui se trouve à l’index 0 correspond à la colonne le plus à gauche. L’index augmente de gauche à droite.
Implémentation
public function get constraintColumns():Vector.<ConstraintColumn>
public function set constraintColumns(value:Vector.<ConstraintColumn>):void
constraintRows | propriété |
constraintRows:Vector.<ConstraintRow>
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Un vecteur des instances de ConstraintRow qui partitionne le conteneur cible. L’instance de ConstraintRow qui se trouve à l’index 0 correspond à la colonne supérieure ; les index sont disposés en ordre croissant de haut en bas.
Implémentation
public function get constraintRows():Vector.<ConstraintRow>
public function set constraintRows(value:Vector.<ConstraintRow>):void
ConstraintLayout | () | Constructeur |
public function ConstraintLayout()
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Constructeur.
layoutContent | () | méthode |
protected function layoutContent(unscaledWidth:Number, unscaledHeight:Number):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Positionne les éléments de la cible de mise en forme à l’aide de la largeur et de la hauteur actuelles des colonnes et des lignes. Utilisé par FormItemLayout après la définition de nouvelles largeurs de colonne pour mettre en forme les éléments en utilisant ces nouvelles largeurs.
Paramètres
unscaledWidth:Number — Indique la largeur du composant, en pixels, des coordonnées du composant, quelle que soit la valeur de la propriété scaleX du composant.
| |
unscaledHeight:Number — Indique la hauteur du composant, en pixels, des coordonnées du composant, quelle que soit la valeur de la propriété scaleY du composant.
|
measureAndPositionColumnsAndRows | () | méthode |
protected function measureAndPositionColumnsAndRows(constrainedWidth:Number = NaN, constrainedHeight:Number = NaN):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Utilisé par FormItemLayout pour mesurer et définir de nouvelles largeurs de colonne et hauteurs de rangée avant la présentation des éléments.
Paramètres
constrainedWidth:Number (default = NaN ) — L’épaisseur totale disponible pour les colonnes à étirer ou rétrécir leur pourcentage de largeur des colonnes. Si la valeur est NaN, pourcentage de largeur des colonnes sont libre et s’adapte à leur contenu.
| |
constrainedHeight:Number (default = NaN ) — Hauteur totale disponible pour les lignes à étirer ou rétrécir leurs pour cent des lignes de hauteur. Si la valeur est NaN, pourcentage des lignes de hauteur sont libre et s’adapte à leur contenu.
|
Tue Jun 12 2018, 09:30 AM Z