Paqueteflash.display
Clasepublic dynamic class MovieClip
HerenciaMovieClip Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Subclases LivePreviewParent

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La clase MovieClip hereda de las siguientes clases: Sprite, DisplayObjectContainer, InteractiveObject, DisplayObject y EventDispatcher.

A diferencia del objeto Sprite, un objeto MovieClip tiene línea de tiempo.

Los métodos de la clase MovieClip proporcionan la misma funcionalidad que las acciones que van dirigidas a clips de película. También existen métodos adicionales que carecen de acciones equivalentes en el cuadro de herramientas Acciones del panel Acciones en la herramienta de edición de Flash.

No se puede acceder a las instancias secundarias colocadas en el escenario en la herramienta de edición de Flash por código del constructor de una instancia principal, ya que no se han creado en ese punto en la ejecución del código. Antes de acceder al valor secundario, el principal debe crear la instancia secundaria por código o acceder con retraso a la función callback que detecta el valor secundario para que distribuya el evento Event.ADDED_TO_STAGE.

Si modifica alguna de las propiedades siguientes de un objeto MovieClip que contenga una interpolación de movimiento, Flash Player detendrá la cabeza lectora en dicho objeto MovieClip: alpha, blendMode, filters, height, opaqueBackground, rotation, scaleX, scaleY, scale9Grid, scrollRect, transform, visible, width, x o y. No obstante, no detiene la cabeza lectora en ninguno de los objetos MovieClip secundarios de dicho objeto MovieClip.

Ver los ejemplos

Véase también

Clases principales de visualización
Fundamentos de la utilización de película


Propiedades públicas
 PropiedadDefinido por
 InheritedaccessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización.
DisplayObject
 Inheritedalpha : Number
Indica el valor de transparencia alfa del objeto especificado.
DisplayObject
 InheritedblendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.
DisplayObject
 InheritedbuttonMode : Boolean
Especifica el modo de botón de este elemento sprite.
Sprite
 InheritedcacheAsBitmap : Boolean
Si se define como true, Flash Player deja en caché una representación interna de mapa de bits del objeto de visualización.
DisplayObject
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 InheritedcontextMenu : ContextMenu
Especifica el menú contextual asociado a este objeto.
InteractiveObject
  currentFrame : int
[read-only] Especifica el número del fotograma en el que está situada la cabeza lectora en la línea de tiempo de la instancia de MovieClip.
MovieClip
  currentLabel : String
[read-only] La etiqueta actual en la que está situada la cabeza lectora en la línea de tiempo de la instancia de MovieClip.
MovieClip
  currentLabels : Array
[read-only] Devuelve una matriz de objetos FrameLabel de la escena actual.
MovieClip
  currentScene : Scene
[read-only] La escena actual en la que está situada la cabeza lectora en la línea de tiempo de la instancia de MovieClip.
MovieClip
 InheriteddoubleClickEnabled : Boolean
Especifica si este objeto recibe eventos doubleClick.
InteractiveObject
 InheriteddropTarget : DisplayObject
[read-only] Especifica el objeto de visualización sobre el que se está arrastrando el elemento sprite o sobre el que se ha colocado el elemento sprite.
Sprite
  enabled : Boolean
Valor booleano que indica si un clip de película está activado.
MovieClip
 Inheritedfilters : Array
Matriz indexada que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.
DisplayObject
 InheritedfocusRect : Object
Especifica si este objeto muestra un rectángulo de selección.
InteractiveObject
  framesLoaded : int
[read-only] Número de fotogramas que se han cargado de un flujo de archivo SWF.
MovieClip
 Inheritedgraphics : Graphics
[read-only] Especifica el objeto Graphics que pertenece a este elemento sprite, donde pueden ejecutarse comandos de dibujo vectorial.
Sprite
 Inheritedheight : Number
Indica la altura del objeto de visualización, expresada en píxeles.
DisplayObject
 InheritedhitArea : Sprite
