Path

Package	spark.primitives
Classe	public class Path
Héritage	Path FilledElement StrokedElement GraphicElement EventDispatcher Object

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 Path est un élément graphique rempli qui trace une série de segments de chemin. Dans les images vectorielles, un chemin est une série de points reliés par des segments de ligne droits ou courbes. Ensemble, les lignes constituent une image. Dans Flex, vous utilisez la classe Path pour définir une forme vectorielle complexe construite à partir d’un ensemble de segments de ligne.

En règle générale, le premier élément d’une définition de chemin est un segment Move spécifiant la position de départ de la plume du graphique. Vous pouvez ensuite utiliser les segments Line, CubicBezier et QuadraticBezier pour tracer les lignes du graphique. Lorsque vous utilisez ces classes, vous spécifiez uniquement les coordonnées x et y du point de fin de la ligne. Les coordonnées x et y du point de départ sont définies par la position courante de la plume.

Après avoir tracé un segment de ligne, la position courante de la plume devient les coordonnées x et y du point de fin de la ligne. Vous pouvez utiliser plusieurs segments Move dans la définition de chemin pour repositionner la plume.

La syntaxe utilisée par la classe Path pour définir la forme est la même que la syntaxe de chemin SVG, qui rend aisée la conversion de chemins SVG en chemins Flex.

