BasicLayout

Package	spark.layouts
Classe	public class BasicLayout
Héritage	BasicLayout LayoutBase OnDemandEventDispatcher Object
Sous-classes	StackLayout

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

La classe BasicLayout dispose les éléments de présentation selon leurs paramètres, indépendants les uns des autres. BasicLayout, également appelé présentation absolue, requiert le positionnement explicite de chaque enfant de conteneur. Vous pouvez utiliser les propriétés x et y de l’enfant ou des contraintes pour positionner chaque enfant.

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, horizontalCenter, verticalCenter, baseline, percentWidth et percentHeight. Les tailles minimale et maximale de l’élément seront toujours respectées.

La taille mesurée du conteneur est calculée à partir des éléments, de leurs contraintes et de leurs tailles préférées. La taille mesurée du conteneur est suffisante pour tenir dans tous les éléments à leur taille préférée, avec leurs contraintes satisfaites.

Voici quelques exemples de méthodes de calcul de la taille mesurée :

Si le conteneur a un seul élément avec une contrainte left spécifiée, la largeur mesurée du conteneur est égale à la largeur préférée de l’élément plus la valeur de la contrainte left.
Si le conteneur a un seul élément avec la valeur percentWidth spécifiée, la largeur mesurée du conteneur est égale à la largeur préférée de l’élément. Même si la valeur percentWidth de l’élément n’est pas directement reflétée dans les calculs, elle sera respectées lors d’un appel de la méthode updateDisplayList().
Si le conteneur a un seul élément avec contrainte baseline spécifiée, la hauteur mesurée du conteneur est égale à la hauteur préférée de l’élément plus la baseline et moins la valeur de la propriété baselinePosition de l’élément.
Si le conteneur a un seul élément avec une contrainte de valeur verticalCenter spécifiée, la hauteur mesurée du conteneur est égale à la hauteur préférée de l’élément plus la valeur verticalCenter de la contrainte.

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 ou percentHeight 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 contraintes left, right, top ou bottom.
Si l’élément comporte des contraintes left et right, sa largeur est définie sur la largeur du conteneur moins les contraintes left et right.
Si l’élément comporte des contraintes top et bottom, sa hauteur est définie sur la hauteur du conteneur moins les contraintes top et bottom.
L’élément est défini sur sa largeur et/ou hauteur préférée.

La classe BasicLayout calcule sa taille minimale comme le maximum des tailles enfants minimales :

Pour chaque enfant du conteneur, déterminez la taille minimale à laquelle l’enfant doit pouvoir se réduire :
- Si l’enfant est limité par la largeur ou la hauteur de son parent, il peut se réduire à sa largeur ou hauteur minimale. Utilisez la taille minimale de l’enfant.
- Si l’enfant n’est pas limité par le parent, il conserve sa taille préférée. Utilisez la taille préférée de l’enfant.
Recherchez le maximum des tailles avec l’étape 1.

Par conséquent, si un enfant est limité par son parent, la mise en forme utilise la taille minimale de l’enfant. Dans le cas contraire, elle utilise la taille préférée de l’enfant pour calculer la taille minimale du conteneur.

La position de l’élément est calculée selon les règles suivantes, répertoriées dans leur ordre de priorité respectif :

Les contraintes horizontalCenter ou verticalCenter indiquent la distance entre le centre du conteneur et le centre de l’élément. Définissez les contraintes horizontalCenter ou verticalCenter sur zéro pour centrer l’élément dans le conteneur dans la direction horizontale ou verticale.
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 contrainte baseline.
Si les contraintes top ou left 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 ou right 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 taille maximale des coordonnées de du coin inférieur droit de tous les éléments de présentation.

Syntaxe MXML expanded

Masquer la syntaxe MXML

The <s:BasicLayout> tag inherits all of the tag attributes of its superclass and adds no additional tag attributes:

  <s:BasicLayout/>

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	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
		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éthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		BasicLayout() Constructeur.	BasicLayout
		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
		calculateDropLocation(dragEvent:DragEvent):DropLocation 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
		clearVirtualLayoutCache():void 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
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	OnDemandEventDispatcher
		elementAdded(index:int):void 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
		elementRemoved(index:int):void 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
		getElementBounds(index:int):Rectangle 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
		getHorizontalScrollPositionDelta(navigationUnit:uint):Number 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
		getScrollPositionDeltaToElement(index:int):Point Calcule les deltas horizontalScrollPosition et verticalScrollPosition requis pour faire défiler l’élément à l’index spécifié afin de l’afficher.	LayoutBase
		getVerticalScrollPositionDelta(navigationUnit:uint):Number Renvoie la modification de la position de défilement vertical pour traiter différentes options de défilement.	LayoutBase
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	OnDemandEventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		hideDropIndicator():void 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
		isPrototypeOf(theClass:Object):Boolean 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
		measure():void 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
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	OnDemandEventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		showDropIndicator(dropLocation:DropLocation):void 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
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		updateDisplayList(width:Number, height:Number):void Dimensionne et positionne les éléments de la cible.	LayoutBase
		updateScrollRect(w:Number, h:Number):void Appelé par la cible à la fin de sa liste updateDisplayList pour que la présentation mette à jour son rectangle scrollRect.	LayoutBase
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean 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éthodes protégées

Masquer les méthodes protégées héritées

Afficher les méthodes protégées héritées

	Méthode		Défini par
		calculateDragScrollDelta(dropLocation:DropLocation, elapsedTime:Number):Point Calcule la longueur de défilement pour l’objet dropLocation spécifié lors d’une opération glisser-déposer.	LayoutBase
		calculateDropIndex(x:Number, y:Number):int 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
		calculateDropIndicatorBounds(dropLocation:DropLocation):Rectangle 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
		getElementBoundsAboveScrollRect(scrollRect:Rectangle):Rectangle Renvoie les limites du premier élément de présentation qui englobe ou est au-dessus du bord supérieur du rectangle scrollRect.	LayoutBase
		getElementBoundsBelowScrollRect(scrollRect:Rectangle):Rectangle Renvoie les limites du premier élément de présentation qui englobe ou est en dessous du bord inférieur du rectangle scrollRect.	LayoutBase
		getElementBoundsLeftOfScrollRect(scrollRect:Rectangle):Rectangle Renvoie les limites du premier élément de présentation qui englobe ou est à gauche du bord gauche du rectangle scrollRect.	LayoutBase
		getElementBoundsRightOfScrollRect(scrollRect:Rectangle):Rectangle Renvoie les limites du premier élément de présentation qui englobe ou est à droite du bord droit du rectangle scrollRect.	LayoutBase
		getScrollRect():Rectangle Renvoie les limites du rectangle de défilement de la cible dans les coordonnées de présentation.	LayoutBase
		scrollPositionChanged():void Appelé lorsque les propriétés verticalScrollPosition ou horizontalScrollPosition changent.	LayoutBase

Détails du constructeur

()

Constructeur

public function BasicLayout()

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Constructeur.

Informations juridiques | Politique de confidentialité en ligne

BasicLayout - AS3 Flex

Classes x

BasicLayout