| Package | spark.primitives |
| Classe | public class Line |
| Héritage | Line  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 |
Le trait par défaut d’une ligne n’étant pas défini, si vous ne spécifiez pas le trait, la ligne est invisible.
Eléments de l’API associés
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 | |
| 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 | |
| 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 | |
| x : Number
Position x de l’élément graphique. | GraphicElement | |
| xFrom : Number
Position x de début de la ligne. | Line | ||
| xTo : Number
Position x de fin de la ligne. | Line | ||
| y : Number
Position y de l’élément graphique. | GraphicElement | |
| yFrom : Number
Position y de début de la ligne. | Line | ||
| yTo : Number
Position y de fin de la ligne. | Line | ||
| z : Number
Position z de l’élément graphique. | GraphicElement | |
Propriétés protégées
Méthodes publiques
| Méthode | Défini par | ||
|---|---|---|---|
Line()
Constructeur. | Line | ||
| 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 | |
|
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 | |
|
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 | |
|
Crée un nouvel objet DisplayObject où cet élément IGraphicElement est tracé. | GraphicElement | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée. | GraphicElement | |
|
Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée. | GraphicElement | |
|
Renvoie la hauteur de présentation de l’élément. | GraphicElement | |
|
Renvoie la largeur de la présentation de l’élément. | GraphicElement | |
|
Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran. | GraphicElement | |
|
Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran. | GraphicElement | |
|
Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères. | GraphicElement | |
|
Renvoie la matrice Matrix3D de transformation de présentation pour cet élément. | GraphicElement | |
|
Renvoie la hauteur maximale de l’élément. | GraphicElement | |
|
Renvoie la largeur maximale de l’élément. | GraphicElement | |
|
Renvoie la hauteur minimale de l’élément. | GraphicElement | |
|
Renvoie la largeur minimale de l’élément. | GraphicElement | |
|
Renvoie la hauteur préférée de l’élément. | GraphicElement | |
|
Renvoie la largeur préférée de l’élément. | GraphicElement | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Appelée automatiquement par le compilateur MXML lorsqu’une instance GraphicElement est créée en utilisant une balise MXML. | GraphicElement | |
|
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 | |
|
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 | |
|
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 | |
|
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 | |
|
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 | |
|
Convertit l’objet point des coordonnées de l’objet (locales) vers les coordonnées de la scène (globales). | GraphicElement | |
|
Appelé par l’objet IGraphicElementContainer lorsqu’un élément IGraphicElement est ajouté ou supprimé à partir du composant hôte. | GraphicElement | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
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 | |
|
Définit la taille de la présentation de l’élément. | GraphicElement | |
|
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 | |
|
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 | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Détermine si cet élément peut ou non se tracer lui-même sur l’objet sharedDisplayObject de la séquence. | GraphicElement | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
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 | |
|
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 | |
|
Appelé par l’objet IGraphicElementContainer pour retracer cet élément dans sa propriété displayObject. | GraphicElement | |
|
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 | |
|
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 | |
|
Appelé par l’objet IGraphicElementContainer pour valider la taille de cet élément. | GraphicElement | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
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
| Méthode | Défini par | ||
|---|---|---|---|
|
Définissez le traçage de cet élément. | StrokedElement | |
[override]
Détermine si l’appel à la méthode measure() peut être ignoré. | Line | ||
|
Traite le jeu de propriétés sur l’élément. | GraphicElement | |
[override]
Tracer l’élément. | Line | ||
|
Finalisez le traçage de cet élément. | StrokedElement | |
|
Renvoie la quantité de pixels occupée par le trait de chaque côté des limites de l’élément. | GraphicElement | |
|
Méthode d’utilitaire qui avertit l’hôte que cet élément a changé et que son calque doit être mis à jour. | GraphicElement | |
|
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 | |
[override]
Calcule la taille par défaut de l’élément. | Line | ||
|
Utilisé pour l’implémentation de l’interface ILayoutElement ; renvoie la valeur explicite de la prétransformation de hauteur mesurée. | GraphicElement | |
|
Utilisé pour l’implémentation de l’interface ILayoutElement ; renvoie la valeur explicite de la prétransformation de largeur mesurée. | GraphicElement | |
|
Transforme la taille de l’élément. | GraphicElement | |
|
Transforme la taille de l’élément. | GraphicElement | |
| [override]
Trace l’élément et/ou dimensionne et positionne son contenu. | StrokedElement | |
Evénements
Détails de la propriété
xFrom | propriété |
xTo | propriété |
yFrom | propriété |
yTo | propriété |
Détails du constructeur
Line | () | Constructeur |
public function Line()| 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
canSkipMeasurement | () | méthode |
override protected function canSkipMeasurement():Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Détermine si l’appel à la méthode measure() peut être ignoré.
Boolean — Renvoie true lorsque la méthode measureSizes() peut ignorer l’appel à la méthode measure(). Par exemple, la valeur est généralement la valeur true lorsque les propriétés explicitWidth et explicitHeight sont défini. Pour les chemins, la valeur est true lorsque les limites du chemin n’ont pas changé.
|
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.
|
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
LineExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- examples/LineExample.mxml -->
<s:Application
xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:mx="library://ns.adobe.com/flex/mx"
xmlns:s="library://ns.adobe.com/flex/spark">
<mx:Panel title="Line MXML Graphic Example"
height="75%" width="75%" layout="horizontal"
paddingTop="30" paddingBottom="10" paddingLeft="10" paddingRight="10">
<s:Group x="20" y="20">
<s:Line xFrom="0" xTo="0" yFrom="0" yTo="100">
<!-- Define the border color of the line. -->
<s:stroke>
<s:SolidColorStroke color="0x000000" weight="1" caps="square"/>
</s:stroke>
</s:Line>
<s:Line xFrom="6" xTo="6" yFrom="0" yTo="100">
<s:stroke>
<s:SolidColorStroke color="0x000000" weight="1" caps="square"/>
</s:stroke>
</s:Line>
<s:Line xFrom="12" xTo="12" yFrom="0" yTo="100">
<s:stroke>
<s:SolidColorStroke color="0x000000" weight="2" caps="square"/>
</s:stroke>
</s:Line>
<s:Line xFrom="20" xTo="20" yFrom="0" yTo="100">
<s:stroke>
<s:SolidColorStroke color="0x000000" weight="3" caps="square"/>
</s:stroke>
</s:Line>
<s:Line xFrom="30" xTo="30" yFrom="0" yTo="100">
<s:stroke>
<s:SolidColorStroke color="0x000000" weight="5" caps="square"/>
</s:stroke>
</s:Line>
<s:Line xFrom="43" xTo="43" yFrom="0" yTo="100">
<s:stroke>
<s:SolidColorStroke color="0x000000" weight="8" caps="square"/>
</s:stroke>
</s:Line>
<s:Line xFrom="58" xTo="58" yFrom="0" yTo="100">
<s:stroke>
<s:SolidColorStroke color="0x000000" weight="13" caps="square"/>
</s:stroke>
</s:Line>
<s:Line xFrom="84" xTo="84" yFrom="0" yTo="100">
<s:stroke>
<s:SolidColorStroke color="0x000000" weight="21" caps="square"/>
</s:stroke>
</s:Line>
<s:Line xFrom="123" xTo="123" yFrom="0" yTo="100">
<s:stroke>
<s:SolidColorStroke color="0x000000" weight="34" caps="square"/>
</s:stroke>
</s:Line>
</s:Group>
</mx:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z