MovieClip  - AS3

Specifica il numero del fotogramma della linea temporale dell'istanza MovieClip in cui si trova l'indicatore di riproduzione. Se il clip filmato comprende più scene, questo valore corrisponde al numero di fotogramma della scena corrente.

mc1.gotoAndStop(mc1.currentFrame + 5);

L'etichetta del fotogramma corrente nella linea temporale dell'istanza MovieClip. Se il fotogramma corrente è privo di etichetta, currentLabel è null.

L'etichetta corrente della linea temporale dell'istanza MovieClip in cui si trova l'indicatore di riproduzione. Se il fotogramma corrente non ha un'etichetta, currentLabel è impostato sul nome del precedente fotogramma dotato di un'etichetta. Se il fotogramma corrente e quelli precedenti non includono un'etichetta, currentLabel restituisce null.

trace(mc1.currentLabel);

Restituisce un array di oggetti FrameLabel della scena corrente. Se l'istanza MovieClip è priva di scene, l'array include tutte le etichette dei fotogrammi dell'intera istanza MovieClip.

Elementi API correlati

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 scena corrente della linea temporale dell'istanza MovieClip in cui si trova l'indicatore di riproduzione.

Elementi API correlati

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

Un valore booleano che indica se un clip filmato è attivo. Il valore predefinito di enabled è true. Se enabled è impostato su false, i fotogrammi Sopra, Giù e Su vengono disabilitati. Il clip filmato continua a ricevere gli eventi (ad esempio, mouseDown, mouseUp, keyDown e keyUp).

La proprietà enabled regola solo le proprietà di un clip filmato simili a pulsanti. È possibile modificare la proprietà enabled in qualsiasi momento; il clip filmato modificato viene immediatamente abilitato o disabilitato. Se enabled è impostata su false, l'oggetto non viene incluso nell'ordine di tabulazione automatico.

mc1.enabled = false;

Il numero di fotogrammi caricati da un file SWF in streaming. Potete utilizzare la proprietà frameLoaded per determinare se il contenuto di un fotogramma specifico e tutti i fotogrammi che lo precedono sono stati caricati e sono disponibili a livello locale nel browser. È utile anche per monitorare lo scaricamento dei file SWF di grandi dimensioni. Ad esempio, potete visualizzare un messaggio che indica all'utente che il caricamento del file SWF continua finché non è terminato il caricamento di uno specifico fotogramma nel file SWF.

Se il clip filmato comprende più scene, la proprietà framesLoaded restituisce il numero di fotogrammi caricati per tutte le scene del clip filmato.

Elementi API correlati

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

Un valore booleano che indica se un clip filmato è in corso di riproduzione.

Un array di oggetti Scene, ciascuno con nome, numero di fotogrammi e etichette dei fotogrammi per una scena dell'istanza MovieClip.

Elementi API correlati

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

Il numero totale di fotogrammi dell'istanza MovieClip.

Se il clip filmato comprende più fotogrammi, la proprietà totalFrames restituisce il numero totale di fotogrammi di tutte le scene del clip filmato.

 trace(mc1.totalFrames);

Indica se altri oggetti di visualizzazione del tipo SimpleButton o MovieClip possono ricevere gli eventi di rilascio del mouse o altri eventi di rilascio dell'input dell'utente. La proprietà trackAsMenu consente di creare menu. Potete impostare la proprietà trackAsMenu su qualunque oggetto SimpleButton o MovieClip. Il valore predefinito della proprietà trackAsMenu è false.

Potete modificare la proprietà trackAsMenu in qualsiasi momento; il clip filmato modificato utilizza immediatamente il nuovo comportamento.

 mc1.trackAsMenu = true;

Crea una nuova istanza MovieClip. Dopo aver creato l'istanza MovieClip, chiamate il metodo addChild() o addChildAt() di un contenitore di oggetto di visualizzazione che si trova sullo stage.

Avvia la riproduzione del file SWF dal fotogramma specificato. Questa azione viene eseguita dopo l'esecuzione di tutte le altre azioni del fotogramma. Per specificare una scena oltre a un fotogramma, fornite un valore per il parametro scene.

Parametri

mc1.gotoAndPlay(mc1.currentFrame + 5);

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

Posiziona l'indicatore di riproduzione sul fotogramma specificato del clip filmato. Questa azione viene eseguita dopo l'esecuzione di tutte le altre azioni del fotogramma. Per specificare una scena oltre a un fotogramma, utilizzate il parametro scene.

Parametri

mc1.gotoAndStop(mc1.currentFrame + 5);

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

Invia l'indicatore di riproduzione al fotogramma successivo e lo interrompe. Questa azione viene eseguita dopo l'esecuzione di tutte le altre azioni del fotogramma.

Elementi API correlati

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

Sposta l'indicatore di riproduzione sulla scena successiva dell'istanza MovieClip. Questa azione viene eseguita dopo l'esecuzione di tutte le altre azioni del fotogramma.

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

Sposta l'indicatore di riproduzione nella linea temporale del clip filmato.

Elementi API correlati

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

Invia l'indicatore di riproduzione al fotogramma precedente e lo interrompe. Questa azione viene eseguita dopo l'esecuzione di tutte le altre azioni del fotogramma.

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

Sposta l'indicatore di riproduzione sulla scena precedente dell'istanza MovieClip. Questa azione viene eseguita dopo l'esecuzione di tutte le altre azioni del fotogramma.

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

Ferma l'indicatore di riproduzione nel clip filmato.

1. La funzione di costruzione definisce un campo di testo, che viene utilizzato per visualizzare i valori delle proprietà dell'oggetto MovieClipExample (che estende MovieClip).
2. Il valore restituito dal metodo getPropertiesString() viene utilizzato come testo per il campo di testo outputText. Il metodo getPropertiesString() restituisce una stringa che viene compilata con i valori delle seguenti proprietà del clip filmato: currentFrame, currentLabel, currentScene, framesLoaded, totalFrames e trackAsMenu.
3. Le proprietà width e height del campo di testo outputText sono regolate da due righe di codice nella funzione di costruzione.
4. L'ultima riga della funzione di costruzione aggiunge il campo di testo outputText all'elenco di visualizzazione.

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