ILayoutElement - Guide de référence de l’API Adobe ActionScript® 3 (AS3 Flex)

Package	mx.core
Interface	public interface ILayoutElement extends IEventDispatcher
Implémenteurs	GraphicElement, UIMovieClip

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

L’interface ILayoutElement est principalement utilisée par les classes de présentation pour obtenir, dimensionner et positionner les éléments des conteneurs GroupBase.

Propriétés publiques

	Propriété		Défini par
		baseline : Object Distance verticale en pixels de la cible d’ancrage à la position de ligne de base du contrôle.	ILayoutElement
		baselinePosition : Number [lecture seule] Coordonnée y de la ligne de base de la première ligne de texte du composant.	ILayoutElement
		bottom : Object Distance verticale en pixels du bord inférieur du composant au bord inférieur de la cible d’ancrage.	ILayoutElement
		hasLayoutMatrix3D : Boolean [lecture seule] Contient true si l’élément possède une matrice 3D.	ILayoutElement
		horizontalCenter : Object Distance horizontale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage.	ILayoutElement
		includeInLayout : Boolean Indique si ce composant est inclus dans la présentation du conteneur parent.	ILayoutElement
		left : Object Distance horizontale en pixels du bord gauche du composant au bord gauche de la cible d’ancrage.	ILayoutElement
		percentHeight : Number Spécifie la hauteur d’un composant en tant que pourcentage de la taille de son parent.	ILayoutElement
		percentWidth : Number Spécifie la largeur d’un composant en tant que pourcentage de la taille de son parent.	ILayoutElement
		right : Object Distance horizontale en pixels du bord droit du composant au bord droit de la cible d’ancrage.	ILayoutElement
		top : Object Distance verticale en pixels du bord supérieur du composant au bord supérieur de la cible d’ancrage.	ILayoutElement
		verticalCenter : Object Distance verticale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage.	ILayoutElement

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		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.	IEventDispatcher
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	IEventDispatcher
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée.	ILayoutElement
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée.	ILayoutElement
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur de présentation de l’élément.	ILayoutElement
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur de la présentation de l’élément.	ILayoutElement
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran.	ILayoutElement
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran.	ILayoutElement
		getLayoutMatrix():Matrix Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères.	ILayoutElement
		getLayoutMatrix3D():Matrix3D Renvoie la matrice Matrix3D de transformation de présentation pour cet élément.	ILayoutElement
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur maximale de l’élément.	ILayoutElement
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur maximale de l’élément.	ILayoutElement
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur minimale de l’élément.	ILayoutElement
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur minimale de l’élément.	ILayoutElement
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur préférée de l’élément.	ILayoutElement
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur préférée de l’élément.	ILayoutElement
		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.	IEventDispatcher
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	IEventDispatcher
		setLayoutBoundsPosition(x:Number, y:Number, postLayoutTransform:Boolean = true):void Définit les coordonnées utilisées par l’élément pour son affichage à l’écran.	ILayoutElement
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void Définit la taille de la présentation de l’élément.	ILayoutElement
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void Définit la matrice de transformation utilisée pour calculer la taille de présentation et la position du composant par rapport à ses frères.	ILayoutElement
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void Définit la matrice de transformation Matrix3D utilisée pour calculer la taille et la position de la présentation du composant par rapport à ses frères.	ILayoutElement
		transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void Méthode d’utilitaire permettant de mettre à jour la rotation, la mise à l’échelle et la translation de la transformation tout en conservant un point particulier, spécifié dans l’espace de coordonnées du composant, fixe dans l’espace de coordonnées du parent.	ILayoutElement
		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é.	IEventDispatcher

Détails de la propriété

baseline

propriété

baseline:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Distance verticale en pixels de la cible d’ancrage à la position de ligne de base du contrôle.

Par défaut, la cible d’ancrage est le bord supérieur de la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une ligne de contrainte.

La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « row1:10 ».

La valeur par défaut est null.

Implémentation
public function get baseline():Object
public function set baseline(value:Object):void

baselinePosition

propriété

