Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
spark.layouts 

BasicLayout  - AS3 Flex

Packagespark.layouts
Classepublic class BasicLayout
HéritageBasicLayout Inheritance LayoutBase Inheritance OnDemandEventDispatcher Inheritance 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 :

  1. 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.
  2. 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 MXMLexpandedMasquer 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
 PropriétéDéfini par
 InheritedclipAndEnableScrolling : Boolean
Si la valeur est true, indique d’écrêter les enfants aux limites de la fenêtre.
LayoutBase
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
 InheriteddropIndicator : 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
 InheritedhorizontalScrollPosition : 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
 Inheritedtarget : GroupBase
Le conteneur GroupBase dont les éléments sont mesurés, dimensionnés et positionnés par cette mise en forme.
LayoutBase
 InheritedtypicalLayoutElement : 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
 InheriteduseVirtualLayout : Boolean
Un conteneur peut contenir n’importe quel nombre d’enfants.
LayoutBase
 InheritedverticalScrollPosition : 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
 MéthodeDéfini par
  
Constructeur.
BasicLayout
 Inherited
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
 Inherited
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
 Inherited
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
 Inherited
Distribue un événement dans le flux d’événements.
OnDemandEventDispatcher
 Inherited
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
 Inherited
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
 Inherited
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
 Inherited
Renvoie la modification de la position de défilement horizontal pour traiter différentes options de défilement.
LayoutBase
 Inherited
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
 Inherited
Calcule les deltas horizontalScrollPosition et verticalScrollPosition requis pour faire défiler l’élément à l’index spécifié afin de l’afficher.
LayoutBase
 Inherited
Renvoie la modification de la position de défilement vertical pour traiter différentes options de défilement.
LayoutBase
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.
OnDemandEventDispatcher
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
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
 Inherited
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
 Inherited
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
OnDemandEventDispatcher
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
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
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Dimensionne et positionne les éléments de la cible.
LayoutBase
 Inherited
Appelé par la cible à la fin de sa liste updateDisplayList pour que la présentation mette à jour son rectangle scrollRect.
LayoutBase
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
 Inherited
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
 MéthodeDéfini par
 Inherited
Calcule la longueur de défilement pour l’objet dropLocation spécifié lors d’une opération glisser-déposer.
LayoutBase
 Inherited
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
 Inherited
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
 Inherited
Renvoie les limites du premier élément de présentation qui englobe ou est au-dessus du bord supérieur du rectangle scrollRect.
LayoutBase
 Inherited
Renvoie les limites du premier élément de présentation qui englobe ou est en dessous du bord inférieur du rectangle scrollRect.
LayoutBase
 Inherited
Renvoie les limites du premier élément de présentation qui englobe ou est à gauche du bord gauche du rectangle scrollRect.
LayoutBase
 Inherited
Renvoie les limites du premier élément de présentation qui englobe ou est à droite du bord droit du rectangle scrollRect.
LayoutBase
 Inherited
Renvoie les limites du rectangle de défilement de la cible dans les coordonnées de présentation.
LayoutBase
 Inherited
Appelé lorsque les propriétés verticalScrollPosition ou horizontalScrollPosition changent.
LayoutBase
Détails du constructeur

BasicLayout

()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.





[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.