Designa otro elemento sprite para que actúe como área activa de un elemento sprite.
Sprite
 InheritedloaderInfo : LoaderInfo
[read-only] Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización.
DisplayObject
 Inheritedmask : DisplayObject
El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado.
DisplayObject
 InheritedmouseChildren : Boolean
Determina si los elementos secundarios del objeto están habilitados para ratón.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Especifica si este objeto recibe mensajes de ratón.
InteractiveObject
 InheritedmouseX : Number
[read-only] Indica la coordenada x de la posición del ratón en píxeles.
DisplayObject
 InheritedmouseY : Number
[read-only] Indica la coordenada y de la posición del ratón en píxeles.
DisplayObject
 Inheritedname : String
Indica el nombre de instancia de DisplayObject.
DisplayObject
 InheritednumChildren : int
[read-only] Devuelve el número de elementos secundarios de este objeto.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] Indica el objeto DisplayObjectContainer que contiene este objeto de visualización.
DisplayObject
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
 Inheritedroot : DisplayObject
[read-only] Para un objeto de visualización en un archivo SWF cargado, la propiedad root es el objeto de visualización de nivel más alto en la parte de la estructura de árbol de la lista de visualización representada por dicho archivo SWF.
DisplayObject
 Inheritedrotation : Number
Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original.
DisplayObject
 Inheritedscale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente.
DisplayObject
 InheritedscaleX : Number
Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro.
DisplayObject
 InheritedscaleY : Number
Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto.
DisplayObject
  scenes : Array
[read-only] Una matriz de objetos Scene que enumeran el nombre, el número de fotogramas y las etiquetas de fotogramas de una escena de la instancia de MovieClip.
MovieClip
 InheritedscrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización.
DisplayObject
 InheritedsoundTransform : SoundTransform
Controla el sonido dentro de este elemento sprite.
Sprite
 Inheritedstage : Stage
[read-only] El escenario del objeto de visualización.
DisplayObject
 InheritedtabChildren : Boolean
Determina si los elementos secundarios del objeto están habilitados para tabulación.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Especifica si este objeto está en el orden de tabulación.
InteractiveObject
 InheritedtabIndex : int
Especifica el orden de tabulación de los objetos de un archivo SWF.
InteractiveObject
 InheritedtextSnapshot : TextSnapshot
[read-only] Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.
DisplayObjectContainer
  totalFrames : int
[read-only] El número total de fotogramas de la instancia de MovieClip.
MovieClip
  trackAsMenu : Boolean
Indica si otros objetos de visualización que sean objetos SimpleButton o MovieClip pueden recibir eventos de liberación del botón del ratón.
MovieClip
 Inheritedtransform : Transform
Objeto con propiedades pertenecientes a una matriz, transformación de color y límites de píxel de un objeto de visualización.
DisplayObject
 InheriteduseHandCursor : Boolean
Valor booleano que indica si debe aparecer la mano que señala (cursor de mano) cuando el ratón pasa por encima de un elemento sprite en el que la propiedad buttonMode se ha definido con el valor true.
Sprite
 Inheritedvisible : Boolean
Indica si el objeto de visualización es visible.
DisplayObject
 Inheritedwidth : Number
Indica la anchura del objeto de visualización, expresada en píxeles.
DisplayObject
 Inheritedx : Number
Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.
DisplayObject
 Inheritedy : Number
Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.
DisplayObject
Métodos públicos
 MétodoDefinido por
  
Crea una nueva instancia de MovieClip.
MovieClip
 Inherited
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.
EventDispatcher
 Inherited
Indica si las restricciones de seguridad provocarían la omisión de objetos de visualización de la lista devuelta al llamar al método DisplayObjectContainer.getObjectsUnderPoint() con el punto point especificado.
DisplayObjectContainer
 Inherited
Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia.
DisplayObjectContainer
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace.
DisplayObject
 Inherited
