Package | mx.core |
Classe | public class MovieClipAsset |
Héritage | MovieClipAsset FlexMovieClip MovieClip Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Implémente | IFlexAsset, IFlexDisplayObject, IBorder |
Sous-classes | MovieClipLoaderAsset |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
L’objet MovieClip incorporé doit être un symbole de clip figurant dans un fichier SWF. Un clip incorporé permet habituellement l’utilisation dans une application Flex d’une animation à base d’images créée dans Flash. Le compilateur MXML génère automatiquement une classe qui étend la classe MovieClipAsset pour représenter l’animation incorporée.
Il n’est généralement pas nécessaire d’utiliser la classe MovieClipAsset directement lors de l’écriture d’une application Flex. Par exemple, vous pouvez utiliser une séquence d’animation comme image d’arrière-plan d’une application en écrivant le code suivant :
<mx:Application backgroundImage="@Embed(source='Assets.swf', symbol='BackgroundAnimation')"/>
ou
<fx:Style> @namespace mx "library://ns.adobe.com/flex/mx" mx|Application { backgroundImage: Embed(source="Assets.swf", symbol="BackgroundAnimation") } <fx:Style/>
sans devoir comprendre que le compilateur MXML crée automatiquement une sous-classe de MovieClipAsset.
Cependant, il peut être utile de comprendre ce qui se passe au niveau du code ActionScript. Afin d’incorporer un clip dans ActionScript, vous devez déclarer une variable de type Class et lui ajouter des métadonnées [Embed]
. Par exemple :
[Bindable] [Embed(source="Assets.swf", symbol="BackgroundAnimation")] private var backgroundAnimationClass:Class;
Le compilateur MXML détecte que le symbole BackgroundAnimation dans Assets.swf est un clip, génère automatiquement une sous-classe de la classe MovieClipAsset 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 MovieClipAsset à l’aide de l’opérateur new
et utiliser les API de la classe MovieClip sur ces dernières :
var backgroundAnimation:MovieClipAsset = MovieClipAsset(new backgroundAnimationClass()); var n:int = backgroundAnimation.totalFrames;
Toutefois, il est rarement nécessaire de créer des instances MovieClipAsset 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 en tant que de besoin. Par exemple, pour définir l’arrière-plan d’application sur cette animation, vous pouvez simplement écrire le code suivant :
<mx:Application backgroundImage="{backgroundAnimationClass}"/>
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. | MovieClipAsset | ||
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 | ||
currentFrame : int [lecture seule]
Spécifie le numéro de l’image où réside la tête de lecture dans le scénario de l’occurrence de MovieClip. | MovieClip | ||
currentFrameLabel : String [lecture seule]
Etiquette de l’image actuelle dans le scénario de l’occurrence MovieClip. | MovieClip | ||
currentLabel : String [lecture seule]
Etiquette où réside actuellement la tête de lecture dans le scénario de l’occurrence de MovieClip. | MovieClip | ||
currentLabels : Array [lecture seule]
Renvoie un tableau des objets FrameLabel extraits de la séquence en cours. | MovieClip | ||
currentScene : Scene [lecture seule]
Séquence où réside actuellement la tête de lecture dans le scénario de l’occurrence de MovieClip. | MovieClip | ||
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 | ||
enabled : Boolean
Valeur booléenne indiquant si un clip est activé. | MovieClip | ||
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 | ||
framesLoaded : int [lecture seule]
Nombre d’images à charger à partir d’un fichier SWF en diffusion continue. | MovieClip | ||
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 | ||
isPlaying : Boolean [lecture seule]
Valeur booléenne indiquant si un clip est en cours de lecture. | MovieClip | ||
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. | MovieClipAsset | ||
measuredWidth : Number [lecture seule]
Largeur mesurée de l’objet. | MovieClipAsset | ||
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 | ||
scenes : Array [lecture seule]
Tableau des objets Scene, chacun d’eux indiquant le nom, le nombre d’images et les étiquettes d’image d’une séquence dans l’occurrence de MovieClip. | MovieClip | ||
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 | ||
totalFrames : int [lecture seule]
Nombre total d’images dans l’occurrence de MovieClip. | MovieClip | ||
trackAsMenu : Boolean
Indique si d’autres objets d’affichage de type SimpleButton ou MovieClip peuvent recevoir des événements de relâchement de souris ou d’autres types d’événements de relâchement. | MovieClip | ||
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. | MovieClipAsset | ||
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 | ||
Commence la lecture du fichier SWF sur l’image spécifiée. | MovieClip | ||
Place la tête de lecture au niveau de l’image spécifiée du clip et l’arrête à cet endroit. | MovieClip | ||
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 | ||
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. | MovieClipAsset | ||
Place la tête de lecture sur l’image suivante et l’arrête. | MovieClip | ||
Place la tête de lecture sur la séquence suivante de l’occurrence de MovieClip. | MovieClip | ||
Déplace la tête de lecture dans le scénario du clip. | MovieClip | ||
Place la tête de lecture sur l’image précédente et l’arrête. | MovieClip | ||
Place la tête de lecture sur la séquence précédente de l’occurrence de MovieClip. | MovieClip | ||
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. | MovieClipAsset | ||
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 | ||
Arrête la tête de lecture dans le clip. | MovieClip | ||
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. | FlexMovieClip | ||
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
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
MovieClipAsset | () | Constructeur |
public function MovieClipAsset()
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
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