Consulter les exemples

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
		alpha : Number Niveau de transparence de l’élément graphique.	GraphicElement
		alwaysCreateDisplayObject : Boolean Spécifie que cet objet GraphicElement doit être associé à sa propre classe DisplayObject et rendu dans cette dernière.	GraphicElement
		baseline : Object Distance verticale en pixels de la cible d’ancrage à la position de ligne de base du contrôle.	GraphicElement
		baselinePosition : Number [lecture seule] Coordonnée y de la ligne de base de la première ligne de texte du composant.	GraphicElement
		blendMode : String Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser.	GraphicElement
		bottom : Object Distance verticale en pixels du bord inférieur du composant au bord inférieur de la cible d’ancrage.	GraphicElement
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		data : String Chaîne contenant une représentation compacte des segments de chemin.	Path
		depth : Number Détermine l’ordre dans lequel les éléments sont rendus au sein des conteneurs.	GraphicElement
		designLayer : DesignLayer Spécifie l’instance DesignLayer facultative associée à cet élément visuel.	GraphicElement
		displayObject : DisplayObject [lecture seule] Objet DisplayObject partagé où cet élément IGraphicElement est tracé.	GraphicElement
		displayObjectSharingMode : String Indique l’association entre cette interface IGraphicElement et ses objets d’affichage.	GraphicElement
		explicitHeight : Number Nombre définissant la hauteur explicite du composant en pixels, dans les coordonnées du composant.	GraphicElement
		explicitMaxHeight : Number Hauteur maximale recommandée du composant à prendre en compte par le parent lors de la présentation.	GraphicElement
		explicitMaxWidth : Number Largeur maximale recommandée du composant à prendre en compte par le parent lors de la présentation.	GraphicElement
		explicitMinHeight : Number Hauteur minimale recommandée du composant à prendre en compte par le parent lors de la présentation.	GraphicElement
		explicitMinWidth : Number Largeur minimale recommandée du composant à prendre en compte par le parent lors de la présentation.	GraphicElement
		explicitWidth : Number Nombre définissant la largeur explicite du composant en pixels, dans les coordonnées du composant.	GraphicElement
		fill : IFill Objet qui définit les propriétés du remplissage.	FilledElement
		filters : Array Tableau indexé contenant tous les objets filtre actuellement associés à l’élément graphique.	GraphicElement
		hasLayoutMatrix3D : Boolean [lecture seule] Contient true si l’élément possède une matrice 3D.	GraphicElement
		height : Number Hauteur de l’élément graphique.	GraphicElement
		horizontalCenter : Object Distance horizontale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage.	GraphicElement
		id : String Identité du composant.	GraphicElement
		includeInLayout : Boolean Spécifie si cet élément est inclus dans la présentation du parent.	GraphicElement
		is3D : Boolean [lecture seule] Contient true lorsque l’élément est en 3D.	GraphicElement
		layoutDirection : String Spécifie la direction de mise en forme souhaitée pour un élément : l’une des valeurs LayoutDirection.LTR (de gauche à droite), LayoutDirection.RTL (de droite à gauche) ou null (héritée).	GraphicElement
		left : Object Distance horizontale en pixels du bord gauche du composant au bord gauche de la cible d’ancrage.	GraphicElement
		luminosityClip : Boolean Propriété qui contrôle si le masque de luminosité écrête le contenu masqué.	GraphicElement
		luminosityInvert : Boolean Une propriété qui contrôle le calcul de la valeur de couleur RVB d’un élément graphique masqué par un masque de luminosité.	GraphicElement
		mask : DisplayObject L’objet d’affichage appelant est masqué par l’objet mask spécifié.	GraphicElement
		maskType : String Définit la façon dont le masque est appliqué à l’élément GraphicElement. Les valeurs possibles sont MaskType.CLIP, MaskType.ALPHA et MaskType.LUMINOSITY. Masquage d’écrêtage : lors d’un masquage en mode écrêtage, un masque d’écrêtage est réduit à 1 bit.	GraphicElement
		maxHeight : Number Hauteur maximale recommandée du composant à prendre en compte par le parent lors de la présentation.	GraphicElement
		maxWidth : Number Largeur maximale recommandée du composant à prendre en compte par le parent lors de la présentation.	GraphicElement
		measuredHeight : Number Hauteur par défaut du composant, en pixels.	GraphicElement
		measuredWidth : Number Largeur par défaut du composant, en pixels.	GraphicElement
		measuredX : Number Coin supérieur gauche des limites mesurées par défaut par rapport à l’origine de l’élément.	GraphicElement
		measuredY : Number Coin supérieur gauche des limites mesurées par défaut par rapport à l’origine de l’élément.	GraphicElement
		minHeight : Number Hauteur minimale recommandée du composant à prendre en compte par le parent lors de la présentation.	GraphicElement
		minWidth : Number Largeur minimale recommandée du composant à prendre en compte par le parent lors de la présentation.	GraphicElement
		owner : DisplayObjectContainer Propriétaire de cet objet IVisualElement.	GraphicElement
		parent : DisplayObjectContainer [lecture seule] Conteneur ou composant parent de ce composant.	GraphicElement
		percentHeight : Number Spécifie la hauteur d’un composant en tant que pourcentage de la taille de son parent.	GraphicElement
		percentWidth : Number Spécifie la largeur d’un composant en tant que pourcentage de la taille de son parent.	GraphicElement
		postLayoutTransformOffsets : mx.geom:TransformOffsets Définit un ensemble de réglages pouvant être appliqué à la transformation d’un objet de manière invisible pour la présentation de son parent.	GraphicElement
		right : Object Distance horizontale en pixels du bord droit du composant au bord droit de la cible d’ancrage.	GraphicElement
		rotation : Number Indique la rotation de l’élément, en degrés, à partir du point de transformation.	GraphicElement
		rotationX : Number Indique la rotation de l’axe des x de l’instance de l’élément, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.	GraphicElement
		rotationY : Number Indique la rotation de l’axe des y de l’instance DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.	GraphicElement
		rotationZ : Number Indique la rotation de l’élément, en degrés, à partir du point de transformation.	GraphicElement
		scaleX : Number Echelle horizontale (pourcentage) de l’élément telle qu’elle est appliquée à partir du point de transformation.	GraphicElement
		scaleY : Number Echelle verticale (pourcentage) de l’élément telle qu’elle est appliquée à partir du point de transformation.	GraphicElement
		scaleZ : Number Echelle z (pourcentage) de l’élément telle qu’elle est appliquée à partir du point de transformation.	GraphicElement
		stroke : IStroke Trait utilisé par cet élément.	StrokedElement
		top : Object Distance verticale en pixels du bord supérieur du composant au bord supérieur de la cible d’ancrage.	GraphicElement
		transform : flash.geom:Transform Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage.	GraphicElement
		transformX : Number Point de transformation de la position x de l’élément.	GraphicElement
		transformY : Number Point de transformation de la position y de l’élément.	GraphicElement
		transformZ : Number Point de transformation de la position z de l’élément.	GraphicElement
		verticalCenter : Object Distance verticale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage.	GraphicElement
		visible : Boolean Contrôle la visibilité de cet élément visuel.	GraphicElement
		width : Number Largeur de l’élément graphique.	GraphicElement
		winding : String Règle de remplissage d’intersection ou de chevauchement de segments de chemin.	Path
		x : Number Position x de l’élément graphique.	GraphicElement
		y : Number Position y de l’élément graphique.	GraphicElement
		z : Number Position z de l’élément graphique.	GraphicElement