Devuelve la instancia del objeto de visualización secundario que sale del índice especificado.
DisplayObjectContainer
 Inherited
Devuelve el objeto de visualización secundario que sale con el nombre especificado.
DisplayObjectContainer
 Inherited
Devuelve la posición de índice de una instancia secundaria de DisplayObject.
DisplayObjectContainer
 Inherited
Devuelve una matriz de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Devuelve un rectángulo que define el límite del objeto de visualización, basado en el sistema de coordenadas definido por el parámetro targetCoordinateSpace, excluyendo los trazos en las formas.
DisplayObject
 Inherited
Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).
DisplayObject
  
gotoAndPlay(frame:Object, scene:String = null):void
Inicia la reproducción del archivo SWF en el fotograma especificado.
MovieClip
  
gotoAndStop(frame:Object, scene:String = null):void
Traslada la cabeza lectora al fotograma especificado del clip de película y la detiene en dicho lugar.
MovieClip
 Inherited
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.
EventDispatcher
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el objeto de visualización obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el punto especificado por los parámetros x e y.
DisplayObject
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).
DisplayObject
  
Traslada la cabeza lectora al siguiente fotograma y la detiene en dicho punto.
MovieClip
  
Mueve la cabeza lectora a la siguiente escena de la instancia de MovieClip.
MovieClip
  
Mueve la cabeza lectora por la línea de tiempo del clip de película.
MovieClip
  
Traslada la cabeza lectora al fotograma anterior y la detiene en dicho punto.
MovieClip
  
Mueve la cabeza lectora a la escena anterior de la instancia de MovieClip.
MovieClip
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Elimina la instancia child de DisplayObject especificada de la lista de elementos secundarios de la instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Elimina una instancia de DisplayObject secundaria de la posición de índice especificada en la lista de elementos secundarios de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
EventDispatcher
 Inherited
Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización.
DisplayObjectContainer
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Permite al usuario arrastrar el elemento sprite especificado.
Sprite
  
Detiene la cabeza lectora en el clip de película.
MovieClip
 Inherited
Finaliza el método startDrag().
Sprite
 Inherited
Intercambia el orden z (de delante a atrás) de los dos objetos secundarios especificados.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Intercambia el orden z (de delante a atrás) de los objetos secundarios situados en las posiciones de índice especificadas en la lista de elementos secundarios.
DisplayObjectContainer
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
 Inherited
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.
EventDispatcher
Eventos
 Evento Resumen Definido por
 Inherited Se distribuye cuando Flash Player queda seleccionado por el sistema operativo y pasa a estar activo.EventDispatcher
 Inherited Se distribuye cuando un objeto de visualización se añade a la lista de visualización.DisplayObject
 Inherited Se distribuye cuando un objeto de visualización se añade a la lista de visualización del escenario, bien directamente o a través de un subárbol que contiene el objeto de visualización.DisplayObject
 Inherited Se distribuye cuando un usuario pulsa y suelta el botón principal del dispositivo de señalización sobre el mismo objeto InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando Flash Player deja de estar seleccionado por el sistema operativo y pasa a estar inactivo.EventDispatcher
 Inherited Se distribuye cuando un usuario pulsa y suelta el botón principal de un dispositivo de señalización dos veces en una sucesión rápida sobre el mismo objeto InteractiveObject cuando el indicador doubleClickEnabled de dicho objeto se ha definido como true.InteractiveObject
 Inherited Se distribuye cuando la cabeza lectora entra en un nuevo fotograma.DisplayObject
 Inherited Se distribuye después de que un objeto de visualización quede seleccionado.InteractiveObject
 Inherited Se distribuye después de que un objeto de visualización deje de estar seleccionado.InteractiveObject
 Inherited Se distribuye cuando el usuario pulsa una tecla.InteractiveObject
 Inherited Se distribuye cuando el usuario intenta cambiar la selección empleando la navegación mediante teclado.InteractiveObject
 Inherited Se distribuye cuando el usuario suelta una tecla.InteractiveObject
 Inherited Se distribuye cuando el usuario pulsa el botón del dispositivo de señalización sobre una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando el usuario intenta cambiar la selección empleando un dispositivo de señalización.InteractiveObject
 Inherited Se distribuye cuando el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando el usuario pasa el dispositivo de señalización por encima de una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando el usuario suelta el botón del dispositivo de señalización sobre una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando se hace girar una rueda de ratón sobre una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización.DisplayObject
 Inherited Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización, bien directamente o a través de la eliminación de un subárbol que contiene el objeto de visualización.DisplayObject
 Inherited Se distribuye cuando la lista de visualización se va a actualizar y mostrar.DisplayObject
 Inherited Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando cambia el valor del indicador tabChildren del objeto.InteractiveObject
 Inherited Se distribuye cuando cambia el indicador tabEnabled del objeto.InteractiveObject
 Inherited Se distribuye cuando cambia el valor de la propiedad tabIndex del objeto.InteractiveObject
