Package | mx.core |
Classe | public class SpriteAsset |
Héritage | SpriteAsset FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Implémente | IFlexAsset, IFlexDisplayObject, IBorder, ILayoutDirectionElement |
Sous-classes | DefaultDragImage |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
L’image vectorielle à incorporer peut figurer dans un fichier SVG. Vous pouvez également incorporer un symbole sprite figurant dans un fichier SWF produit par Flash. Dans les deux cas, le compilateur MXML génère automatiquement une classe qui étend la classe SpriteAsset pour représenter l’image vectorielle incorporée.
Généralement, il n’est pas nécessaire d’utiliser la classe SpriteAsset directement lors de l’écriture d’une application Flex. Par exemple, vous pouvez incorporer un symbole sprite à partir d’un fichier SWF et l’afficher dans un contrôle d’image en écrivant le code suivant :
<mx:Image id="logo" source="@Embed(source='Assets.swf', symbol='Logo')"/>
Ou l’utiliser comme image d’arrière-plan de l’application en syntaxe CSS en écrivant le code suivant :
<fx:Style> @namespace mx "library://ns.adobe.com/flex/mx" mx|Application { backgroundImage: Embed(source="Assets.swf", symbol='Logo') } <fx:Style/>
sans devoir comprendre que le compilateur MXML crée automatiquement une sous-classe de BitmapAsset.
Cependant, il peut être utile de comprendre ce qui se passe au niveau du code ActionScript. Afin d’incorporer une image vectorielle dans ActionScript, vous déclarez une variable de type Class pour lui ajouter des métadonnées [Embed]
. Par exemple, pour incorporer un symbole sprite à partir d’un fichier SWF, procédez comme suit :
[Bindable] [Embed(source="Assets.swf", symbol="Logo")] private var logoClass:Class;
Le compilateur MXML détecte que le symbole Logo dans Assets.swf est un sprite, génère automatiquement une sous-classe de la classe SpriteAsset pour le représenter et définit la variable comme référence à cette classe auto-générée. Vous pouvez ensuite utiliser cette référence de classe pour créer des instances de la classe SpriteAsset à l’aide de l’opérateur new
et utiliser les API de la classe Sprite sur ces dernières :
var logo:SpriteAsset = SpriteAsset(new logoClass()); logo.rotation=45;
Toutefois, il est rarement nécessaire de créer des instances SpriteAsset manuellement. En effet, les propriétés et styles liés aux images peuvent être définis sur une classe produisant une image. Les composants créent ainsi les instances d’image en tant que de besoin. Par exemple, pour afficher cette image vectorielle dans un contrôle d’image, vous pouvez définir la propriété source
de l’image sur logoClass
. Dans MXML, procédez de la manière suivante :
<mx:Image id="logo" source="{logoClass}"/>
Propriété | Défini par | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Options d’accessibilité actuelles de l’objet d’affichage. | DisplayObject | ||
alpha : Number
Indique la valeur de transparence alpha de l’objet spécifié. | DisplayObject | ||
blendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser. | DisplayObject | ||
blendShader : Shader [écriture seule]
Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan. | DisplayObject | ||
borderMetrics : EdgeMetrics [lecture seule]
Renvoie un objet EdgeMetrics pour la bordure qui comporte quatre propriétés : left, top, right et bottom. | SpriteAsset | ||
buttonMode : Boolean
Spécifie le mode de bouton du sprite. | Sprite | ||
cacheAsBitmap : Boolean
Si la valeur true est définie, les moteurs d’exécution de Flash placent en mémoire cache une version bitmap interne de l’objet d’affichage. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
S’il n’est pas nul, cet objet Matrix définit le mode de rendu d’un objet d’affichage lorsque cacheAsBitmap est définie sur true. | DisplayObject | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
contextMenu : NativeMenu
Spécifie le menu contextuel associé à l’objet. | InteractiveObject | ||
doubleClickEnabled : Boolean
Spécifie si l’objet reçoit les événements doubleClick. | InteractiveObject | ||
dropTarget : DisplayObject [lecture seule]
Spécifie l’objet d’affichage sur lequel le sprite est glissé ou sur lequel il a été déposé. | Sprite | ||
filters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage. | DisplayObject | ||
focusRect : Object
Spécifie si l’objet affiche un rectangle de focus. | InteractiveObject | ||
graphics : Graphics [lecture seule]
Spécifie l’objet Graphics appartenant au sprite qui prend en charge les commandes de dessin vectoriel. | Sprite | ||
height : Number
Indique la hauteur de l’objet d’affichage, en pixels. | DisplayObject | ||
hitArea : Sprite
Désigne un autre sprite qui fera office de zone active d’un sprite. | Sprite | ||
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). | SpriteAsset | ||
loaderInfo : LoaderInfo [lecture seule]
Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage. | DisplayObject | ||
mask : DisplayObject
L’objet d’affichage appelant est masqué par l’objet mask spécifié. | DisplayObject | ||
measuredHeight : Number [lecture seule]
Hauteur mesurée de l’objet. | SpriteAsset | ||
measuredWidth : Number [lecture seule]
Largeur mesurée de l’objet. | SpriteAsset | ||
metaData : Object
Obtient les données d’objet de métadonnées de l’occurrence DisplayObject si les données d’meta a été stockée près de la l’occurrence de cette DisplayObject dans le fichier SWF à l’aide d’une balise de4 PlaceObject. | DisplayObject | ||
mouseChildren : Boolean
Détermine si les enfants de l’objet prennent en charge la souris ou les périphériques de saisie utilisateur. | DisplayObjectContainer | ||
mouseEnabled : Boolean
Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur. | InteractiveObject | ||
mouseX : Number [lecture seule]
Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | ||
mouseY : Number [lecture seule]
Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | ||
name : String
Indique le nom d’occurrence de DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Indique si un clavier virtuel (clavier logiciel à l’écran) doit s’afficher lorsque cette occurrence d’InteractiveObject reçoit le focus. | InteractiveObject | ||
numChildren : int [lecture seule]
Renvoie le nombre d’enfants de l’objet. | DisplayObjectContainer | ||
opaqueBackground : Object
Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique. | DisplayObject | ||
parent : DisplayObjectContainer [lecture seule]
Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage. | DisplayObject | ||
root : DisplayObject [lecture seule]
Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété root correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier. | DisplayObject | ||
rotation : Number
Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine. | DisplayObject | ||
rotationX : Number
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. | DisplayObject | ||
rotationY : Number
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. | DisplayObject | ||
rotationZ : Number
Indique la rotation de l’axe des z de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | ||
scale9Grid : Rectangle
Grille de mise à l’échelle en vigueur. | DisplayObject | ||
scaleX : Number
Indique l’échelle horizontale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement. | DisplayObject | ||
scaleY : Number
Indique l’échelle verticale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement. | DisplayObject | ||
scaleZ : Number
Indique l’échelle de profondeur (pourcentage) de l’objet tel qu’elle est appliquée à partir du point d’alignement. | DisplayObject | ||
scrollRect : Rectangle
Cadre de sélection du défilement de l’objet d’affichage. | DisplayObject | ||
softKeyboard : String
Contrôle l’aspect du clavier logiciel. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Définit la zone qui doit rester à l’écran lorsqu’un clavier logiciel s’affiche (non disponible sur iOS) | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
Contrôle le son à l’intérieur du sprite. | Sprite | ||
stage : Stage [lecture seule]
Scène de l’objet d’affichage. | DisplayObject | ||
tabChildren : Boolean
Détermine si les enfants de l’objet prennent ou non en charge la tabulation. | DisplayObjectContainer | ||
tabEnabled : Boolean
Indique si cet objet est spécifié dans l’ordre de tabulation. | InteractiveObject | ||
tabIndex : int
Spécifie l’ordre de tabulation des objets dans un fichier SWF. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [lecture seule]
Renvoie un objet TextSnapshot pour l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
transform : flash.geom:Transform
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage. | DisplayObject | ||
useHandCursor : Boolean
Valeur booléenne indiquant si le curseur en forme de main apparaît lorsque le pointeur survole un sprite dont la propriété buttonMode est définie sur true. | Sprite | ||
visible : Boolean
Indique si l’objet d’affichage est visible ou non. | DisplayObject | ||
width : Number
Indique la largeur de l’objet d’affichage, en pixels. | DisplayObject | ||
x : Number
Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. | DisplayObject | ||
y : Number
Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. | DisplayObject | ||
z : Number
Indique la position de coordonnée z le long de l’axe des z de l’occurrence DisplayObject par rapport au conteneur 3D parent. | DisplayObject |
Méthode | Défini par | ||
---|---|---|---|
Constructeur. | SpriteAsset | ||
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. | DisplayObjectContainer | ||
Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer. | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | ||
Indique si les restrictions de sécurité entraîneraient l’omission des objets d’affichage de la liste renvoyée en appelant la méthode DisplayObjectContainer.getObjectsUnderPoint() avec le point « point » spécifié. | DisplayObjectContainer | ||
Détermine si l’objet d’affichage spécifié est un enfant de l’occurrence de DisplayObjectContainer ou l’occurrence en tant que telle. | DisplayObjectContainer | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace. | DisplayObject | ||
Renvoie l’occurrence enfant de l’objet d’affichage associée à l’index spécifié. | DisplayObjectContainer | ||
Renvoie l’objet d’affichage enfant portant le nom spécifié. | DisplayObjectContainer | ||
Renvoie la position d’index d’une occurrence enfant de DisplayObject. | DisplayObjectContainer | ||
Renvoie un tableau d’objets de niveau inférieur au point spécifié et qui sont les enfants (ou les petits-enfants, etc.) de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes. | DisplayObject | ||
Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales). | DisplayObject | ||
Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales). | DisplayObject | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage obj. | DisplayObject | ||
Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y. | DisplayObject | ||
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. | SpriteAsset | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales). | DisplayObject | ||
Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales). | DisplayObject | ||
Déplace cet objet vers les coordonnées x et y spécifiées. | SpriteAsset | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Supprime l’occurrence enfant de DisplayObject spécifiée de la liste d’enfants de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
Supprime une occurrence enfant de DisplayObject de la position d’index spécifiée dans la liste d’enfants de DisplayObjectContainer. | DisplayObjectContainer | ||
Supprime toutes les occurrences enfants de DisplayObject de la liste d’enfants de l’occurrence de DisplayObjectContainer. | DisplayObjectContainer | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Affiche un clavier virtuel. | InteractiveObject | ||
Définit la taille réelle de cet objet. | SpriteAsset | ||
Modifie la position d’un enfant existant dans le conteneur d’objet d’affichage. | DisplayObjectContainer | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Permet à l’utilisateur de faire glisser le sprite spécifié. | Sprite | ||
Permet à l’utilisateur de faire glisser le sprite spécifié sur un périphérique tactile. | Sprite | ||
Interrompt de façon récursive l’exécution du scénario de tous les clips ayant cet objet comme racine. | DisplayObjectContainer | ||
Met fin à la méthode startDrag(). | Sprite | ||
Met fin à la méthode startTouchDrag() en vue d’utiliser des périphériques tactiles. | Sprite | ||
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des deux objets enfant spécifiés. | DisplayObjectContainer | ||
Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des objets enfant aux deux positions d’index spécifiées dans la liste d’enfants. | DisplayObjectContainer | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
[override]
Renvoie une chaîne indiquant l’emplacement de l’objet dans la hiérarchie des objets DisplayObject de l’application. | FlexSprite | ||
Renvoie la valeur primitive de l’objet spécifié. | Object | ||
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher |
borderMetrics | propriété |
borderMetrics:EdgeMetrics
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie un objet EdgeMetrics pour la bordure qui comporte quatre propriétés : left
, top
, right
et bottom
. La valeur de chaque propriété est égale à l’épaisseur d’un côté de la bordure, exprimée en pixels.
Implémentation
public function get borderMetrics():EdgeMetrics
layoutDirection | propriété |
layoutDirection:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.1 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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.
Implémentation
public function get layoutDirection():String
public function set layoutDirection(value:String):void
measuredHeight | propriété |
measuredHeight:Number
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Hauteur mesurée de l’objet.
Cette valeur est généralement codée en dur pour les habillages graphiques, car ce nombre correspond tout simplement au nombre de pixels du graphique. Pour les habillages de code, la valeur peut également être codée en dur si vous souhaitez que l’objet soit tracé à une taille bien définie. Si la taille peut changer en fonction de différentes propriétés, vous pouvez également utiliser une interface ILayoutManagerClient, de sorte qu’une méthode measure()
soit appelée au moment opportun. Vous pouvez ainsi calculer la hauteur measuredHeight
.
Implémentation
public function get measuredHeight():Number
measuredWidth | propriété |
measuredWidth:Number
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Largeur mesurée de l’objet.
Cette valeur est généralement codée en dur pour les habillages graphiques, car ce nombre correspond tout simplement au nombre de pixels du graphique. Pour les habillages de code, la valeur peut également être codée en dur si vous souhaitez que l’objet soit tracé à une taille bien définie. Si la taille peut changer en fonction de différentes propriétés, vous pouvez également utiliser une interface ILayoutManagerClient, de sorte qu’une méthode measure()
soit appelée au moment opportun. Vous pouvez ainsi calculer la hauteur measuredHeight
.
Implémentation
public function get measuredWidth():Number
SpriteAsset | () | Constructeur |
public function SpriteAsset()
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
invalidateLayoutDirection | () | méthode |
public function invalidateLayoutDirection():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4.1 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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.
move | () | méthode |
public function move(x:Number, y:Number):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Déplace cet objet vers les coordonnées x et y spécifiées.
Paramètres
x:Number — Nouvelle position x de l’objet.
| |
y:Number — Nouvelle position y de l’objet.
|
setActualSize | () | méthode |
public function setActualSize(newWidth:Number, newHeight:Number):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Définit la taille réelle de cet objet.
Cette méthode est principalement utilisée dans le cadre de l’implémentation de la méthode updateDisplayList()
, qui permet de calculer la taille réelle de l’objet, en fonction de sa taille explicite, de sa taille par rapport au parent (pourcentage) et de sa taille mesurée. Vous pouvez ensuite appliquer cette taille réelle à l’objet en appelant la méthode setActualSize()
.
Dans d’autres situations, il est préférable de définir les propriétés telles que width
, height
, percentWidth
et percentHeight
plutôt que d’appeler cette méthode.
Paramètres
newWidth:Number — Nouvelle largeur de l’objet.
| |
newHeight:Number — Nouvelle hauteur de l’objet.
|
Tue Jun 12 2018, 09:30 AM Z