Shape

Package	flash.display
Classe	public class Shape
Héritage	Shape DisplayObject EventDispatcher Object
Sous-classes	FlexShape

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Cette classe sert à créer des formes légères par le biais de l’interface de programmation d’applications (API) de dessin ActionScript. Cette classe comprend une propriété graphics, qui vous permet d’accéder aux méthodes de la classe Graphics.

La classe Sprite comporte également une propriété graphics, ainsi que d’autres fonctions exclues de la classe Shape. Par exemple, un objet Sprite est un conteneur d’objet d’affichage, ce qui n’est pas le cas d’un objet Shape (qui ne peut pas contenir d’objets d’affichage enfant). De ce fait, les objets Shape consomment moins de mémoire que les objets Sprite qui contiennent les mêmes images. Néanmoins, un objet Sprite prend en charge les événements de saisie utilisateur, ce qui n’est pas le cas d’un objet Shape.

Consulter les exemples

Informations complémentaires

Programmation de l’affichage
Concepts fondamentaux de la programmation de l’affichage
Classes d’affichage de base
Principes de base de l’API de dessin

Eléments de l’API associés

flash.display.Graphics
flash.display.Sprite

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
		accessibilityProperties : AccessibilityProperties Options d’accessibilité actuelles de l’objet d’affichage.	DisplayObject
		alpha : Number Indique la valeur de transparence alpha de l’objet spécifié.	DisplayObject
		blendMode : String Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser.	DisplayObject
		blendShader : Shader [écriture seule] Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan.	DisplayObject
		cacheAsBitmap : Boolean Si la valeur true est définie, les moteurs d’exécution de Flash placent en mémoire cache une version bitmap interne de l’objet d’affichage.	DisplayObject
		cacheAsBitmapMatrix : Matrix S’il n’est pas nul, cet objet Matrix définit le mode de rendu d’un objet d’affichage lorsque cacheAsBitmap est définie sur true.	DisplayObject
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		filters : Array Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage.	DisplayObject
		graphics : Graphics [lecture seule] Spécifie l’objet Graphics qui appartient à l’objet Shape qui prend en charge les commandes de dessin vectoriel.	Shape
		height : Number Indique la hauteur de l’objet d’affichage, en pixels.	DisplayObject
		loaderInfo : LoaderInfo [lecture seule] Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage.	DisplayObject
		mask : DisplayObject L’objet d’affichage appelant est masqué par l’objet mask spécifié.	DisplayObject
		metaData : Object Obtient les données d’objet de métadonnées de l’occurrence DisplayObject si les données d’meta a été stockée près de la l’occurrence de cette DisplayObject dans le fichier SWF à l’aide d’une balise de4 PlaceObject.	DisplayObject
		mouseX : Number [lecture seule] Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels.	DisplayObject
		mouseY : Number [lecture seule] Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels.	DisplayObject
		name : String Indique le nom d’occurrence de DisplayObject.	DisplayObject
		opaqueBackground : Object Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique.	DisplayObject
		parent : DisplayObjectContainer [lecture seule] Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage.	DisplayObject
		root : DisplayObject [lecture seule] Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété root correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier.	DisplayObject
		rotation : Number Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine.	DisplayObject
		rotationX : Number Indique la rotation de l’axe des x de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.	DisplayObject
		rotationY : Number Indique la rotation de l’axe des y de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.	DisplayObject
		rotationZ : Number Indique la rotation de l’axe des z de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.	DisplayObject
		scale9Grid : Rectangle Grille de mise à l’échelle en vigueur.	DisplayObject
		scaleX : Number Indique l’échelle horizontale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement.	DisplayObject
		scaleY : Number Indique l’échelle verticale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement.	DisplayObject
		scaleZ : Number Indique l’échelle de profondeur (pourcentage) de l’objet tel qu’elle est appliquée à partir du point d’alignement.	DisplayObject
		scrollRect : Rectangle Cadre de sélection du défilement de l’objet d’affichage.	DisplayObject
		stage : Stage [lecture seule] Scène de l’objet d’affichage.	DisplayObject
		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.	DisplayObject
		visible : Boolean Indique si l’objet d’affichage est visible ou non.	DisplayObject
		width : Number Indique la largeur de l’objet d’affichage, en pixels.	DisplayObject
		x : Number Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.	DisplayObject
		y : Number Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.	DisplayObject
		z : Number Indique la position de coordonnée z le long de l’axe des z de l’occurrence DisplayObject par rapport au conteneur 3D parent.	DisplayObject

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		Shape() Crée un objet Shape.	Shape
		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
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace.	DisplayObject
		getRect(targetCoordinateSpace:DisplayObject):Rectangle Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes.	DisplayObject
		globalToLocal(point:Point):Point Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales).	DisplayObject
		globalToLocal3D(point:Point):Vector3D Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales).	DisplayObject
		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
		hitTestObject(obj:DisplayObject):Boolean Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage obj.	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y.	DisplayObject
		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
		local3DToGlobal(point3d:Vector3D):Point Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales).	DisplayObject
		localToGlobal(point:Point):Point Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales).	DisplayObject
		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
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		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
		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

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

	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