Propriétés protégées

Masquer les propriétés protégées héritées

Afficher les propriétés protégées héritées

	Propriété		Défini par
		drawnDisplayObject : DisplayObject [lecture seule] Objet DisplayObject actuel, sur lequel est tracé l’élément GraphicElement.	GraphicElement
		drawX : Number [lecture seule] Position x où l’élément doit être tracé.	GraphicElement
		drawY : Number [lecture seule] Position y où l’élément doit être tracé.	GraphicElement
		hasComplexLayoutMatrix : Boolean [lecture seule] Renvoie true si la classe GraphicElement possède des propriétés de transformation de non-translation (x,y)	GraphicElement
		layoutFeatures : AdvancedLayoutFeatures Contiennent tous les détails d’implémentation relatifs à la manière dont l’objet GraphicElement implémente la prise en charge de transformation et de présentation.	GraphicElement
		needsDisplayObject : Boolean [lecture seule] La valeur est true si l’élément requiert un objet DisplayObject exclusif.	GraphicElement

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		Path() Constructeur.	Path
		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.	EventDispatcher
		canShareWithNext(element:IGraphicElement):Boolean Renvoie true si cette classe IGraphicElement est compatible et peut partager des objets d’affichage avec la classe IGraphicElement suivante dans la séquence.	GraphicElement
		canShareWithPrevious(element:IGraphicElement):Boolean Renvoie true si cette classe IGraphicElement est compatible et peut partager des objets d’affichage avec la classe IGraphicElement précédente dans la séquence.	GraphicElement
		createDisplayObject():DisplayObject Crée un nouvel objet DisplayObject où cet élément IGraphicElement est tracé.	GraphicElement
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number [override] Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée.	Path
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number [override] Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée.	Path
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur de présentation de l’élément.	GraphicElement
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur de la présentation de l’élément.	GraphicElement
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran.	GraphicElement
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran.	GraphicElement
		getLayoutMatrix():Matrix Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères.	GraphicElement
		getLayoutMatrix3D():Matrix3D Renvoie la matrice Matrix3D de transformation de présentation pour cet élément.	GraphicElement
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur maximale de l’élément.	GraphicElement
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur maximale de l’élément.	GraphicElement
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur minimale de l’élément.	GraphicElement
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur minimale de l’élément.	GraphicElement
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur préférée de l’élément.	GraphicElement
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur préférée de l’élément.	GraphicElement
		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.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		initialized(document:Object, id:String):void Appelée automatiquement par le compilateur MXML lorsqu’une instance GraphicElement est créée en utilisant une balise MXML.	GraphicElement
		invalidateDisplayList():void L’appel de cette méthode provoque l’appel de la méthode validateDisplayList() de l’élément avant le rendu de la liste d’affichage.	GraphicElement
		invalidateLayoutDirection():void Un élément doit appeler cette méthode lorsque la direction de la mise en forme change ou lorsque la direction de la mise en forme de son parent change.	GraphicElement
		invalidateProperties():void L’appel de cette méthode provoque l’appel de la méthode validateProperties() de l’élément avant le rendu de la liste d’affichage.	GraphicElement
		invalidateSize():void L’appel de cette méthode provoque l’appel de la méthode validateSize() de l’élément avant le rendu de la liste d’affichage.	GraphicElement
		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
		localToGlobal(point:Point):Point Convertit l’objet point des coordonnées de l’objet (locales) vers les coordonnées de la scène (globales).	GraphicElement
		parentChanged(value:IGraphicElementContainer):void Appelé par l’objet IGraphicElementContainer lorsqu’un élément IGraphicElement est ajouté ou supprimé à partir du composant hôte.	GraphicElement
		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.	EventDispatcher
		setLayoutBoundsPosition(newBoundsX:Number, newBoundsY:Number, postLayoutTransform:Boolean = true):void Définit les coordonnées utilisées par l’élément pour son affichage à l’écran.	GraphicElement
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void Définit la taille de la présentation de l’élément.	GraphicElement
		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.	GraphicElement
		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.	GraphicElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		setSharedDisplayObject(sharedDisplayObject:DisplayObject):Boolean Détermine si cet élément peut ou non se tracer lui-même sur l’objet sharedDisplayObject de la séquence.	GraphicElement
		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
		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.	GraphicElement
		transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void Méthode utilitaire permettant de transformer un point spécifié dans les coordonnées locales de cet objet en emplacement dans les coordonnées du parent de l’objet.	GraphicElement
		validateDisplayList():void Appelé par l’objet IGraphicElementContainer pour retracer cet élément dans sa propriété displayObject.	GraphicElement
		validateNow():void Valide et met à jour les propriétés et la mise en forme de cet objet en appelant immédiatement les méthodes validateProperties(), validateSize() et validateDisplayList() lorsque cela est nécessaire.	GraphicElement
		validateProperties():void Utilisé par la logique de présentation pour valider les propriétés d’un composant par l’appel de la méthode commitProperties().	GraphicElement
		validateSize():void Appelé par l’objet IGraphicElementContainer pour valider la taille de cet élément.	GraphicElement
		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é.	EventDispatcher

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
		beginDraw(g:Graphics):void [override] Définissez le traçage de cet élément.	FilledElement
		canSkipMeasurement():Boolean Détermine si l’appel à la méthode measure() peut être ignoré.	GraphicElement
		commitProperties():void Traite le jeu de propriétés sur l’élément.	GraphicElement
		draw(g:Graphics):void [override] Tracer l’élément.	Path
		endDraw(g:Graphics):void [override] Finalisez le traçage de cet élément.	Path
		getStrokeExtents(postLayoutTransform:Boolean = true):Rectangle Renvoie la quantité de pixels occupée par le trait de chaque côté des limites de l’élément.	GraphicElement
		invalidateDisplayObjectSharing():void [override] Méthode d’utilitaire qui avertit l’hôte que cet élément a changé et que son calque doit être mis à jour.	Path
		invalidateParentSizeAndDisplayList():void Méthode d’assistance permettant d’invalider la taille du parent et la liste d’affichage si cet objet affecte sa présentation (includeInLayout est défini sur true).	GraphicElement
		measure():void [override] Calcule la taille par défaut de l’élément.	Path
		preferredHeightPreTransform():Number Utilisé pour l’implémentation de l’interface ILayoutElement ; renvoie la valeur explicite de la prétransformation de hauteur mesurée.	GraphicElement
		preferredWidthPreTransform():Number Utilisé pour l’implémentation de l’interface ILayoutElement ; renvoie la valeur explicite de la prétransformation de largeur mesurée.	GraphicElement
		transformHeightForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Transforme la taille de l’élément.	GraphicElement
		transformWidthForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Transforme la taille de l’élément.	GraphicElement
		updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void [override] Trace l’élément et/ou dimensionne et positionne son contenu.	StrokedElement

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Evénement		Synthèse	Défini par
		activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
		deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher

Détails de la propriété

data

propriété

data:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Chaîne contenant une représentation compacte des segments de chemin. Il s’agit d’une autre méthode permettant de définir la propriété segments. La définition de cette propriété remplace les valeurs stockées dans la propriété de tableau de segments.

La valeur est une chaîne séparée par des espaces décrivant chaque segment de chemin. Chaque entrée de segment possède un seul caractère qui indique le type de segment et deux ou plusieurs paramètres de segment.

Si la commande de segment est en majuscules, les paramètres sont des valeurs absolues. Si la commande de segment est en minuscules, les paramètres sont des valeurs relatives.

Le tableau suivant présente la syntaxe des segments :

Type de segment	Commande	Paramètres	Exemple
Move	M/m	x y	`M 10 20` - Déplace la ligne sur 10, 20.
Ligne	L/l	x y	`L 50 30` - Ligne sur 50, 30.
Ligne horizontale	H/h	x	`H 40` = Ligne horizontale sur 40.
Ligne verticale	V/v	y	`V 100` - Ligne verticale sur 100.
QuadraticBezier	Q/q	controlX controlY x y	`Q 110 45 90 30` - Courbe sur 90, 30 avec le point de contrôle sur 110, 45.
CubicBezier	C/c	control1X control1Y control2X control2Y x y	`C 45 50 20 30 10 20` - Courbe sur 10, 20 avec le premier point de contrôle sur 45, 50 et le second point de contrôle sur 20, 30.
Fermer le chemin	Z/z	sans objet	Ferme le chemin.