baselinePosition:Number [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

Coordonnée y de la ligne de base de la première ligne de texte du composant.

Cette propriété est utilisée pour implémenter le style de contrainte baseline. Elle est également utilisée pour aligner l’étiquette d’une classe FormItem aux contrôles dans la classe FormItem.

Chaque composant doit remplacer cette propriété.

Implémentation
public function get baselinePosition():Number

bottom

propriété

bottom:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Distance verticale en pixels du bord inférieur du composant au bord inférieur de la cible d’ancrage.

Par défaut, la cible d’ancrage est la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une ligne de contrainte.

La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « row1:10 ».

La valeur par défaut est null.

Implémentation
public function get bottom():Object
public function set bottom(value:Object):void

hasLayoutMatrix3D

propriété

hasLayoutMatrix3D:Boolean [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

Contient true si l’élément possède une matrice 3D.

Utilisez hasLayoutMatrix3D au lieu d’appeler et d’examiner la valeur renvoyée par la méthode getLayoutMatrix3D(), car cette méthode renvoie une matrice valide même lorsque l’élément est en 2D.

Implémentation
public function get hasLayoutMatrix3D():Boolean

horizontalCenter

propriété

horizontalCenter:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Distance horizontale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage.

La cible d’ancrage par défaut est le conteneur lui-même.

Dans les présentations avec contraintes avancées, la cible d’ancrage peut être une colonne de contrainte. Dans ce cas, la zone de contenu est l’espace entre la colonne précédente (ou le côté du conteneur) et la colonne cible.

Définir la propriété sur un nombre ou une chaîne numérique (par exemple, 10) spécifie l’utilisation de la cible d’ancrage par défaut.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « constraintColumnId:value ». Par exemple, « col1:10 ».

La valeur par défaut est null.

Implémentation
public function get horizontalCenter():Object
public function set horizontalCenter(value:Object):void

includeInLayout

propriété

includeInLayout:Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Indique si ce composant est inclus dans la présentation du conteneur parent. Si la valeur est true, l’objet est inclus dans la mise en forme du conteneur parent et est dimensionné et agencé par son conteneur parent par les règles de sa mise en page. Si la valeur est false, la taille et la position de l’objet ne sont pas affectés par la mise en page de son conteneur parent.

Implémentation
public function get includeInLayout():Boolean
public function set includeInLayout(value:Boolean):void

left

propriété

left:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Distance horizontale en pixels du bord gauche du composant au bord gauche de la cible d’ancrage.

Par défaut, la cible d’ancrage est la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une colonne de contrainte.

La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « col1:10 ».

La valeur par défaut est null.

Implémentation
public function get left():Object
public function set left(value:Object):void

percentHeight

propriété

percentHeight:Number

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 la hauteur d’un composant en tant que pourcentage de la taille de son parent. Valeurs autorisées : 0 à 100. Définir les propriétés height ou explicitHeight réinitialise cette propriété sur NaN.

Cette propriété renvoie une valeur numérique uniquement si elle a été précédemment définie. Elle ne reflète pas la taille exacte du composant en pourcentage.

La valeur par défaut est NaN.

Implémentation
public function get percentHeight():Number
public function set percentHeight(value:Number):void

percentWidth

propriété

percentWidth:Number

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 la largeur d’un composant en tant que pourcentage de la taille de son parent. Valeurs autorisées : 0 à 100. La définition des valeurs width ou explicitWidth restaure cette propriété sur la valeur NaN.

Cette propriété renvoie une valeur numérique uniquement si elle a été précédemment définie. Elle ne reflète pas la taille exacte du composant en pourcentage.

La valeur par défaut est NaN.

Implémentation
public function get percentWidth():Number
public function set percentWidth(value:Number):void

right

propriété

right:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Distance horizontale en pixels du bord droit du composant au bord droit de la cible d’ancrage.

Par défaut, la cible d’ancrage est la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une colonne de contrainte.

La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « col1:10 ».

La valeur par défaut est null.

Implémentation
public function get right():Object
public function set right(value:Object):void

top

propriété

top:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Distance verticale en pixels du bord supérieur du composant au bord supérieur de la cible d’ancrage.

Par défaut, la cible d’ancrage est la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une ligne de contrainte.

La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « row1:10 ».

La valeur par défaut est null.

Implémentation
public function get top():Object
public function set top(value:Object):void

verticalCenter

propriété

verticalCenter:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Distance verticale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage.

La cible d’ancrage par défaut est le conteneur lui-même.

Dans les présentations avec contraintes avancées, la cible peut être une ligne de contrainte. La zone de contenu est alors l’espace entre la rangée précédente (ou le côté du conteneur) et la rangée cible.

Définir la propriété sur un nombre ou une chaîne numérique (par exemple, 10) spécifie l’utilisation de la cible d’ancrage par défaut.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « constraintColumnId:value ». Par exemple, « row1:10 ».

La valeur par défaut est null.

Implémentation
public function get verticalCenter():Object
public function set verticalCenter(value:Object):void

Détails de la méthode

getBoundsXAtSize

()

méthode

public function getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):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 la coordonnée x des limites de l’élément à la taille d’élément spécifiée.

Cette méthode est généralement utilisée par les présentations pendant un appel de la méthode measure() pour prévoir la position de l’élément, si l’élément est redimensionné sur certaines dimensions.

Paramètres

	`width:Number` — Largeur des limites de l’élément ou NaN pour utiliser la largeur préférée.

	`height:Number` — Hauteur des limites de l’élément ou NaN pour utiliser la hauteur préférée.

	`postLayoutTransform:Boolean` (default = `true`) — Lorsque `postLayoutTransform` a la valeur true, la méthode renvoie la coordonnée x du coin supérieur gauche du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément et est calculé d’après la taille des limites, la position de la présentation et la matrice de transformation de la présentation spécifiées.

Valeur renvoyée

Number — Coordonnée x des limites de l’élément à la taille d’élément spécifiée.

Eléments de l’API associés

setLayoutBoundsSize()
getLayoutMatrix()
getLayoutMatrix3D()

getBoundsYAtSize

()

méthode

public function getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):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 la coordonnée y des limites de l’élément à la taille d’élément spécifiée. Cette méthode est généralement utilisée par les présentations pendant un appel de la méthode measure() pour prévoir la position de l’élément, si l’élément est redimensionné sur certaines dimensions.

