GraphicElement  - AS3 Flex

Niveau de transparence de l’élément graphique. Les valeurs possibles sont les valeurs décimales comprises entre 0 (entièrement transparent) et 1 (entièrement opaque). Par exemple, une valeur de 0,25 signifie que l’élément a 25 % d’opacité.

Spécifie que cet objet GraphicElement doit être associé à sa propre classe DisplayObject et rendu dans cette dernière.

La valeur par défaut est false.

Distance verticale en pixels de la cible d’ancrage à la position de ligne de base du contrôle.

Par défaut, la cible d’ancrage est le bord supérieur de la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une ligne de contrainte.

La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « row1:10 ».

Coordonnée y de la ligne de base de la première ligne de texte du composant.

Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser.

La valeur par défaut est auto.

Eléments de l’API associés

Distance verticale en pixels du bord inférieur du composant au bord inférieur de la cible d’ancrage.

Par défaut, la cible d’ancrage est la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une ligne de contrainte.

La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « row1:10 ».

Détermine l’ordre dans lequel les éléments sont rendus au sein des conteneurs. Les conteneurs Spark organisent leurs éléments en fonction de leur propriété depth, avec la profondeur la plus basse à l’arrière-plan et la plus élevée à l’avant. Les éléments avec la même valeur de profondeur apparaissent dans leur ordre d’ajout au conteneur.

Spécifie l’instance DesignLayer facultative associée à cet élément visuel.

Lorsqu’un objet DesignLayer est affecté, un élément visuel doit prendre en compte la visibilité et la valeur alpha de son calque parent, lors de l’enregistrement de ses propres valeurs de visibilité ou alpha réelles sur son objet DisplayObject de sauvegarde (si applicable).

Un élément visuel doit écouter les notifications layerPropertyChange du calque parent associé. Lorsque la propriété effectiveAlpha ou effectiveVisibility est modifiée, l’élément doit ensuite calculer sa propre propriété de visibilité (ou alpha) et l’appliquer en conséquence.

Cette propriété ne doit pas être définie directement dans MXML.

La propriété designLayer n’est pas utilisée pour le contrôle de l’ordre de plan. Voir depth.

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.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

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 appels validateDisplayList().
• 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 sur DisplayObjectMode.OWNS_SHARED_OBJECT

Objet DisplayObject actuel, sur lequel est tracé l’élément GraphicElement. En règle générale, il équivaut à la propriété displayObject. Les sous-classes doivent exécuter les commandes de dessin de cette propriété plutôt que sur displayObject.

Position x où l’élément doit être tracé.

Position y où l’élément doit être tracé.

Nombre définissant la hauteur explicite du composant en pixels, dans les coordonnées du composant.

Eléments de l’API associés

Hauteur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est exprimée dans les coordonnées du composant, en pixels.

Eléments de l’API associés

Largeur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est exprimée dans les coordonnées du composant, en pixels.

Eléments de l’API associés

Hauteur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est exprimée dans les coordonnées du composant, en pixels.

Eléments de l’API associés

Largeur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est dans les coordonnées du composant, en pixels.

Eléments de l’API associés

Nombre définissant la largeur explicite du composant en pixels, dans les coordonnées du composant.

Eléments de l’API associés

Tableau indexé contenant tous les objets filtre actuellement associés à l’élément graphique. Le package mx.filters contient des classes qui définissent des filtres spécifiques.

L’accesseur Get propriété renvoie une copie du tableau de filtres. La valeur de la propriété filters ne peut être modifiée via le l’accesseur Set.

Eléments de l’API associés

Renvoie true si la classe GraphicElement possède des propriétés de transformation de non-translation (x,y)

Contient true si l’élément possède une matrice 3D.

Utilisez hasLayoutMatrix3D au lieu d’appeler et d’examiner la valeur renvoyée par la méthode getLayoutMatrix3D(), car cette méthode renvoie une matrice valide même lorsque l’élément est en 2D.

Hauteur de l’élément graphique.

La valeur par défaut est 0.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Distance horizontale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage.

La cible d’ancrage par défaut est le conteneur lui-même.