La valeur par défaut est null.

Implémentation
public function get data():String
public function set data(value:String):void

winding

propriété

winding:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Règle de remplissage d’intersection ou de chevauchement de segments de chemin. Les valeurs possibles sont GraphicsPathWinding.EVEN_ODD ou GraphicsPathWinding.NON_ZERO.

La valeur par défaut est evenOdd.

Implémentation
public function get winding():String
public function set winding(value:String):void

Eléments de l’API associés

flash.display.GraphicsPathWinding

Détails du constructeur

()

Constructeur

public function Path()

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Constructeur.

Détails de la méthode

draw

()

méthode

override protected function draw(g:Graphics):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Tracer l’élément. Il s’agit de la seconde étape parmi les trois étapes effectuées pendant le processus de traçage. Remplacez cette méthode pour implémenter votre dessin. Le trait (et le remplissage, le cas échéant) ont été définis dans la méthode beginDraw(). Votre remplacement ne doit contenir que des appels à des méthodes de traçage, telles quemoveTo(), curveTo() et drawRect().

Paramètres

g:Graphics — Elément graphique à dessiner.

endDraw

()

méthode

override protected function endDraw(g:Graphics):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Finalisez le traçage de cet élément. Il s’agit de la dernière étape parmi les trois étapes effectuées pendant le processus de traçage. Dans cette étape, les remplissages sont fermés.

Paramètres

g:Graphics — Elément graphique pour terminer le traçage.

getBoundsXAtSize

()

méthode

override 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.

getBoundsYAtSize

()

méthode

override 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.

invalidateDisplayObjectSharing

()

méthode

override protected function invalidateDisplayObjectSharing():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 qui avertit l’hôte que cet élément a changé et que son calque doit être mis à jour.

measure

()

méthode

override protected function measure():void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Calcule la taille par défaut de l’élément. Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de l’objet GraphicElement.

Vous n’appelez pas cette méthode directement. Flex appelle la méthode measure() lorsque l’élément est ajouté à un conteneur IGraphicElementContainer tel que Group par le biais de la méthode addElement() et lorsque la méthode invalidateSize() de l’élément est appelée.