Paramètres

	`width:Number` — Largeur des limites de l’élément ou NaN pour utiliser la largeur préférée.

	`height:Number` — Hauteur des limites de l’élément ou NaN pour utiliser la hauteur préférée.

	`postLayoutTransform:Boolean` (default = `true`) — Lorsque la valeur de l’élément `postLayoutTransform` est true, la méthode renvoie la coordonnée y du coin supérieur gauche du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément et est calculé d’après la taille des limites, la position de la présentation et la matrice de transformation de la présentation spécifiées.

Valeur renvoyée

Number — Coordonnée y des limites de l’élément à la taille d’élément spécifiée.

Eléments de l’API associés

setLayoutBoundsSize()
getLayoutBoundsY()
getLayoutMatrix()
getLayoutMatrix3D()

getLayoutBoundsHeight

()

méthode

public function getLayoutBoundsHeight(postLayoutTransform:Boolean = true):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 la hauteur de présentation de l’élément. Il s’agit de la taille que l’élément utilise pour son affichage à l’écran.

Paramètres

postLayoutTransform:Boolean (default = true) — Lorsque postLayoutTransform a la valeur true, la méthode renvoie la largeur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille de présentation et de la matrice de transformation de présentation de l’élément.

Valeur renvoyée

Number — Hauteur de la présentation de l’élément.

Eléments de l’API associés

getLayoutBoundsWidth()
getLayoutMatrix()
getLayoutMatrix3D()

getLayoutBoundsWidth

()

méthode

public function getLayoutBoundsWidth(postLayoutTransform:Boolean = true):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 la largeur de présentation de l’élément. Il s’agit de la taille que l’élément utilise pour son affichage à l’écran.

Paramètres

Valeur renvoyée

Number — Largeur de la présentation de l’élément.

Eléments de l’API associés

getLayoutBoundsHeight()
getLayoutMatrix()
getLayoutMatrix3D()

getLayoutBoundsX

()

méthode

public function getLayoutBoundsX(postLayoutTransform:Boolean = true):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 la coordonnée x que l’élément utilise pour dessiner à l’écran.

Paramètres

postLayoutTransform:Boolean (default = true) — Lorsque postLayoutTransform a la valeur true, la méthode renvoie la coordonnée x du coin supérieur gauche du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille de présentation, de la position de présentation et de la matrice de transformation de présentation de l’élément.

Valeur renvoyée

Number — Coordonnée x que l’élément utilise pour le traçage sur l’écran.

Eléments de l’API associés

getLayoutBoundsY()
getLayoutMatrix()
getLayoutMatrix3D()

getLayoutBoundsY

()

méthode

public function getLayoutBoundsY(postLayoutTransform:Boolean = true):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 la coordonnée y utilisée par l’élément pour son affichage à l’écran.