Dans les présentations avec contraintes avancées, la cible d’ancrage peut être une colonne de contrainte. Dans ce cas, la zone de contenu est l’espace entre la colonne précédente (ou le côté du conteneur) et la colonne cible.

Définir la propriété sur un nombre ou une chaîne numérique (par exemple, 10) spécifie l’utilisation de la cible d’ancrage par défaut.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « constraintColumnId:value ». Par exemple, « col1:10 ».

Identité du composant.

Spécifie si cet élément est inclus dans la présentation du parent.

La valeur par défaut est true.

Contient true lorsque l’élément est en 3D. L’élément peut être en 3D parce qu’il possède des propriétés de transformation 3D, des décalages de transformation 3D après la mise en forme ou les deux.

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). Cette propriété est généralement soutenue par un style héritable. Si sa valeur est null, le style layoutDirection est défini sur undefined. Les classes telles que GraphicElement, qui mettent en œuvre ILayoutDirectionElement mais ne prennent pas en charge les styles, doivent en outre prendre en charge la valeur null pour cette propriété, ce qui signifie que la direction de la mise en forme doit être héritée de son parent.

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. Dans la plupart des cas, il n’est normalement pas nécessaire de modifier cette propriété.

Distance horizontale en pixels du bord gauche du composant au bord gauche de la cible d’ancrage.

Par défaut, la cible d’ancrage est la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une colonne de contrainte.

La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « col1:10 ».

Propriété qui contrôle si le masque de luminosité écrête le contenu masqué. Cette propriété a un effet uniquement si un masque de type MaskType.LUMINOSITY a été appliqué à l’élément graphique.

La valeur par défaut est false.

Eléments de l’API associés

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é. Si elle est définie sur true, la valeur de couleur RVB d’un pixel dans le contenu source est inversée et multipliée par la région correspondante dans le masque. Si elle est définie sur false, la valeur de couleur RVB d’un pixel dans le contenu source est utilisée directement.

La valeur par défaut est false.

Eléments de l’API associés

L’objet d’affichage appelant est masqué par l’objet mask spécifié. Si l’objet d’affichage de masque n’est pas dans la liste d’affichage, il y est ajouté en tant qu’enfant de displayObject. L’objet mask en tant que tel n’est pas dessiné. Réglez mask sur null pour supprimer le masque. Pour utiliser une autre élément GraphicElement en tant que masque, enveloppez-le dans un objet Group ou un autre conteneur.

Eléments de l’API associés

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. Cela signifie qu’un masque n’affecte pas l’opacité d’un pixel dans le contenu source ; il ne modifie pas la valeur, si le pixel correspondant dans le masque possède une valeur alpha autre que zéro ou le rend complètement transparent, si la valeur alpha du pixel du masque est égale à zéro.

Lors de l’utilisation du masquage d’écrêtage, seul le chemin actuel ainsi que les vecteurs et les remplissages de forme définis par le masque sont utilisés pour déterminer l’effet sur le contenu source. Les traits et les filtres de bitmap définis sur le masque sont ignorés. Toute zone remplie du masque est considérée comme étant remplie et applique ce rendu au contenu source. Le type et les paramètres du remplissage ne sont pas pertinents ; une couleur en aplat, de dégradé ou un remplissage bitmap dans un masque s’appliquent au contenu source sous-jacent, quelles que soient les valeurs alpha du remplissage de masque.

Les objets BitmapGraphics sont traités comme des rectangles remplis de bitmaps lorsqu’ils sont utilisés dans un masque d’écrêtage. Par conséquent, la couche alpha du bitmap source n’est pas pertinente lorsqu’une partie d’un masque, le bitmap, affecte le masque de la même manière qu’un rectangle au remplissage uniforme de dimensions équivalentes.

Masquage alpha

En mode alpha, l’opacité de chaque pixel du contenu source est multipliée par l’opacité de la région correspondante du masque. Par exemple, un pixel du contenu source d’une opacité de 1 qui est masqué par une région d’opacité de .5 produira une opacité de .5. Un pixel source d’une opacité de .8 masqué par une région d’une opacité de .5 affichera une opacité de .4.

