MovieClip  - AS3

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.

mc1.gotoAndStop(mc1.currentFrame + 5);

La etiqueta del fotograma actual en la línea de tiempo de la instancia de MovieClip. Si el fotograma actual no tiene ninguna etiqueta, currentLabel es null.

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.

trace(mc1.currentLabel);

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

Elementos de API relacionados

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);
}

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

Elementos de API relacionados

import flash.display.Scene;
 
var scene:Scene = mc1.currentScene;
trace(scene.name + ": " + scene.numFrames + " frames");

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.

mc1.enabled = false;

Número de fotogramas que se han cargado de un flujo de archivo SWF. Puede utilizar la propiedad framesLoaded 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.

Elementos de API relacionados

if (mc1.framesLoaded == mc1.totalFrames) {
    trace("OK.");
}

Valor booleano que indica si un clip de película se está reproduciendo.

Un conjunto 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.

Elementos de API relacionados

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");
}

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.

 trace(mc1.totalFrames);

Indica si otros objetos de visualización que sean objetos SimpleButton o MovieClip pueden recibir eventos de liberación de ratón o de entrada del usuario. 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.

 mc1.trackAsMenu = true;

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.

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

mc1.gotoAndPlay(mc1.currentFrame + 5);

mc1.gotoAndPlay("intro", "Scene 12");

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

mc1.gotoAndStop(mc1.currentFrame + 5);

mc1.gotoAndStop("finale", "Scene 12");

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.

Elementos de API relacionados

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();
}

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.

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();
}

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

Elementos de API relacionados

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();
}

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.

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();
}

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.

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();
}

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

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;
        }
    }
}