Paramètres

postLayoutTransform:Boolean (default = true) — Lorsque postLayoutTransform a la valeur true, la méthode renvoie la coordonnée y du coin supérieur gauche du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille de présentation, de la position de présentation et de la matrice de transformation de présentation de l’élément.

Valeur renvoyée

Number — Coordonnée y utilisée par l’élément pour son affichage à l’écran.

Eléments de l’API associés

getLayoutBoundsX()
getLayoutMatrix()
getLayoutMatrix3D()

getLayoutMatrix

()

méthode

public function getLayoutMatrix():Matrix

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères.

Cette matrice est habituellement définie par les propriétés 2D du composant, telles que x, y, rotation, scaleX, scaleY, transformX et transformY. Certains composants peuvent comporter des propriétés de transformation supplémentaires appliquées au-dessus de la matrice de présentation pour déterminer la matrice calculée finale. Par exemple, UIComponent définit la propriété offsets.

Valeur renvoyée

Matrix — Matrice de transformation de la présentation pour cet élément. Au lieu de modifier directement la valeur renvoyée, appelez la méthode setLayoutMatrix().

Eléments de l’API associés

setLayoutMatrix()
getLayoutMatrix3D()
setLayoutMatrix3D()

getLayoutMatrix3D

()

méthode

public function getLayoutMatrix3D():Matrix3D

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Renvoie la matrice Matrix3D de transformation de présentation pour cet élément.

Cette matrice est habituellement définie par les propriétés de transformation du composant, comme x, y, z, rotationX, rotationY, rotationZ, scaleX, scaleY, scaleZ, transformX et transformY. Certains composants peuvent comporter des propriétés de transformation supplémentaires appliquées au-dessus de la matrice de présentation pour déterminer la matrice calculée finale. Par exemple, UIComponent définit la propriété offsets.

Valeur renvoyée

Matrix3D — Matrice Matrix3D de transformation de présentation pour cet élément. Au lieu de modifier directement la valeur renvoyée, appelez la méthode setLayoutMatrix().

Eléments de l’API associés

getLayoutMatrix()
setLayoutMatrix()
setLayoutMatrix3D()

getMaxBoundsHeight

()

méthode

public function getMaxBoundsHeight(postLayoutTransform:Boolean = true):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 la hauteur maximale de l’élément.

Paramètres

postLayoutTransform:Boolean (default = true) — Lorsque postLayoutTransform a la valeur true, la méthode renvoie la hauteur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille maximale et de la matrice de transformation de présentation de l’élément.

Valeur renvoyée

Number — Hauteur maximale de l’élément.

Eléments de l’API associés

getMaxBoundsWidth()
getLayoutMatrix()
getLayoutMatrix3D()

getMaxBoundsWidth

()

méthode

public function getMaxBoundsWidth(postLayoutTransform:Boolean = true):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 la largeur maximale de l’élément.

Paramètres

postLayoutTransform:Boolean (default = true) — Lorsque postLayoutTransform a la valeur true, la méthode renvoie la largeur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille maximale et de la matrice de transformation de présentation de l’élément.

Valeur renvoyée

Number — Largeur maximale de l’élément.

Eléments de l’API associés

getMaxBoundsHeight()
getLayoutMatrix()
getLayoutMatrix3D()

getMinBoundsHeight

()

méthode

public function getMinBoundsHeight(postLayoutTransform:Boolean = true):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 la hauteur minimale de l’élément.

Paramètres

postLayoutTransform:Boolean (default = true) — Lorsque postLayoutTransform a la valeur true, la méthode renvoie la hauteur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille minimale et de la matrice de transformation de présentation de l’élément.

Valeur renvoyée

Number — Hauteur maximale de l’élément.

Eléments de l’API associés

getMinBoundsWidth()
getLayoutMatrix()
getLayoutMatrix3D()

getMinBoundsWidth

()

méthode

public function getMinBoundsWidth(postLayoutTransform:Boolean = true):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 la largeur minimale de l’élément.

Paramètres

postLayoutTransform:Boolean (default = true) — Lorsque postLayoutTransform a la valeur true, la méthode renvoie la largeur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille minimale et de la matrice de transformation de présentation de l’élément.

Valeur renvoyée

Number — Largeur maximale de l’élément.

Eléments de l’API associés

getMinBoundsHeight()
getLayoutMatrix()
getLayoutMatrix3D()

