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

Package	flash.display
Classe	public final class CapsStyle
Héritage	CapsStyle Object

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9

La classe CapsStyle est une énumération de valeurs constantes qui spécifient le style d’extrémité à utiliser pour tracer les lignes. Ces constantes sont utilisées en tant que valeurs du paramètre caps dans la méthode flash.display.Graphics.lineStyle(). Vous pouvez spécifier les trois types d’extrémités suivants :

Les trois types d’extrémités : NONE, ROUND et SQUARE.

Consulter les exemples

Eléments de l’API associés

flash.display.Graphics.lineStyle()

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
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		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
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		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

Constantes publiques

	Constante		Défini par
		NONE : String = "none" [statique] Permet de ne pas employer d’extrémités à l’aide du paramètre caps de la méthode flash.display.Graphics.lineStyle().	CapsStyle
		ROUND : String = "round" [statique] Permet de spécifier les extrémités arrondies du paramètre caps de la méthode flash.display.Graphics.lineStyle().	CapsStyle
		SQUARE : String = "square" [statique] Permet de spécifier les extrémités carrées du paramètre caps de la méthode flash.display.Graphics.lineStyle().	CapsStyle

Détails de la constante

NONE

Constante

public static const NONE:String = "none"

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9

Permet de ne pas utiliser d’extrémités à l’aide du paramètre caps de la méthode flash.display.Graphics.lineStyle().

ROUND

Constante

public static const ROUND:String = "round"

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9

Permet de spécifier les extrémités arrondies du paramètre caps de la méthode flash.display.Graphics.lineStyle().

SQUARE

Constante

public static const SQUARE:String = "square"

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9

Permet de spécifier des extrémités carrées à l’aide du paramètre caps de la méthode flash.display.Graphics.lineStyle().

Exemples Comment utiliser cet exemple

CapsStyleExample.as

L’exemple suivant utilise la classe CapsStyleExample pour dessiner trois lignes parallèles, chacune disposant d’un style d’extrémité de ligne différent.

Les propriétés de chaque ligne sont définies comme suit :
- La longueur de ligne est définie sur 80 pixels.
- La couleur de la bordure est définie sur orange.
- La taille de la bordure est définie sur 30 pixels.
- La couleur de surbrillance est définie sur gris.
- La taille de la surbrillance est définie sur 0 pixel.
- La valeur alpha est définie sur 1, ce qui rend la couleur unie.
- L’index de lissage des pixels est défini sur false (les traits ne sont pas transformés en pixels).
- Le mode de mise à l’échelle de la ligne est défini sur normal. Ce mode porte sur l’épaisseur de la ligne.
- Le style de liaison des extrémités de la bordure est défini sur MITER.
- La limite de pointe est définie sur 1, ce qui signifie que la pointe est coupée près de la ligne.
Le constructeur de classe crée trois lignes verticales, qui commencent à x = 0, y = 0 en appelant la méthode drawLine() trois fois à l’aide de trois styles d’extrémité de ligne différents (none, round et square). Ces trois types d’appel de la méthode drawLine() utilisent le style d’extrémité et les propriétés énumérés précédemment pour dessiner une ligne verticale et la surbrillance de ligne correspondante. Les appels créent tout d’abord un objet Shape, child, puis exploite les méthodes de la classe Graphics pour définir le style de ligne et dessiner les lignes et les surbrillances. Chaque occurrence de child s’ajoute à la liste d’affichage et est dessinée sur la scène.
Les segments de ligne connectés sont redessinés avec la méthode refreshLayout() à y = 80 pixels et commence à x = 80 pixels, avec une séparation de 25 pixels entre les segments de ligne.

package {
    import flash.display.CapsStyle;
    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 CapsStyleExample extends Sprite {
        private var lineLength:uint            = 80;
        private var borderColor:uint           = 0xFFCC00;
        private var borderSize:uint            = 30;
        private var highlightColor:uint        = 0x666666;
        private var highlightSize:uint         = 0;
        private var gutter:uint                = 25;
        private var borderAlpha:uint           = 1;
        private var borderPixelHinting:Boolean = false;
        private var borderScaleMode:String     = LineScaleMode.NORMAL;
        private var borderJointStyle:String    = JointStyle.MITER;
        private var borderMiterLimit:uint      = 1;

        public function CapsStyleExample() {
            drawLine(CapsStyle.NONE);
            drawLine(CapsStyle.ROUND);
            drawLine(CapsStyle.SQUARE);
            refreshLayout();
        }

        private function drawLine(capsStyle:String):void {
            var child:Shape = new Shape();
            child.graphics.lineStyle(borderSize,
                                     borderColor,
                                     borderAlpha,
                                     borderPixelHinting,
                                     borderScaleMode,
                                     capsStyle,
                                     borderJointStyle,
                                     borderMiterLimit);
            child.graphics.lineTo(0, 0);
            child.graphics.lineTo(0, lineLength);
            child.graphics.endFill();

            child.graphics.moveTo(0, 0);
            child.graphics.lineStyle(highlightSize, highlightColor);
            child.graphics.lineTo(0, 0);
            child.graphics.lineTo(0, lineLength);

            addChild(child);
        }

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

Informations juridiques | Politique de confidentialité en ligne

CapsStyle - AS3

Classes x

NONE

ROUND

SQUARE