Conceptuellement parlant, le masquage alpha équivaut à restituer le masque et le contenu source transformés en surfaces RVBA distinctes et à multiplier la couche alpha du contenu du masque avec la couche alpha du contenu source. Tout le contenu du masque est rendu dans sa surface avant la composition dans la surface du contenu source. Par conséquent, tous les fonctionnalités FXG, comme les traits, les filtres de bitmap et l’opacité de remplissage affecte la composition finale du contenu.

Lorsque vous êtes en mode alpha, la composition de la couche alpha des données bitmap est effectuée normalement dans la couche alpha du masque et influe sur le rendu final du contenu. Cela est valable pour les chemins et les formes remplies de bitmaps BitmapGraphics.

Masquage de luminosité

Un masque de luminosité, parfois appelé « masque léger », fonctionne de manière analogue à un masque alpha, sauf que l’opacité et la valeur de couleur RVB d’un pixel dans le contenu source sont multipliées par l’opacité et la valeur de couleur RVB de la région correspondante dans le masque.

Conceptuellement parlant, le masquage de luminosité équivaut à restituer le masque et le contenu source transformés en surfaces RVBA distinctes et à multiplier la couche alpha et la valeur de couleur RVB du contenu du masque avec la couche alpha et la valeur de couleur RVB du contenu source. Tout le contenu du masque est rendu dans sa surface avant la composition dans la surface du contenu source. Par conséquent, tous les fonctionnalités FXG, comme les traits, les filtres de bitmap et l’opacité de remplissage affecte la composition finale du contenu.

Le masquage de luminosité n’est pas une fonctionnalité native de Flash, mais est disponible dans des outils Adobe Creative Suite tels qu’Adobe Illustrator et Adobe Photoshop. Pour obtenir l’effet visuel d’un masque de luminosité dans le contenu rendu par Flash, un élément graphique spécifiant un masque de luminosité instancie en fait un filtre Shader qui simule l’aspect visuel d’un masque de luminosité tel qu’il est rendu dans les outils Adobe Creative Suite.

Les objets masqués par des masques de luminosité peuvent définir des propriétés pour contrôler la valeur de couleur RVB et l’écrêtage du masque. Voir les attributs de luminosityInvert et luminosityClip.

La valeur par défaut est MaskType.CLIP.

Eléments de l’API associés

Hauteur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est exprimée dans les coordonnées du composant, en pixels. La valeur par défaut de cette propriété est définie par le développeur du composant.

Le développeur de composant utilise cette propriété pour définir une limite supérieure pour la hauteur du composant.

Si le développeur de l’application remplace la valeur par défaut de la propriété maxHeight, la nouvelle valeur est stockée dans la propriété explicitMaxHeight. La valeur par défaut de maxHeight ne change pas. Par conséquent, lors de la présentation, si maxHeight a été explicitement définie par le développeur de l’application, la valeur explicitMaxHeight est utilisée pour la hauteur maximale recommandée du composant. Si la propriété maxHeight n’est pas définie de façon explicite par l’utilisateur, la valeur par défaut est utilisée.

Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur maxHeight réelle par rapport à son parent est affectée par la propriété scaleY. Certains composants n’ont aucune limite théorique pour leur hauteur. Dans ces cas, leur propriété maxHeight est définie sur UIComponent.DEFAULT_MAX_HEIGHT.

Largeur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est exprimée dans les coordonnées du composant, en pixels. La valeur par défaut de cette propriété est définie par le développeur du composant.

Le développeur de composant utilise cette propriété pour définir une limite supérieure pour la largeur du composant.

Si le développeur de l’application remplace la valeur par défaut de la propriété maxWidth, la nouvelle valeur est stockée dans la propriété explicitMaxWidth. La valeur par défaut de maxWidth ne change pas. Par conséquent, lors de la présentation, si maxWidth a été explicitement définie par le développeur de l’application, la valeur explicitMaxWidth est utilisée pour la largeur maximale recommandée du composant. Si la propriété maxWidth n’est pas définie de façon explicite par l’utilisateur, la valeur par défaut est utilisée.

Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur maxWidth réelle par rapport à son parent est affectée par la propriété scaleX. Certains composants n’ont aucune limite théorique pour leur largeur. Dans ces cas, leur propriété maxWidth est définie sur UIComponent.DEFAULT_MAX_WIDTH.