getPreferredBoundsHeight

()

méthode

public function getPreferredBoundsHeight(postLayoutTransform:Boolean = true):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 la hauteur préférée de l’élément.

Paramètres

postLayoutTransform:Boolean (default = true) — Lorsque postLayoutTransform a la valeur true, la méthode renvoie la hauteur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille préférée et de la matrice de transformation de présentation de l’élément.

Valeur renvoyée

Number — Renvoie la hauteur préférée de l’élément. La hauteur par défaut est habituellement basée sur la taille d’élément par défaut et tout remplacement explicite éventuel. Pour un composant UIComponent, il s’agit de la même valeur que celle renvoyée par la méthode getExplicitOrMeasuredHeight().

Eléments de l’API associés

getPreferredBoundsWidth()
getLayoutMatrix()
getLayoutMatrix3D()

getPreferredBoundsWidth

()

méthode

public function getPreferredBoundsWidth(postLayoutTransform:Boolean = true):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 la largeur préférée de l’élément.

Paramètres

postLayoutTransform:Boolean (default = true) — Lorsque postLayoutTransform a la valeur true, la méthode renvoie la largeur du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille préférée et de la matrice de transformation de présentation de l’élément.

Valeur renvoyée

Number — Renvoie la largeur préférée de l’élément. La largeur par défaut est habituellement basée sur la taille d’élément par défaut et tout remplacement explicite éventuel. Pour le composant UIComponent, il s’agit de la même valeur que celle renvoyée par la méthode getExplicitOrMeasuredWidth().

Eléments de l’API associés

getPreferredBoundsHeight()
getLayoutMatrix()
getLayoutMatrix3D()

setLayoutBoundsPosition

()

méthode

public function setLayoutBoundsPosition(x:Number, y:Number, postLayoutTransform:Boolean = true):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Définit les coordonnées utilisées par l’élément pour son affichage à l’écran.

Notez que les appels de la méthode setLayoutBoundSize() peuvent affecter la position de présentation. Vous devez donc appeler setLayoutBoundPosition() après avoir appelé setLayoutBoundSize().

Paramètres

	`x:Number` — Coordonnée x du coin supérieur gauche du cadre de sélection.

	`y:Number` — Coordonnée y du coin supérieur gauche du cadre de sélection.

	`postLayoutTransform:Boolean` (default = `true`) — Lorsque `postLayoutTransform` est défini sur `true`, l’élément est placé de manière à faire correspondre le coin supérieur gauche de son cadre de sélection avec les coordonnées (x, y). Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille de présentation, de la position de présentation et de la matrice de transformation de présentation de l’élément.

Eléments de l’API associés

setLayoutBoundsSize()
getLayoutMatrix()
getLayoutMatrix3D()

setLayoutBoundsSize

()

méthode

public function setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Définit la taille de la présentation de l’élément. Il s’agit de la taille que l’élément utilise pour son affichage à l’écran.

Si les paramètres width et/ou height ne sont pas spécifiés (NaN), Flex définit la taille de la présentation de l’élément sur la largeur et/ou la hauteur préférées.

Paramètres

	`width:Number` — Largeur de la présentation de l’élément.

	`height:Number` — Hauteur de la présentation de l’élément.

	`postLayoutTransform:Boolean` (default = `true`) — Lorsque `postLayoutTransform` a la valeur true, les dimensions spécifiées sont celles du cadre de sélection de l’élément. Le cadre de sélection est dans l’espace de coordonnées parent de l’élément. Il est calculé à partir de la taille de présentation, de la position de présentation et de la matrice de transformation de présentation de l’élément.

Eléments de l’API associés

setLayoutBoundsPosition()
getLayoutMatrix()
getLayoutMatrix3D()

setLayoutMatrix

()

méthode

public function setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Définit la matrice de transformation utilisée pour calculer la taille de présentation et la position du composant par rapport à ses frères.

La matrice est habituellement définie par les propriétés 2D du composant, telles que x, y, rotation, scaleX, scaleY, transformX et transformY. Certains composants peuvent comporter des propriétés de transformation supplémentaires appliquées au-dessus de la matrice de présentation pour déterminer la matrice calculée finale. Par exemple, UIComponent définit la propriété offsets.