Par défaut, vous définissez une hauteur et une largeur explicites d’un élément, et Flex n’appelle pas la méthode measure(), même si vous appelez explicitement la méthode invalidateSize(). Pour remplacer ce comportement, remplacez la méthode skipMeasure().

Dans votre remplacement de cette méthode, vous devez définir les propriétés measuredWidth et measuredHeight pour définir la taille par défaut. Si vous le souhaitez, vous pouvez définir les propriétés measuredX et measuredY pour définir le coin supérieur gauche des limites mesurées par défaut par rapport à l’origine de l’élément.

Le point de mesure conceptuel de la méthode measure() permet à l’élément de fournir ses propres limites naturelles ou intrinsèques comme valeur par défaut. Par conséquent, les propriétés measuredWidth et measuredHeight doivent être déterminées par des facteurs comme :

La quantité de texte que le composant doit afficher.
La taille d’une image JPEG affichée par le composant.

Dans certains cas, aucune méthode intrinsèque ne permet de déterminer les valeurs par défaut. Par exemple, la méthode measure() d’un élément GreenCircle simple peut simplement définir measuredWidth = 100 et measuredHeight = 100 pour indiquer une taille par défaut raisonnable. Dans d’autres cas, comme le contrôle TextArea, un calcul approprié (comme rechercher la hauteur et la largeur correctes qui permettront d’afficher tout le texte et respecteront les proportions d’un rectangle d’or) peut s’avérer trop long pour que cela en vaille la peine.

L’implémentation par défaut de measure() définit les valeurs des propriétés measuredWidth, measuredHeight, measuredX et measuredY sur 0.

Exemples Comment utiliser cet exemple

ArrowExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- ArrowExample.mxml -->
<s:Application name="ArrowExample"
        xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/mx">

    <s:Panel title="Arrow Graphic Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <s:Group left="10" right="10" top="10" bottom="10">
            
            <s:Graphic x="100" y="0">
                <!-- Use Use compact syntax with absolute coordinates. -->
                <s:Path data="M 20 0 
                        C 50 0 50 35 20 35
                        L 15 35 
                        L 15 45 
                        L 0 32 
                        L 15 19 
                        L 15 29 
                        L 20 29 
                        C 44 29 44 6 20 6">
                    <!-- Define the border color of the arrow. -->
                    <s:stroke>
                        <s:SolidColorStroke color="0x888888"/>
                    </s:stroke>
                    <!-- Define the fill for the arrow. -->
                    <s:fill>
                        <s:LinearGradient rotation="90">
                            <s:GradientEntry color="0x000000" alpha="0.8"/>
                            <s:GradientEntry color="0xFFFFFF" alpha="0.8"/>
                        </s:LinearGradient>
                    </s:fill>
                </s:Path>
            </s:Graphic>

            <s:Graphic x="200" y="0">
                <!-- Use compact syntax with relative coordinates. -->
                <s:Path data="m 20 0 
                        c 30 0 30 35 0 35 
                        l -5 0
                        l 0 10
                        l -15 -13
                        l 15 -13
                        l 0 10
                        l 5 0
                        c 24 0 24 -23 0 -23">
                    <!-- Define the border color of the arrow. -->
                    <s:stroke>
                        <s:SolidColorStroke color="0x888888"/>
                    </s:stroke>
                    <!-- Define the fill for the arrow. -->
                    <s:fill>
                        <s:LinearGradient rotation="90">
                            <s:GradientEntry color="0x000000" alpha="0.8"/>
                            <s:GradientEntry color="0xFFFFFF" alpha="0.8"/>
                        </s:LinearGradient>
                    </s:fill>
                </s:Path>
            </s:Graphic>
        </s:Group>
    </s:Panel>

</s:Application>

Informations juridiques | Politique de confidentialité en ligne

Path - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package spark.primitives

data

winding

Path

draw

endDraw

getBoundsXAtSize

getBoundsYAtSize

invalidateDisplayObjectSharing

measure