Hauteur par défaut du composant, en pixels. Cette valeur est définie par la méthode measure().

Largeur par défaut du composant, en pixels. Cette valeur est définie par la méthode measure().

Coin supérieur gauche des limites mesurées par défaut par rapport à l’origine de l’élément.

Coin supérieur gauche des limites mesurées par défaut par rapport à l’origine de l’élément.

Hauteur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est dans les coordonnées du composant, en pixels. La valeur par défaut dépend de l’implémentation du composant.

Si le développeur de l’application définit la valeur de la propriété minHeight, la nouvelle valeur est stockée dans la propriété explicitMinHeight. La valeur par défaut de minHeight ne change pas. Par conséquent, lors de la présentation, si minHeight a été explicitement définie par le développeur de l’application, la valeur explicitMinHeight est utilisée pour la hauteur minimale recommandée du composant. Si la propriété minHeight n’est pas définie de façon explicite par le développeur de l’application, la valeur de la propriété measuredMinHeight est utilisée.

Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur minHeight réelle par rapport à son parent est affectée par la propriété scaleY.

Largeur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. Cette valeur est dans les coordonnées du composant, en pixels. La valeur par défaut dépend de l’implémentation du composant.

Si le développeur de l’application définit la valeur de la propriété minWidth, la nouvelle valeur est stockée dans la propriété explicitMinWidth. La valeur par défaut de minWidth ne change pas. Par conséquent, lors de la présentation, si minWidth a été explicitement définie par le développeur de l’application, la valeur explicitMinWidth est utilisée pour la largeur minimale recommandée du composant. Si la propriété minWidth n’est pas définie de façon explicite par le développeur de l’application, la valeur de la propriété measuredMinWidth est utilisée.

Cette valeur est utilisée par le conteneur lors du calcul de la taille et de la position du composant. Elle n’est pas utilisée par le composant lui-même pour déterminer sa taille par défaut. Ainsi, cette propriété peut n’avoir aucun effet si elle a pour parent un objet Container ou des conteneurs qui n’utilisent pas cette propriété comme facteur. Puisque la valeur est dans les coordonnées du composant, la valeur minWidth réelle par rapport à son parent est affectée par la propriété scaleX.

La valeur est true si l’élément requiert un objet DisplayObject exclusif. Les développeurs n’appelent généralement pas directement cette méthode, mais la remplacent dans leurs sous-classes pour indiquer qu’un objet DisplayObject exclusif est nécessaire. En règle générale, une sous-classe a besoin d’un objet DisplayObject lorsqu’elle doit définir ses propriétés. Voici quelques exemples de propriétés DisplayObject : filters, blendMode, mask, rotation, alpha.

Propriétaire de cet objet IVisualElement. Par défaut, il s’agit du parent de cet objet IVisualElement. Toutefois, si cet objet IVisualElement est un composant enfant déclenché par son parent, comme la liste déroulante d’un composant de commande ComboBox, le propriétaire est le composant ayant affiché cet objet IVisualElement.

Cette propriété n’est pas gérée par Flex, mais par chaque composant. Aussi, si vous utilisez la méthode PopUpManger.createPopUp() ou PopUpManger.addPopUp() pour afficher un composant enfant, définissez la propriété owner du composant enfant sur le composant l’ayant affiché.

La valeur par défaut est la valeur de la propriété parent.

Conteneur ou composant parent de ce composant. Seuls les éléments visuels doivent avoir une propriété parent. Les éléments non visuels doivent utiliser une autre propriété pour faire référence à l’objet auquel ils appartiennent. Par convention, les objets non visuels utilisent une propriété owner pour faire référence à l’objet auquel ils appartiennent.

Spécifie la hauteur d’un composant en tant que pourcentage de la taille de son parent. Valeurs autorisées : 0 à 100. Définir les propriétés height ou explicitHeight réinitialise cette propriété sur NaN.