Notez que la matrice de présentation Matrix est utilisée comme facteur dans les méthodes getPreferredSize(), getMinSize(), getMaxSize() et getLayoutSize() lorsqu’elle est calculée dans les coordonnées du parent, ainsi que dans getLayoutPosition() dans les coordonnées du parent et de l’enfant. Généralement, les présentations permettant de calculer la matrice de transformation appellent explicitement cette méthode et utilisent des tailles dans les coordonnées de l’enfant. Les présentations qui appellent cette méthode transmettent la valeur false à la méthode invalidateLayout afin qu’une transmission de présentation suivante ne soit pas déclenchée.

Paramètres

	`value:Matrix` — Matrice.

	`invalidateLayout:Boolean` — La valeur `true` entraîne le conteneur parent à réorganiser ses enfants. En règle générale, vous transmettez la valeur `true` à la méthode `invalidateLayout()`.

Eléments de l’API associés

getLayoutMatrix()
getLayoutMatrix3D()
setLayoutMatrix3D()

setLayoutMatrix3D

()

méthode

public function setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Définit la matrice de transformation Matrix3D utilisée pour calculer la taille et la position de la présentation du composant par rapport à ses frères.

Notez que la matrice de présentation Matrix3D est utilisée comme facteur dans les méthodes getPreferredSize(), getMinSize(), getMaxSize() et getLayoutSize() lorsqu’elle est calculée dans les coordonnées du parent, ainsi que dans getLayoutPosition() dans les coordonnées du parent et de l’enfant. Généralement, les présentations permettant de calculer la matrice de transformation appellent explicitement cette méthode et utilisent des tailles dans les coordonnées de l’enfant. Les présentations qui appellent cette méthode transmettent la valeur false à la méthode invalidateLayout afin qu’une transmission de présentation suivante ne soit pas déclenchée.

Paramètres

	`value:Matrix3D` — Matrice.

	`invalidateLayout:Boolean` — La valeur `true` entraîne le conteneur parent à réorganiser ses enfants. En règle générale, vous transmettez la valeur `true` à la méthode `invalidateLayout()`.

Eléments de l’API associés

getLayoutMatrix()
setLayoutMatrix()
getLayoutMatrix3D()

transformAround

()

méthode

 public function transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Méthode d’utilitaire permettant de mettre à jour la rotation, la mise à l’échelle et la translation de la transformation tout en conservant un point particulier, spécifié dans l’espace de coordonnées du composant, fixe dans l’espace de coordonnées du parent. Cette fonction affecte les valeurs de rotation, d’échelle et de translation fournies, puis met à jour les propriétés x/y/z, le cas échéant, pour conserver le centre de transformation fixe.

Paramètres

	`transformCenter:Vector3D` — Point, dans les coordonnées du composant, à garder fixe par rapport à son parent.

	`scale:Vector3D` (default = `null`) — Nouvelles valeurs d’échelle de la transformation.

	`rotation:Vector3D` (default = `null`) — nouvelles valeurs de rotation de la transformation

	`translation:Vector3D` (default = `null`) — Nouvelles valeurs de translation de la transformation.

	`postLayoutScale:Vector3D` (default = `null`) — Nouvelles valeurs d’échelle après mise en forme de la transformation.

	`postLayoutRotation:Vector3D` (default = `null`) — Nouvelles valeurs de rotation après mise en forme de la transformation.

	`postLayoutTranslation:Vector3D` (default = `null`) — Nouvelles valeurs de translation après mise en forme de la transformation.

	`invalidateLayout:Boolean` (default = `true`) — Si la valeur est `true`, la taille et l’affichage du conteneur parent sont invalidés. Les présentations qui appellent cette méthode transmettent `false` afin qu’une transmission de présentation suivante ne soit pas déclenchée.

Informations juridiques | Politique de confidentialité en ligne

ILayoutElement - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.core

baseline

baselinePosition

bottom

hasLayoutMatrix3D

horizontalCenter

includeInLayout

left

percentHeight

percentWidth

right

top

verticalCenter

getBoundsXAtSize

getBoundsYAtSize

getLayoutBoundsHeight

getLayoutBoundsWidth

getLayoutBoundsX

getLayoutBoundsY

getLayoutMatrix

getLayoutMatrix3D

getMaxBoundsHeight

getMaxBoundsWidth

getMinBoundsHeight

getMinBoundsWidth

getPreferredBoundsHeight

getPreferredBoundsWidth

setLayoutBoundsPosition

setLayoutBoundsSize

setLayoutMatrix

setLayoutMatrix3D

transformAround