SpriteVisualElement  - AS3 Flex

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.

Cette propriété est utilisée pour implémenter le style de contrainte baseline. Elle est également utilisée pour aligner l’étiquette d’une classe FormItem aux contrôles dans la classe FormItem.

Chaque composant doit remplacer cette propriété.

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.

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.

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.

Indique si ce composant est inclus dans la présentation du conteneur parent. Si la valeur est true, l’objet est inclus dans la mise en forme du conteneur parent et est dimensionné et agencé par son conteneur parent par les règles de sa mise en page. Si la valeur est false, la taille et la position de l’objet ne sont pas affectés par la mise en page de son conteneur parent.

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.

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.

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.

Définit le masque. Le masque est ajouté à la liste d’affichage. Le masque ne doit pas déjà être présent dans une liste d’affichage ni dans le tableau des éléments.

Type de masque. Les valeurs possibles sont MaskType.CLIP, MaskType.ALPHA ou 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.

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.

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.

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.

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 .

Une fabrique de modules est utilisée comme contexte d’utilisation de polices intégrées et pour la recherche du gestionnaire de style qui contrôle les styles de ce composant.

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.

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’axe des x 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’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.

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

Définit la coordonnée x du centre de la transformation du composant.

Lorsque cet objet est la cible d’un effet de transformation Spark, vous pouvez remplacer cette propriété en définissant la propriété AnimateTransform.autoCenterTransform. Si autoCenterTransform est false, le centre de la transformation est déterminé par les propriétés transformX, transformY et transformZ de la cible de l’effet. Si autoCenterTransform est true, l’effet se produit autour du centre de la cible, (largeur/2, hauteur/2).

La définition de cette propriété sur la classe d’effet Spark remplace le paramètre de l’objet cible.

Eléments de l’API associés

Définit la coordonnée y du centre de la transformation du composant.

Lorsque cet objet est la cible d’un effet de transformation Spark, vous pouvez remplacer cette propriété en définissant la propriété AnimateTransform.autoCenterTransform. Si autoCenterTransform est false, le centre de la transformation est déterminé par les propriétés transformY, transformY et transformZ de la cible de l’effet. Si autoCenterTransform est true, l’effet se produit autour du centre de la cible, (largeur/2, hauteur/2).

La définition de cette propriété sur la classe d’effet Spark remplace le paramètre de l’objet cible.

Eléments de l’API associés

Définit la coordonnée z du centre de la transformation du composant.

Lorsque cet objet est la cible d’un effet de transformation Spark, vous pouvez remplacer cette propriété en définissant la propriété AnimateTransform.autoCenterTransform. Si autoCenterTransform est false, le centre de la transformation est déterminé par les propriétés transformZ, transformY et transformZ de la cible de l’effet. Si autoCenterTransform est true, l’effet se produit autour du centre de la cible, (largeur/2, hauteur/2).

La définition de cette propriété sur la classe d’effet Spark remplace le paramètre de l’objet cible.

Eléments de l’API associés

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

Définit l’espace vertical que le graphique utilise dans la présentation. Lorsque vous définissez cette valeur, le contenu n’est pas mis à l’échelle. Mais si vous spécifiez la valeur de la propriété height, le contenu est mis à l’échelle.

Il existe deux cas où ceci peut être utile : 1) Vous spécifiez une hauteur viewHeight supérieure à la taille naturelle du contenu. Vous pouvez effectuer cela afin que le graphique occupe plus d’espace que sa taille visuelle. 2) Vous spécifiez une hauteur viewHeight inférieure à la taille naturelle du contenu. Vous pouvez effectuer cette opération si votre graphique comporte du chrome supplémentaire ou une bordure qui s’étend au-delà du contour du graphique. Dans ce cas de figure, assurez-vous de désactiver l’écrêtage dans votre présentation.

Définit l’espace horizontal que le graphique utilise dans la présentation. Lorsque vous définissez cette valeur, le contenu n’est pas mis à l’échelle. Mais si vous spécifiez la valeur de la propriété width, le contenu est mis à l’échelle.

Il existe deux cas où ceci peut être utile : 1) Vous spécifiez une largeur viewWidth supérieure à la taille naturelle du contenu. Vous pouvez effectuer cela afin que le graphique occupe plus d’espace que sa taille visuelle. 2) Vous spécifiez une largeur viewWidth inférieure à la taille naturelle du contenu. Vous pouvez effectuer cette opération si votre graphique comporte du chrome supplémentaire ou une bordure qui s’étend au-delà du contour du graphique. Dans ce cas de figure, assurez-vous de désactiver l’écrêtage dans votre présentation.

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.

Constructeur.

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

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

Paramètres

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.

Invalide la taille et la liste d’affichage du parent si cet objet affecte sa présentation (includeInLayout est définie sur true).

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

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