Cette propriété renvoie une valeur numérique uniquement si elle a été précédemment définie. Elle ne reflète pas la taille exacte du composant en pourcentage.

Spécifie la largeur d’un composant en tant que pourcentage de la taille de son parent. Valeurs autorisées : 0 à 100. La valeur par défaut est NaN. La définition des valeurs width ou explicitWidth restaure cette propriété sur la valeur NaN.

Cette propriété renvoie une valeur numérique uniquement si elle a été précédemment définie. Elle ne reflète pas la taille exacte du composant en pourcentage.

Cette propriété est toujours définie sur NaN pour la commande UITextField.

Lorsqu’elle est utilisé avec des mises en forme Spark, cette propriété permet de calculer la largeur des limites du composant après la mise à l’échelle et la rotation. Par exemple, si le composant pivote à 90 degrés, le fait de spécifier percentWidth affecte la hauteur du composant.

Définit un ensemble de réglages pouvant être appliqués à la transformation d’un objet de manière invisible pour la présentation de son parent.

Par exemple, si vous souhaitez que la présentation s’adapte à un objet devant subir une rotation de 90 degrés, définissez la propriété rotation de ce dernier. Si vous souhaitez que la présentation ne s’adapte pas à un objet subissant une rotation, définissez sa propriété postLayoutTransformOffsets.rotationZ.

Distance horizontale en pixels du bord droit du composant au bord droit de la cible d’ancrage.

Par défaut, la cible d’ancrage est la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une colonne de contrainte.

La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « col1:10 ».

Indique la rotation de l’élément, en degrés, à partir du point de transformation.

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. Les valeurs comprises entre 0 et 180 représentent la rotation dans le sens des aiguilles d’une montre ; les valeurs comprises entre 0 et -180 représentent la rotation dans le sens inverse des aiguilles d’une montre. Les valeurs hors de cette plage sont ajoutées ou soustraites de 360 pour obtenir une valeur comprise dans la plage. Cette propriété est ignorée lors du calcul par une présentation 2D Flex.

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. Les valeurs comprises entre 0 et 180 représentent la rotation dans le sens des aiguilles d’une montre ; les valeurs comprises entre 0 et -180 représentent la rotation dans le sens inverse des aiguilles d’une montre. Les valeurs hors de cette plage sont ajoutées ou soustraites de 360 pour obtenir une valeur comprise dans la plage. Cette propriété est ignorée lors du calcul par une présentation 2D Flex.

Indique la rotation de l’élément, en degrés, à partir du point de transformation.

Echelle horizontale (pourcentage) de l’élément telle qu’elle est appliquée à partir du point de transformation.

Echelle verticale (pourcentage) de l’élément telle qu’elle est appliquée à partir du point de transformation.

Echelle z (pourcentage) de l’élément telle qu’elle est appliquée à partir du point de transformation.

Distance verticale en pixels du bord supérieur du composant au bord supérieur de la cible d’ancrage.

Par défaut, la cible d’ancrage est la zone de contenu du conteneur. Dans les présentations avec contraintes avancées, la cible peut être une ligne de contrainte.

La définition de la propriété sur un nombre ou une chaîne numérique (par exemple, 10) indique que la cible d’ancrage par défaut est utilisée.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « anchorTargetName:value ». Par exemple, « row1:10 ».

Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage. Les propriétés spécifiques, telles que matrix, colorTransform et trois propriétés en lecture seule (concatenatedMatrix, concatenatedColorTransform et pixelBounds) sont décrites dans la section relative à la classe Transform.

Chacune des propriétés de l’objet transform constitue un objet. Ce concept est important dans la mesure où la seule façon de définir de nouvelles valeurs pour les objets matrix ou colorTransform consiste à créer un objet et à le copier dans la propriété transform.matrix ou transform.colorTransform.

Par exemple, pour augmenter la valeur tx d’une matrice d’objet d’affichage, vous devez copier l’ensemble de l’objet de la matrice, puis copier le nouvel objet dans la propriété matrix de l’objet transform :

    var myMatrix:Matrix = myDisplayObject.transform.matrix;  
    myMatrix.tx += 10; 
    myDisplayObject.transform.matrix = myMatrix;  
    

