Package | spark.core |
Interface | public interface IGraphicElement extends IVisualElement , ILayoutElement , ILayoutDirectionElement , IEventDispatcher |
Implémenteurs | GraphicElement |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
IGraphicElementContainer
parent.
Un exemple d’utilisation standard est le partage DisplayObject. classe Group, qui implémente la classe IGraphicElementContainer
, organise ses enfants IGraphicElement en séquences qui partagent et tracent dans la même classe DisplayObject. L’objet DisplayObject est créé par le premier élément dans la séquence.
Autre exemple d’utilisation : un élément ne provient pas de l’objet DisplayObject mais met à jour, crée et/ou détruit son propre objet DisplayObject. La classe IGraphicElementContainer
appelle l’élément afin de créer la classe DisplayObject, ajouter la classe DisplayObject comme son enfant à l’index correct et gérer sa suppression.
Généralement, vous étendez la classe GraphicElement au lieu d’implémenter directement l’interface IGraphciElement. La classe GraphicElement fournit déjà la plupart des fonctionnalités requises.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
alpha : Number
Indique la valeur de transparence alpha de l’objet spécifié. | IVisualElement | ||
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 | ||
depth : Number
Détermine l’ordre dans lequel les éléments sont rendus au sein des conteneurs. | IVisualElement | ||
designLayer : DesignLayer
Spécifie l’instance DesignLayer facultative associée à cet élément visuel. | IVisualElement | ||
displayObject : DisplayObject [lecture seule]
Objet DisplayObject partagé où cet élément IGraphicElement est tracé. | IGraphicElement | ||
displayObjectSharingMode : String
Indique l’association entre cette interface IGraphicElement et ses objets d’affichage. | IGraphicElement | ||
hasLayoutMatrix3D : Boolean [lecture seule]
Contient true si l’élément possède une matrice 3D. | ILayoutElement | ||
height : Number
Indique la hauteur de l’objet d’affichage, en pixels. | IVisualElement | ||
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 | ||
is3D : Boolean [lecture seule]
Contient true lorsque l’élément est en 3D. | IVisualElement | ||
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). | ILayoutDirectionElement | ||
left : Object
Distance horizontale en pixels du bord gauche du composant au bord gauche de la cible d’ancrage. | ILayoutElement | ||
owner : DisplayObjectContainer
Propriétaire de cet objet IVisualElement. | IVisualElement | ||
parent : DisplayObjectContainer [lecture seule]
Conteneur ou composant parent de ce composant. | IVisualElement | ||
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 | ||
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. | IVisualElement | ||
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 | ||
visible : Boolean
Contrôle la visibilité de cet élément visuel. | IVisualElement | ||
width : Number
Indique la largeur de l’objet d’affichage, en pixels. | IVisualElement | ||
x : Number
Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. | IVisualElement | ||
y : Number
Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. | IVisualElement |
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 | ||
Renvoie true si cette classe IGraphicElement est compatible et peut partager des objets d’affichage avec la classe IGraphicElement suivante dans la séquence. | IGraphicElement | ||
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. | IGraphicElement | ||
Crée un nouvel objet DisplayObject où cet élément IGraphicElement est tracé. | IGraphicElement | ||
Distribue un événement dans le flux d’événements. | IEventDispatcher | ||
Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée. | ILayoutElement | ||
Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée. | ILayoutElement | ||
Renvoie la hauteur de présentation de l’élément. | ILayoutElement | ||
Renvoie la largeur de la présentation de l’élément. | ILayoutElement | ||
Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran. | ILayoutElement | ||
Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran. | ILayoutElement | ||
Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères. | ILayoutElement | ||
Renvoie la matrice Matrix3D de transformation de présentation pour cet élément. | ILayoutElement | ||
Renvoie la hauteur maximale de l’élément. | ILayoutElement | ||
Renvoie la largeur maximale de l’élément. | ILayoutElement | ||
Renvoie la hauteur minimale de l’élément. | ILayoutElement | ||
Renvoie la largeur minimale de l’élément. | ILayoutElement | ||
Renvoie la hauteur préférée de l’élément. | ILayoutElement | ||
Renvoie la largeur préférée de l’élément. | ILayoutElement | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | IEventDispatcher | ||
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. | ILayoutDirectionElement | ||
Appelé par l’objet IGraphicElementContainer lorsqu’un élément IGraphicElement est ajouté ou supprimé à partir du composant hôte. | IGraphicElement | ||
Supprime un écouteur de l’objet EventDispatcher. | IEventDispatcher | ||
Définit les coordonnées utilisées par l’élément pour son affichage à l’écran. | ILayoutElement | ||
Définit la taille de la présentation de l’élément. | ILayoutElement | ||
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 | ||
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 | ||
Détermine si cet élément peut ou non se tracer lui-même sur l’objet sharedDisplayObject de la séquence. | IGraphicElement | ||
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 | ||
Appelé par l’objet IGraphicElementContainer pour retracer cet élément dans sa propriété displayObject. | IGraphicElement | ||
Appelé par l’objet IGraphicElementContainer pour valider les propriétés de cet élément. | IGraphicElement | ||
Appelé par l’objet IGraphicElementContainer pour valider la taille de cet élément. | IGraphicElement | ||
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 |
displayObject | propriété |
displayObject:DisplayObject
[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 |
Objet DisplayObject partagé où cet élément IGraphicElement est tracé.
Les implémenteurs ne doivent pas créer l’objet DisplayObject ici, mais dans la méthode createDisplayObject.
Implémentation
public function get displayObject():DisplayObject
Eléments de l’API associés
displayObjectSharingMode | propriété |
displayObjectSharingMode:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.5 |
Versions du moteur d’exécution: | Flash Player 10, AIR 2.5 |
Indique l’association entre cette interface IGraphicElement et ses objets d’affichage. L’objet IGraphicElementContainer
gère cette propriété et les valeurs correspondent à l’une des classes Enum DisplayObjectSharingMode.
- Une valeur de
DisplayObjectSharingMode.OWNS_UNSHARED_OBJECT
indique que l’interface possède exclusivement la classe DisplayObject correspondant à sa propriétédisplayObject
. - Une valeur de
DisplayObjectSharingMode.OWNS_SHARED_OBJECT
indique que l’interface IGraphicElement possède la classe DisplayObject correspondant à sa propriétédisplayObject
mais que d’autres interfaces IGraphicElement utilisent/tracent cet objet d’affichage également. En fonction de l’implémentation spécifique, l’interface IGraphicElement peut exécuter une certaine gestion de l’objet d’affichage. Par exemple, la classe de base GraphicElement supprime la transformation de l’objet d’affichage, réinitialise sa visibilité, alpha, etc. propriétés à leurs valeurs par défaut et supprime en outre les images sur tous les appelsvalidateDisplayList()
. - Une valeur de
DisplayObjectSharingMode.OWNS_SHARED_OBJECT
indique que l’interface IGraphicElement possède exclusivement la classe DisplayObject correspondant à sa propriétédisplayObject
. Il existe une ou plusieurs interfaces IGraphicElement qui se tracent dans le même objet displayObject et le premier élément qui trace a son mode défini surDisplayObjectMode.OWNS_SHARED_OBJECT
Implémentation
public function get displayObjectSharingMode():String
public function set displayObjectSharingMode(value:String):void
canShareWithNext | () | méthode |
public function canShareWithNext(element:IGraphicElement):Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie true
si cette classe IGraphicElement est compatible et peut partager des objets d’affichage avec la classe IGraphicElement suivante dans la séquence.
Paramètres
element:IGraphicElement — Elément venant après cet élément dans la séquence.
|
Boolean — Renvoie true lorsque cet élément est compatible avec l’élément précédent dans la séquence.
|
Eléments de l’API associés
canShareWithPrevious | () | méthode |
public function canShareWithPrevious(element:IGraphicElement):Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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.
Dans certains cas, l’élément peut être transmis à l’objet IGraphicElementContainer
dans un appel à la méthode setSharedDisplayObject()
. Dans ces cas, cette méthode n’est pas appelée.
Paramètres
element:IGraphicElement — Elément venant avant cet élément dans la séquence.
|
Boolean — Renvoie true lorsque cet élément est compatible avec l’élément précédent dans la séquence.
|
Eléments de l’API associés
createDisplayObject | () | méthode |
public function createDisplayObject():DisplayObject
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Crée un nouvel objet DisplayObject où cet élément IGraphicElement est tracé.
Les appels suivants à l’accesseur Get de la propriété displayObject
doivent renvoyer le même objet d’affichage.
Une fois la classe DisplayObject créée, la classe IGraphicElementContainer
parent transmet les objets d’affichage au reste des éléments dans la séquence.
La classe IGraphicElementContainer
garantit que cette méthode est appelée uniquement lorsque cela est nécessaire.
Si l’élément veut participer au partage de l’objet DisplayObject, le nouvel objet DisplayObject doit implémenter IShareableDisplayObject. Cette interface est utilisée par la classe IGraphicElementContainer
pour gérer l’invalidation et le retraçage de la séquence d’éléments graphiques et n’est généralement pas directement utilisée par le développeur.
Pour réévaluer les séquences partagées, appelez la méthode invalidateGraphicElementSharing()
sur l’objet IGraphicElementContainer
.
Pour forcer l’objet IGraphicElementContainer
à supprimer la classe DisplayObject actuelle de l’élément de sa liste d’affichage et à recalculer le partage des objets d’affichage, appelez la méthode discardDisplayObject()
sur l’objet IGraphicElementContainer
.
DisplayObject — Objet d’affichage créé.
|
Eléments de l’API associés
parentChanged | () | méthode |
public function parentChanged(parent:IGraphicElementContainer):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Appelé par l’objet IGraphicElementContainer
lorsqu’un élément IGraphicElement est ajouté ou supprimé à partir du composant hôte.
En règle générale, vous n’avez pas besoin d’appeler cette méthode.
Paramètres
parent:IGraphicElementContainer — L’objet IGraphicElementContainer de cet élément IGraphicElement .
|
setSharedDisplayObject | () | méthode |
public function setSharedDisplayObject(sharedDisplayObject:DisplayObject):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 cet élément peut ou non se tracer lui-même sur l’objet sharedDisplayObject
de la séquence.
En général, les implémenteurs renvoient true
lorsque cet objet IGraphicElement peut se tracer de manière cumulée dans la propriété graphics
de l’objet DisplayObject partagé. Dans tous les cas où cet objet IGraphicElement doit définir sur les objets DisplayObject des propriétés ne s’appliquant pas au reste des éléments de la séquence, cette méthode doit renvoyer false
. Par exemple, il peut s’agit des propriétés rotation, scale, transform, mask, alpha, filters, color transform, 3D et layer.
Lorsque cette méthode renvoie true
, les appels suivants à l’accesseur Get de la propriété displayObject
doivent renvoyer le même objet d’affichage.
Dans certains cas, la propriété sharedDisplayObject
peut être l’objet IGraphicElementContainer
lui-même. Dans les autres cas, l’objet DisplayObject est créé par le premier élément de la séquence.
Lorsque cet élément IGraphicElement doit régénérer sa séquence, il avertit l’objet IGraphicElementContainer
en appelant sa méthode invalidateGraphicElementSharing()
.
Paramètres
sharedDisplayObject:DisplayObject — Objet DisplayObject partagé.
|
Boolean — Renvoie true lorsque cet objet IGraphicElement peut se tracer lui-même sur l’objet DisplayObject partagé de la séquence.
|
Eléments de l’API associés
validateDisplayList | () | méthode |
public function validateDisplayList():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Appelé par l’objet IGraphicElementContainer
pour retracer cet élément dans sa propriété displayObject
.
Si l’élément est le premier dans la séquence (displayObjectSharingMode
est défini sur DisplayObjectSharingMode.OWNS_SHARED_OBJECT
) il doit alors supprimer les graphiques de l’objet displayObject
et les configurer au besoin pour tracer le reste des éléments.
L’élément doit toujours être redessiné même s’il n’a pas été modifié depuis le dernier appel de la méthode validateDisplayList()
. L’objet IGraphicElementContainer
parent retracera l’ensemble de la séquence si l’un quelconque de ses éléments a besoin d’être retracé.
Pour que cette méthode soit appelée, notifiez l’objet IGraphicElementContainer
en appelant sa méthode invalidateGraphicElementSize()
.
Cette méthode peut être appelée même si cet élément n’a pas notifié l’objet IGraphicElementContainer
.
Eléments de l’API associés
validateProperties | () | méthode |
public function validateProperties():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Appelé par l’objet IGraphicElementContainer
pour valider les propriétés de cet élément.
Pour garantir que cette méthode soit appelée, notifiez l’objet IGraphicElementContainer
en appelant sa méthode invalidateGraphicElementProperties()
.
Cette méthode peut être appelée même si cet élément n’a pas notifié l’objet IGraphicElementContainer
.
Eléments de l’API associés
validateSize | () | méthode |
public function validateSize():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Appelé par l’objet IGraphicElementContainer
pour valider la taille de cet élément.
Lorsque la taille de l’élément change et est sur le point d’affecter la présentation de l’objet IGraphicElementContainer
, il incombe à l’implémenteur d’invalider la taille et la liste d’affichage du parent.
Pour garantir que cette méthode soit appelée, notifiez l’objet IGraphicElementContainer
en appelant sa méthode invalidateGraphicElementSize()
.
Cette méthode peut être appelée même si cet élément n’a pas notifié l’objet IGraphicElementContainer
.
Eléments de l’API associés
Tue Jun 12 2018, 09:30 AM Z