Información sobre propiedades
currentFramepropiedad
currentFrame:int  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica el número del fotograma en el que está situada la cabeza lectora en la línea de tiempo de la instancia de MovieClip. Si el clip de película tiene varias escenas, este valor será el número de fotograma de la escena actual.


Implementación
    public function get currentFrame():int

Ejemplo

En el código siguiente, se utiliza el método gotoAndStop() y la propiedad currentFrame para ordenar a la cabeza lectora del clip de película mc1 que avance cinco fotogramas con respecto a su posición actual y se detenga:
mc1.gotoAndStop(mc1.currentFrame + 5);
currentLabelpropiedad 
currentLabel:String  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La etiqueta actual en la que está situada la cabeza lectora en la línea de tiempo de la instancia de MovieClip. Si el fotograma actual no tiene etiqueta, currentLabel se establece con el nombre del fotograma anterior que incluya una etiqueta. Si el fotograma actual y los anteriores no incluyen una etiqueta, currentLabel devuelve el valor null.


Implementación
    public function get currentLabel():String

Ejemplo

El código siguiente ilustra el modo de acceder a la propiedad currentLabel de un objeto MovieClip denominado mc1:
trace(mc1.currentLabel);
currentLabelspropiedad 
currentLabels:Array  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Devuelve una matriz de objetos FrameLabel de la escena actual. Si la instancia de MovieClip no utiliza escenas, la matriz incluirá todas las etiquetas de fotogramas de toda la instancia de MovieClip.


Implementación
    public function get currentLabels():Array

Véase también


Ejemplo

El código siguiente ilustra el modo de utilizar la propiedad currentLabels de un objeto MovieClip denominado mc1:
import flash.display.FrameLabel;

var labels:Array = mc1.currentLabels;

for (var i:uint = 0; i < labels.length; i++) {
    var label:FrameLabel = labels[i];
    trace("frame " + label.frame + ": " + label.name);
}
currentScenepropiedad 
currentScene:Scene  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La escena actual en la que está situada la cabeza lectora en la línea de tiempo de la instancia de MovieClip.


Implementación
    public function get currentScene():Scene

Véase también


Ejemplo

El código siguiente ilustra el modo de utilizar la propiedad currentScene de un objeto MovieClip denominado mc1:
import flash.display.Scene;

var scene:Scene = mc1.currentScene;
trace(scene.name + ": " + scene.numFrames + " frames");
enabledpropiedad 
enabled:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Valor booleano que indica si un clip de película está activado. El valor predeterminado de enabled es true. Si enabled se configura con el valor false, se desactivarán los fotogramas Over, Down y Up. El clip de película continuará recibiendo eventos (por ejemplo, mouseDown, mouseUp, keyDown y keyUp).