Vous ne pouvez pas définir directement la propriété tx. Le code suivant n’a pas d’effet sur myDisplayObject :

    myDisplayObject.transform.matrix.tx += 10;
    

Vous pouvez copier un objet transform et l’associer à la propriété transform d’un autre objet d’affichage. Par exemple, le code suivant copie l’objet transform dans son intégralité, de myOldDisplayObj à myNewDisplayObj :

Le nouvel objet d’affichage qui en résulte, myNewDisplayObj, dispose désormais des mêmes valeurs pour ses paramètres de matrice, transformation de couleurs et limites de pixels que l’ancien objet d’affichage, myOldDisplayObj.

Notez que les périphériques AIR pour TV font appel à l’accélération matérielle, si elle est disponible, pour les transformations de couleur.

Point de transformation de la position x de l’élément.

Point de transformation de la position y de l’élément.

Point de transformation de la position z de l’élément.

Distance verticale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage.

La cible d’ancrage par défaut est le conteneur lui-même.

Dans les présentations avec contraintes avancées, la cible peut être une ligne de contrainte. La zone de contenu est alors l’espace entre la rangée précédente (ou le côté du conteneur) et la rangée cible.

Définir la propriété sur un nombre ou une chaîne numérique (par exemple, 10) spécifie l’utilisation de la cible d’ancrage par défaut.

Pour spécifier une cible d’ancrage, définissez la valeur de propriété sur une chaîne au format « constraintColumnId:value ». Par exemple, « row1:10 ».

Contrôle la visibilité de cet élément visuel. Si la valeur est true, l’objet est visible.

Si un objet n’est pas visible, mais que la propriété includeInLayout est définie sur true, l’objet occupe de l’espace dans le conteneur, mais est invisible.

Si la valeur de visible est définie sur true, l’objet n’est pas nécessairement visible en raison de sa taille et de l’activation ou non de l’écrêtage du conteneur.

Définir visible sur false empêche la mise en focus du composant.

Largeur de l’élément graphique.

La valeur par défaut est 0.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Position x de l’élément graphique.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Position y de l’élément graphique.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Position z de l’élément graphique.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

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

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

Détermine si l’appel à la méthode measure() peut être ignoré.

Traite le jeu de propriétés sur l’élément. Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe.

Vous n’appelez pas cette méthode directement. Flex appelle la méthode commitProperties() lorsque vous utilisez la méthode addElement() pour ajouter un élément à un conteneur IGraphicElementContainer tel que Group, ou lorsque vous appelez la méthode invalidateProperties() de l’élément. Les appels de la méthode commitProperties() sont réalisés avant les appels de la méthode measure(). Ainsi, vous pouvez définir des valeurs de propriété susceptibles d’être utilisées par la méthode measure().

Certains éléments possèdent des propriétés qui interagissent entre elles. En règle générale, il est préférable de traiter toutes ces propriétés en même temps au démarrage pour éviter d’avoir à réaliser plusieurs fois les mêmes opérations.

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.

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

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

Renvoie la hauteur de présentation de l’élément. Il s’agit de la taille que l’élément utilise pour son affichage à l’écran.

Paramètres

Renvoie la largeur de présentation de l’élément. Il s’agit de la taille que l’élément utilise pour son affichage à l’écran.

Paramètres

Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran.

Paramètres

Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran.

Paramètres

Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères.

Cette matrice est habituellement définie par les propriétés 2D du composant, telles que x, y, rotation, scaleX, scaleY, transformX et transformY. Certains composants peuvent comporter des propriétés de transformation supplémentaires appliquées au-dessus de la matrice de présentation pour déterminer la matrice calculée finale. Par exemple, UIComponent définit la propriété offsets.

Renvoie la matrice Matrix3D de transformation de présentation pour cet élément.