added	Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage.	DisplayObject
addedToStage	Envoyé lorsqu’un objet d’affichage est ajouté dans la liste d’affichage de la scène, directement ou par l’intermédiaire d’une arborescence secondaire qui contient l’objet d’affichage.	DisplayObject
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
enterFrame	[événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image.	DisplayObject
exitFrame	[événement de diffusion] Distribué lorsque la tête de lecture quitte l’image en cours.	DisplayObject
frameConstructed	[événement de diffusion] Distribué après l’exécution des constructeurs des objets d’affichage d’image, mais avant celle des scripts d’image.	DisplayObject
removed	Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage.	DisplayObject
removedFromStage	Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage de la scène, directement ou par l’intermédiaire de la suppression d’une arborescence secondaire qui contient l’objet d’affichage.	DisplayObject
render	[événement de diffusion] Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et restituée.	DisplayObject

Détails de la propriété

graphics

propriété

graphics:Graphics [lecture seule]

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Spécifie l’objet Graphics qui appartient à l’objet Shape qui prend en charge les commandes de dessin vectoriel.

Implémentation
public function get graphics():Graphics

Détails du constructeur

()

Constructeur

public function Shape()

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Crée un objet Shape.

Exemples Comment utiliser cet exemple

ShapeExample.as

L’exemple suivant utilise la classe ShapeExample pour dessiner un cercle, un rectangle arrondi et un carré. Pour ce faire, procédez comme suit :

Elle déclare la propriété size qui servira par la suite à déterminer la taille de chaque forme.
Elle déclare les propriétés qui définissent la couleur de fond sur orange, la couleur de bordure sur gris foncé, la taille de la bordure sur 0 pixel, le rayon de l’angle sur 9 pixels et définit l’espace entre le bord de la scène et les autres objets sur 5 pixels.
Utilisez les propriétés déclarées au cours des étapes précédentes, ainsi que les méthodes intégrées de la classe Graphics pour dessiner le cercle, le rectangle arrondi et le carré aux coordonnées x = 0, y = 0.
Elle redessine les formes situées le long de la partie supérieure de la scène, en commençant par x = 5, y = 5, avec un espacement de 5 pixels entre les formes à l’aide de la méthode refreshLayout().

package {
    import flash.display.DisplayObject;
    import flash.display.Graphics;
    import flash.display.JointStyle;
    import flash.display.LineScaleMode;
    import flash.display.Shape;
    import flash.display.Sprite;

    public class ShapeExample extends Sprite {
        private var size:uint           = 80;
        private var bgColor:uint       = 0xFFCC00;
        private var borderColor:uint  = 0x666666;
        private var borderSize:uint   = 0;
        private var cornerRadius:uint = 9;
        private var gutter:uint       = 5;

        public function ShapeExample() {
            doDrawCircle();
            doDrawRoundRect();
            doDrawRect();
            refreshLayout();
        }

        private function refreshLayout():void {
            var ln:uint = numChildren;
            var child:DisplayObject;
            var lastChild:DisplayObject = getChildAt(0);
            lastChild.x = gutter;
            lastChild.y = gutter;
            for (var i:uint = 1; i < ln; i++) {
                child = getChildAt(i);
                child.x = gutter + lastChild.x + lastChild.width;
                child.y = gutter;
                lastChild = child;
            }
        }

        private function doDrawCircle():void {
            var child:Shape = new Shape();
            var halfSize:uint = Math.round(size/2);
            child.graphics.beginFill(bgColor);
            child.graphics.lineStyle(borderSize, borderColor);
            child.graphics.drawCircle(halfSize, halfSize, halfSize);
            child.graphics.endFill();
            addChild(child);
        }

        private function doDrawRoundRect():void {
            var child:Shape = new Shape();
            child.graphics.beginFill(bgColor);
            child.graphics.lineStyle(borderSize, borderColor);
            child.graphics.drawRoundRect(0, 0, size, size, cornerRadius);
            child.graphics.endFill();
            addChild(child);
        }

        private function doDrawRect():void {
            var child:Shape = new Shape();
            child.graphics.beginFill(bgColor);
            child.graphics.lineStyle(borderSize, borderColor);
            child.graphics.drawRect(0, 0, size, size);
            child.graphics.endFill();
            addChild(child);
        }
    }
}

Informations juridiques | Politique de confidentialité en ligne

Shape - AS3

Classes x

graphics

Shape