La propiedad enabled sólo controla las propiedades de botón de un clip de película. Puede cambiar la propiedad enabled en cualquier momento; el clip de película modificado se activa o desactiva de inmediato. Si enabled se establece con el valor false, el objeto no se incluirá en el orden de tabulación automático.


Implementación
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void

Ejemplo

El código siguiente ilustra el modo de utilizar la propiedad enabled para desactivar las propiedades de botón de un objeto MovieClip denominado mc1:
mc1.enabled = false;
framesLoadedpropiedad 
framesLoaded:int  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Número de fotogramas que se han cargado de un flujo de archivo SWF. Puede utilizar la propiedad frameLoaded para determinar si se ha cargado el contenido de un fotograma específico y el de todos los que le preceden y si está disponible localmente en el navegador. También puede utilizarla para controlar la descarga de archivos SWF grandes. Por ejemplo, puede que desee mostrar un mensaje a los usuarios para indicar que el archivo SWF se está cargando hasta que un fotograma concreto del archivo SWF haya terminado de cargarse.

Si el clip de película contiene varias escenas, la propiedad framesLoaded devolverá el número de fotogramas cargados para todas las escenas del clip de película.


Implementación
    public function get framesLoaded():int

Véase también


Ejemplo

El código siguiente ilustra el modo de utilizar la propiedad framesLoaded y totalFrames para determinar si el flujo de objeto MovieClip denominado mc1 se ha cargado totalmente:
if (mc1.framesLoaded == mc1.totalFrames) {
    trace("OK.");
}
scenespropiedad 
scenes:Array  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Una matriz de objetos Scene que enumeran el nombre, el número de fotogramas y las etiquetas de fotogramas de una escena de la instancia de MovieClip.


Implementación
    public function get scenes():Array

Véase también


Ejemplo

El código siguiente ilustra el modo de utilizar la propiedad scenes de un objeto MovieClip denominado mc1:
import flash.display.Scene;

for (var i:uint = 0; i < mc1.scenes.length; i++) {
    var scene:Scene = mc1.scenes[i];
    trace("scene " + scene.name + ": " + scene.numFrames + " frames");
}
totalFramespropiedad 
totalFrames:int  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

El número total de fotogramas de la instancia de MovieClip.

Si el clip de película contiene varios fotogramas, la propiedad totalFrames devolverá el número de fotogramas para todas las escenas del clip de película.


Implementación
    public function get totalFrames():int

Ejemplo

El código siguiente ilustra el modo de utilizar la propiedad totalFrames de un objeto MovieClip denominado mc1:
 trace(mc1.totalFrames);
trackAsMenupropiedad 
trackAsMenu:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Indica si otros objetos de visualización que sean objetos SimpleButton o MovieClip pueden recibir eventos de liberación del botón del ratón. La propiedad trackAsMenu permite crear menús. Puede establecer la propiedad trackAsMenu en cualquier objeto SimpleButton o MovieClip. El valor predeterminado de la propiedad trackAsMenu es false.

Puede cambiar la propiedad trackAsMenu en cualquier momento; el clip de película modificado adoptará de inmediato el nuevo comportamiento.


Implementación
    public function get trackAsMenu():Boolean
    public function set trackAsMenu(value:Boolean):void

Ejemplo

El código siguiente ilustra el modo de utilizar la propiedad trackAsMenu para activar eventos de liberación del botón del ratón para un objeto MovieClip denominado mc1:
 mc1.trackAsMenu = true;
Información sobre constructores
MovieClip()constructor
public function MovieClip()

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea una nueva instancia de MovieClip. Tras crear el MovieClip, llame al método addChild() o addChildAt() de un contenedor de objeto de visualización que esté en el escenario.

Información sobre métodos
gotoAndPlay()método
public function gotoAndPlay(frame:Object, scene:String = null):void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Inicia la reproducción del archivo SWF en el fotograma especificado. Esto sucede después de que hayan terminado de ejecutarse todas las acciones restantes en el fotograma. Para especificar una escena además de un fotograma, especifique un valor para el parámetro scene.