Cette matrice est habituellement définie par les propriétés de transformation du composant, comme x, y, z, rotationX, rotationY, rotationZ, scaleX, scaleY, scaleZ, transformX et transformY. Certains composants peuvent comporter des propriétés de transformation supplémentaires appliquées au-dessus de la matrice de présentation pour déterminer la matrice calculée finale. Par exemple, UIComponent définit la propriété offsets.

Renvoie la hauteur maximale de l’élément.

Paramètres

Renvoie la largeur maximale de l’élément.

Paramètres

Renvoie la hauteur minimale de l’élément.

Paramètres

Renvoie la largeur minimale de l’élément.

Paramètres

Renvoie la hauteur préférée de l’élément.

Paramètres

Renvoie la largeur préférée de l’élément.

Paramètres

Renvoie la quantité de pixels occupée par le trait de chaque côté des limites de l’élément.

Paramètres

Appelée automatiquement par le compilateur MXML lorsqu’une instance GraphicElement est créée en utilisant une balise MXML. Si vous créez l’instance GraphicElement via ActionScript vous devez définir la propriété id manuellement.

Paramètres

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.

Les sous-classes doivent procéder au remplacement et effectuer leurs tâches dans updateDisplayList().

Méthode d’utilitaire qui avertit l’hôte que cet élément a changé et que son calque doit être mis à jour.

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. Si celles-ci diffèrent, la méthode est chargée de la réflexion du contenu de l’élément et de la mise à jour de la transformation post-mise en forme de l’élément afin que les descendants héritent d’un système de coordonnées par symétrie. IVisualElements met généralement en œuvre la réflexion en utilisant postLayoutTransformOffsets pour réduire l’axe des abscisses par -1 et pour translater la coordonnée de l’axe des x de l’origine par la largeur de l’élément. L’effet net de cette transformation « miroir » est d’inverser la direction dans laquelle l’axe des abscisses augmente sans modifier l’emplacement de l’élément par rapport à l’origine de son parent.

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

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.

Les sous-classes doivent effectuer leurs tâches dans commitProperties().

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.

Les sous-classes doivent procéder au remplacement et effectuer leur mesure dans measure(). Par défaut, lorsque explicitWidth et explicitHeight sont définis, la méthode measure() n’est pas appelée. Pour remplacer ce comportement par défaut, les sous-classes doit remplacer skipMeasure().

Convertit l’objet point des coordonnées de l’objet (locales) vers les coordonnées de la scène (globales).

Cette méthode permet de convertir les coordonnées x et y des valeurs qui se rapportent à l’origine (0,0) d’un objet spécifique (coordonnées locales) en valeurs qui se rapportent à l’origine de la scène (coordonnées globales).

Pour utiliser cette méthode, commencez par créer une instance de la classe Point. Les valeurs x et y que vous affectez représentent des coordonnées locales dans la mesure où elles se référent à l’origine de l’objet principal.

Vous transmettez ensuite l’instance de Point que vous avez créée en tant que paramètre à la méthode localToGlobal(). La méthode renvoie un nouvel objet Point avec des valeurs x et y qui se rapportent à l’origine de la scène et non pas à l’origine de l’objet.

Paramètres

Eléments de l’API associés

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.

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

Utilisé pour l’implémentation de l’interface ILayoutElement ; renvoie la valeur explicite de la prétransformation de hauteur mesurée.

Utilisé pour l’implémentation de l’interface ILayoutElement ; renvoie la valeur explicite de la prétransformation de largeur mesurée.

Définit les coordonnées utilisées par l’élément pour son affichage à l’écran.

Notez que les appels de la méthode setLayoutBoundSize() peuvent affecter la position de présentation. Vous devez donc appeler setLayoutBoundPosition() après avoir appelé setLayoutBoundSize().

Paramètres

Définit la taille de la présentation de l’élément. Il s’agit de la taille que l’élément utilise pour son affichage à l’écran.

Si les paramètres width et/ou height ne sont pas spécifiés (NaN), Flex définit la taille de la présentation de l’élément sur la largeur et/ou la hauteur préférées.

Notez que les appels de la méthode setLayoutBoundSize() peuvent affecter la position de présentation. Vous devez donc appeler setLayoutBoundPosition() après avoir appelé setLayoutBoundSize().

Paramètres

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.

La matrice est habituellement définie par les propriétés 2D du composant, telles que x, y, rotation, scaleX, scaleY, transformX et transformY. Certains composants peuvent comporter des propriétés de transformation supplémentaires appliquées au-dessus de la matrice de présentation pour déterminer la matrice calculée finale. Par exemple, UIComponent définit la propriété offsets.

Notez que la matrice de présentation Matrix est utilisée comme facteur dans les méthodes getPreferredSize(), getMinSize(), getMaxSize() et getLayoutSize() lorsqu’elle est calculée dans les coordonnées du parent, ainsi que dans getLayoutPosition() dans les coordonnées du parent et de l’enfant. Généralement, les présentations permettant de calculer la matrice de transformation appellent explicitement cette méthode et utilisent des tailles dans les coordonnées de l’enfant. Les présentations qui appellent cette méthode transmettent la valeur false à la méthode invalidateLayout afin qu’une transmission de présentation suivante ne soit pas déclenchée.

Paramètres

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.

Cette matrice est habituellement définie par les propriétés de transformation du composant, comme x, y, z, rotationX, rotationY, rotationZ, scaleX, scaleY, scaleZ, transformX et transformY. Certains composants peuvent comporter des propriétés de transformation supplémentaires appliquées au-dessus de la matrice de présentation pour déterminer la matrice calculée finale. Par exemple, UIComponent définit la propriété offsets.

Notez que la matrice de présentation Matrix3D est utilisée comme facteur dans les méthodes getPreferredSize(), getMinSize(), getMaxSize() et getLayoutSize() lorsqu’elle est calculée dans les coordonnées du parent, ainsi que dans getLayoutPosition() dans les coordonnées du parent et de l’enfant. Généralement, les présentations permettant de calculer la matrice de transformation appellent explicitement cette méthode et utilisent des tailles dans les coordonnées de l’enfant. Les présentations qui appellent cette méthode transmettent la valeur false à la méthode invalidateLayout afin qu’une transmission de présentation suivante ne soit pas déclenchée.

Paramètres

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

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. Cette fonction affecte les valeurs de rotation, d’échelle et de translation fournies, puis met à jour les propriétés x/y/z, le cas échéant, pour conserver le centre de transformation fixe.

Paramètres

Transforme la taille de l’élément.

Cette méthode calcule le cadre de sélection de l’élément graphique comme si la largeur de l’élément/hauteur propriétés ont été définies pour le transmis dans les valeurs. La méthode renvoie la hauteur du cadre de sélection.

En général, cette méthode n’est pas utilisée par les développeurs. Au lieu de cela, vous devez implémenter ou de remplacer les méthodes définies par l’interface ILayoutElement.

Paramètres

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. Les résultats antérieur et postérieur à la mise en forme sont définis sur les paramètres position et postLayoutPosition, s’ils n’ont pas la valeur null.

Paramètres

Transforme la taille de l’élément.

Cette méthode calcule le cadre de sélection de l’élément graphique comme si la largeur de l’élément/hauteur propriétés ont été définies pour le transmis dans les valeurs. La méthode renvoie la largeur du cadre de sélection.

En général, cette méthode n’est pas utilisée par les développeurs. Au lieu de cela, vous devez implémenter ou de remplacer les méthodes définies par l’interface ILayoutElement.

Paramètres

Trace l’élément et/ou dimensionne et positionne son contenu. 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 updateDisplayList() lorsque le composant est ajouté à un conteneur IGraphicElementContainer tel que Group par le biais de la méthode addElement() et lorsque la méthode invalidateDisplayList() de l’élément est appelée.

Cette méthode est celle où vous procéderiez au traçage par programmation à l’aide des méthodes sur l’objet displayObject de l’élément telles que graphics.drawRect().

Paramètres

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.

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.

Utilisé par la logique de présentation pour valider les propriétés d’un composant par l’appel de la méthode commitProperties(). En général, les sous-classes doivent remplacer la méthode commitProperties() et non pas cette méthode.

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.