Parámetros

frame:Object — Número que representa el número de fotograma o la cadena que representa la etiqueta del fotograma al que se envía la cabeza lectora. Si especifica un número, éste será relativo a la escena que especifique. Si no especifica ninguna escena, Flash Player utilizará la escena actual para determinar el número de fotograma global que debe reproducir. Si especifica una escena, la cabeza lectora saltará al número de fotograma de la escena especificada.
 
scene:String (default = null) — El nombre de la escena que debe reproducirse. Este parámetro es opcional.


Ejemplo

En el código siguiente, se utiliza el método gotoAndPlay() para ordenar a la cabeza lectora del clip de película mc1 que avance cinco fotogramas con respecto a su posición actual:
mc1.gotoAndPlay(mc1.currentFrame + 5);

En el código siguiente, se utiliza el método gotoAndPlay() para ordenar a la cabeza lectora del clip de película mc1 que avance al fotograma con la etiqueta "intro" de la escena "Scene 12":
mc1.gotoAndPlay("intro", "Scene 12");
gotoAndStop()método 
public function gotoAndStop(frame:Object, scene:String = null):void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Traslada la cabeza lectora al fotograma especificado del clip de película y la detiene en dicho lugar. Esto sucede después de que hayan terminado de ejecutarse todas las acciones restantes en el fotograma. Si desea especificar una escena además de un fotograma, especifique un parámetro scene.

Parámetros

frame:Object — Número que representa el número de fotograma o la cadena que representa la etiqueta del fotograma al que se envía la cabeza lectora. Si especifica un número, éste será relativo a la escena que especifique. Si no especifica ninguna escena, Flash Player utilizará la escena actual para determinar el número de fotograma global al que debe ir y se detendrá. Si especifica una escena, la cabeza lectora irá al número de fotograma de la escena especificada y se detendrá.
 
scene:String (default = null) — El nombre de la escena. Este parámetro es opcional.


Emite
ArgumentError — Si los valores de scene o frame especificados no se encuentran en este clip de película.

Ejemplo

En el código siguiente, se utiliza el método gotoAndStop() y la propiedad currentFrame para ordenar a la cabeza lectora del clip de película mc1 que avance cinco fotogramas con respecto a su posición actual y se detenga:
mc1.gotoAndStop(mc1.currentFrame + 5);

En el código siguiente, se utiliza el método gotoAndStop() para ordenar a la cabeza lectora del clip de película mc1 que avance al fotograma con la etiqueta "finale" de la escena "Scene 12" y detenga la cabeza lectora:
mc1.gotoAndStop("finale", "Scene 12");
nextFrame()método 
public function nextFrame():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Traslada la cabeza lectora al siguiente fotograma y la detiene en dicho punto. Esto sucede después de que hayan terminado de ejecutarse todas las acciones restantes en el fotograma.

Véase también


Ejemplo

En el ejemplo siguiente, dos objetos SimpleButton controlan la línea de tiempo. El botón prev desplaza la cabeza lectora al fotograma anterior, mientras que el botón nextBtn la desplaza al fotograma siguiente.

import flash.events.MouseEvent;

mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);

function goBack(event:MouseEvent):void {
    mc1.prevFrame();
}

function goForward(event:MouseEvent):void {
    mc1.nextFrame();
}
nextScene()método 
public function nextScene():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Mueve la cabeza lectora a la siguiente escena de la instancia de MovieClip. Esto sucede después de que hayan terminado de ejecutarse todas las acciones restantes en el fotograma.


Ejemplo

En el ejemplo siguiente, dos objetos SimpleButton controlan la línea de tiempo. El botón prevBtn desplaza la cabeza lectora a la escena anterior, mientras que el botón nextBtn la desplaza a la escena siguiente.

import flash.events.MouseEvent;

mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);

function goBack(event:MouseEvent):void {
    mc1.prevScene();
}

function goForward(event:MouseEvent):void {
    mc1.nextScene();
}
play()método 
public function play():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Mueve la cabeza lectora por la línea de tiempo del clip de película.

Véase también


Ejemplo

En el código siguiente, se utiliza el método stop() para detener un clip de película denominado mc1 y reanudar la reproducción cuando el usuario haga clic en el campo de texto continueText:

import flash.text.TextField;
import flash.events.MouseEvent;

var continueText:TextField = new TextField();
continueText.text = "Play movie...";
addChild(continueText);

mc1.stop();
continueText.addEventListener(MouseEvent.CLICK, resumeMovie);

function resumeMovie(event:MouseEvent):void {
    mc1.play();
}
prevFrame()método 
public function prevFrame():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Traslada la cabeza lectora al fotograma anterior y la detiene en dicho punto. Esto sucede después de que hayan terminado de ejecutarse todas las acciones restantes en el fotograma.


Ejemplo

En el ejemplo siguiente, dos objetos SimpleButton controlan la línea de tiempo. El botón prev desplaza la cabeza lectora al fotograma anterior, mientras que el botón nextBtn la desplaza al fotograma siguiente.

import flash.events.MouseEvent;

mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);

function goBack(event:MouseEvent):void {
    mc1.prevFrame();
}

function goForward(event:MouseEvent):void {
    mc1.nextFrame();
}
prevScene()método 
public function prevScene():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Mueve la cabeza lectora a la escena anterior de la instancia de MovieClip. Esto sucede después de que hayan terminado de ejecutarse todas las acciones restantes en el fotograma.


Ejemplo

En el ejemplo siguiente, dos objetos SimpleButton controlan la línea de tiempo. El botón prevBtn desplaza la cabeza lectora a la escena anterior, mientras que el botón nextBtn la desplaza a la escena siguiente.

import flash.events.MouseEvent;

mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);

function goBack(event:MouseEvent):void {
    mc1.prevScene();
}

function goForward(event:MouseEvent):void {
    mc1.nextScene();
}
stop()método 
public function stop():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Detiene la cabeza lectora en el clip de película.

Ejemplos Cómo utilizar los ejemplos
MovieClipExample.as

En el ejemplo siguiente, se utiliza la clase MovieClipExample para ilustrar cómo controlar varias propiedades de MovieClip. Esta tarea se consigue realizando los pasos siguientes:
  1. La función constructora define un campo de texto, que se utiliza para mostrar valores de propiedades del objeto MovieClipExample (que extiende MovieClip).
  2. El valor devuelto del método getPropertiesString() se utiliza como texto para el campo de texto outputText. El método getPropertiesString() devuelve una cadena llena de valores de las siguientes propiedades del clip de película: currentFrame, currentLabel, currentScene, framesLoaded, totalFrames y trackAsMenu.
  3. Dos líneas de código de la función constructora ajustan las propiedades width y height del campo de texto outputText.
  4. La última línea de la función constructora añade el campo de texto outputText a la lista de visualización.

package {
    import flash.display.MovieClip;
    import flash.text.TextField;

    public class MovieClipExample extends MovieClip {

        public function MovieClipExample() {
            var outputText:TextField = new TextField();
            outputText.text = getPropertiesString();
            outputText.width = stage.stageWidth;
            outputText.height = outputText.textHeight;
            addChild(outputText);
        }

        private function getPropertiesString():String {
            var str:String = ""
                + "currentFrame: " + currentFrame + "\n"
                + "currentLabel: " + currentLabel + "\n"
                + "currentScene: " + currentScene + "\n"
                + "framesLoaded: " + framesLoaded + "\n"
                + "totalFrames: " + totalFrames + "\n"
                + "trackAsMenu: " + trackAsMenu + "\n";
            return str;
        }
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/display/MovieClip.html