Pacote | flash.display |
Classe | public dynamic class MovieClip |
Herança | MovieClip Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Subclasses | FlexMovieClip, GravityBootstrap, LivePreviewParent, SystemManager, UIMovieClip, WindowedSystemManager |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ao contrário do objeto Sprite, um objeto MovieClip tem uma linha do tempo.
>No Flash Professional, os métodos para a classe MovieClip fornecem a mesma funcionalidade que as ações direcionadas a clipes de filme. Alguns métodos adicionais não têm ações equivalentes na caixa de ferramentas Ações, no painel Ações da ferramenta de autoria do Flash.
Instâncias-filho inseridas no Stage no Flash Professional, não podem ser acessadas pelo código a partir do construtor de uma instância-pai, já que não foram criadas nesse ponto da execução do código. Antes de acessar o filho, o pai deve, em vez disso, criar a ocorrência-filho por código ou atrasar o acesso a uma função de retorno de chamada que ouve o filho de modo a despachar seu evento Event.ADDED_TO_STAGE
.
Se você modifica alguma uma das seguintes propriedades de um objeto MovieClip que contém uma interpolação de movimento, o indicador de reprodução é interrompido nesse objeto MovieClip: alpha
, blendMode
, filters
, height
, opaqueBackground
, rotation
, scaleX
, scaleY
, scale9Grid
, scrollRect
, transform
, visible
, width
, x
ou y
. Entretanto, ele não interrompe o indicador de reprodução em nenhum objeto MovieClip filho desse objeto MovieClip.
Observação: Flash Lite 4 suportes a propriedade MovieClip.opaqueBackground apenas se FEATURE_BITMAPCACHE é definido. A configuração padrão do Flash Lite 4 não define FEATURE_BITMAPCACHE. Para ativar a propriedade MovieClip.opaqueBackground para um dispositivo apropriado, defina FEATURE_BITMAPCACHE no seu projeto.
Propriedade | Definido por | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
A implementação de acessibilidade atual (AccessibilityImplementation) para esta instância do InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
As opções de acessibilidade atuais para este objeto de exibição. | DisplayObject | ||
alpha : Number
Indica o valor de transparência alfa do objeto especificado. | DisplayObject | ||
blendMode : String
Um valor a partir da classe BlendMode que especifica o modo de mesclagem a ser usado. | DisplayObject | ||
blendShader : Shader [somente gravação]
Define um shader usado para mesclar o primeiro plano e o segundo plano. | DisplayObject | ||
buttonMode : Boolean
Especifica o modo de botão desta entidade gráfica. | Sprite | ||
cacheAsBitmap : Boolean
Se definido como true, tempo de execução do Flash armazenará em cachê uma representação interna em bitmap do objeto de exibição. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Se não nulo, este objeto Matrix definirá como um objeto exibição será renderizado quando cacheAsBitmap for definido como verdadeiro. | DisplayObject | ||
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
contextMenu : NativeMenu
Especifica o menu de contexto associado a este objeto. | InteractiveObject | ||
currentFrame : int [somente leitura]
Especifica o número do quadro no qual o indicador de reprodução está localizado na linha do tempo da ocorrência de MovieClip. | MovieClip | ||
currentFrameLabel : String [somente leitura]
O rótulo do quadro atual na linha de tempo da ocorrência de MovieClip. | MovieClip | ||
currentLabel : String [somente leitura]
O rótulo atual no qual o indicador de reprodução está localizado na linha do tempo da ocorrência de MovieClip. | MovieClip | ||
currentLabels : Array [somente leitura]
Retorna uma matriz de objetos FrameLabel a partir da cena atual. | MovieClip | ||
currentScene : Scene [somente leitura]
A cena atual na qual o indicador de reprodução está localizado na linha do tempo da ocorrência de MovieClip. | MovieClip | ||
doubleClickEnabled : Boolean
Especifica se o objeto recebe eventos doubleClick. | InteractiveObject | ||
dropTarget : DisplayObject [somente leitura]
Especifica o objeto de exibição sobre o qual a entidade gráfica está sendo arrastada ou no qual a entidade gráfica foi solta. | Sprite | ||
enabled : Boolean
Um valor booliano que indica se um clipe de filme está ativado. | MovieClip | ||
filters : Array
Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição. | DisplayObject | ||
focusRect : Object
Especifica se este objeto exibe um retângulo de foco. | InteractiveObject | ||
framesLoaded : int [somente leitura]
O número de quadros carregados a partir de um arquivo SWF de fluxo. | MovieClip | ||
graphics : Graphics [somente leitura]
Especifica o objeto Graphics pertencente a esta entidade gráfica em que comandos de desenho de vetor podem ocorrer. | Sprite | ||
height : Number
Indica a altura do objeto de exibição, em pixels. | DisplayObject | ||
hitArea : Sprite
Designa outra entidade gráfica para atuar como área de ocorrência para uma entidade gráfica. | Sprite | ||
isPlaying : Boolean [somente leitura]
Valor booliano que indica se um clipe de filme está sendo reproduzido. | MovieClip | ||
loaderInfo : LoaderInfo [somente leitura]
Retorna um objeto LoaderInfo contendo informações sobre o carregamento do arquivo ao qual esse objeto de exibição pertence. | DisplayObject | ||
mask : DisplayObject
O objeto de exibição de chamada é mascarado pelo objeto "mask" especificado. | DisplayObject | ||
metaData : Object
Obtém o objeto de metadados da instância DisplayObject se os metadados forem armazenados juntamente com a instância desse DisplayObject no arquivo SWF por uma marca PlaceObject4. | DisplayObject | ||
mouseChildren : Boolean
Determina se os filhos do objeto são ou não ativados pelo mouse, ou dispositivo de entrada do usuário. | DisplayObjectContainer | ||
mouseEnabled : Boolean
Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários. | InteractiveObject | ||
mouseX : Number [somente leitura]
Indica a coordenada x da posição do dispositivo do mouse ou de entrada do usuário, em pixels. | DisplayObject | ||
mouseY : Number [somente leitura]
Indica a coordenada y da posição do dispositivo do mouse ou de entrada do usuário, em pixels. | DisplayObject | ||
name : String
Indica o nome da ocorrência de DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Especifica se um teclado virtual (teclado de software, na tela) deve ser exibido quando esta instância InteractiveObject recebe foco. | InteractiveObject | ||
numChildren : int [somente leitura]
Retorna o número de filhos deste objeto. | DisplayObjectContainer | ||
opaqueBackground : Object
Especifica se o objeto de exibição é opaco com uma certa cor de plano de fundo. | DisplayObject | ||
parent : DisplayObjectContainer [somente leitura]
Indica o objeto DisplayObjectContainer que contém esse objeto de exibição. | DisplayObject | ||
root : DisplayObject [somente leitura]
Para um objeto de exibição em um arquivo SWF carregado, a propriedade "root" é o objeto de exibição na extremidade superior, na parte da estrutura em árvore da lista de exibição representada por esse arquivo SWF. | DisplayObject | ||
rotation : Number
Indica o giro da ocorrência de DisplayObject, em graus, a partir da sua orientação original. | DisplayObject | ||
rotationX : Number
Indica a rotação do eixo x da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent. | DisplayObject | ||
rotationY : Number
Indica a rotação do eixo y da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent. | DisplayObject | ||
rotationZ : Number
Indica a rotação do eixo z da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent. | DisplayObject | ||
scale9Grid : Rectangle
A grade de dimensionamento atual que está em vigor. | DisplayObject | ||
scaleX : Number
Indica a escala horizontal (porcentagem) do objeto aplicada a partir do ponto de registro. | DisplayObject | ||
scaleY : Number
Indica a escala vertical (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. | DisplayObject | ||
scaleZ : Number
Indica a escala de profundidade (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. | DisplayObject | ||
scenes : Array [somente leitura]
Uma matriz de objetos Scene, cada um listando o nome, o número de quadros e os rótulos de quadro para uma cena na ocorrência de MovieClip. | MovieClip | ||
scrollRect : Rectangle
Os limites do retângulo de rolagem do objeto de exibição. | DisplayObject | ||
softKeyboard : String
Controla a aparência do teclado suave. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Define a área que deve permanecer na tela quando um teclado virtual for exibido (não disponível no iOS) | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
Controla o som nesta entidade gráfica. | Sprite | ||
stage : Stage [somente leitura]
O Palco do objeto de exibição. | DisplayObject | ||
tabChildren : Boolean
Determina se os filhos do objeto estão ativados para tabulação. | DisplayObjectContainer | ||
tabEnabled : Boolean
Especifica se este objeto está na ordem de tabulação. | InteractiveObject | ||
tabIndex : int
Especifica a ordem de tabulação de objetos em um arquivo SWF. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [somente leitura]
Retorna um objeto TextSnapshot para essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
totalFrames : int [somente leitura]
O número total de quadros na ocorrência de MovieClip. | MovieClip | ||
trackAsMenu : Boolean
Indica se outros objetos da tela que são objetos de MovieClip ou SimpleButton podem receber eventos de liberação de mouse ou outros eventos de liberação de entrada do usuário. | MovieClip | ||
transform : flash.geom:Transform
Um objeto com propriedades relacionadas aos limites de pixels, matriz e transformação de cores de um objeto de exibição. | DisplayObject | ||
useHandCursor : Boolean
Um valor booliano que indica se a mão que aponta (cursor de mão) aparece quando o ponteiro passa sobre uma entidade gráfica em que a propriedade buttonMode esteja definida como "true". | Sprite | ||
visible : Boolean
Se o objeto de exibição está ou não visível. | DisplayObject | ||
width : Number
Indica a largura do objeto de exibição, em pixels. | DisplayObject | ||
x : Number
Indica a coordenada x da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. | DisplayObject | ||
y : Number
Indica a coordenada y da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. | DisplayObject | ||
z : Number
Indica a posição da coordenada z ao longo do eixo z da ocorrência DisplayObject em relação ao contêiner 3D pai. | DisplayObject |
Método | Definido por | ||
---|---|---|---|
Cria uma nova ocorrência de MovieClip. | MovieClip | ||
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | ||
Indica se restrições de segurança fariam com que qualquer objeto de exibição fosse omitido da lista retornada com a chamada do método DisplayObjectContainer.getObjectsUnderPoint() junto com o ponto especificado. | DisplayObjectContainer | ||
Determina se o objeto de exibição especificado é um filho da ocorrência de DisplayObjectContainer ou se é a própria ocorrência. | DisplayObjectContainer | ||
Envia um evento para o fluxo de eventos. | EventDispatcher | ||
Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace. | DisplayObject | ||
Retorna a ocorrência do objeto de exibição-filho que existe no índice especificado. | DisplayObjectContainer | ||
Retorna o objeto de exibição-filho que existe com o nome especificado. | DisplayObjectContainer | ||
Retorna a posição de índice de uma ocorrência-filho de DisplayObject. | DisplayObjectContainer | ||
Retorna uma matriz de objetos que estão dispostos no ponto especificado e são filhos (ou netos e assim por diante) desta ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
Retorna um retângulo que define o limite do objeto de exibição, com base no sistema de coordenadas definido pelo parâmetro espaçoCoordenadasDestino, excluindo quaisquer traçados em formas. | DisplayObject | ||
Converte o objeto de ponto a partir de coordenadas de Palco (globais) em coordenadas do objeto de exibição (locais). | DisplayObject | ||
Converte um ponto bidimensional das coordenadas do Palco (globais) em coordenadas do objeto de exibição tridimensional (locais). | DisplayObject | ||
Inicia a reprodução do arquivo SWF no quadro especificado. | MovieClip | ||
Traz o indicador de reprodução para o quadro especificado do clipe de filme e o interrompe nesse local. | MovieClip | ||
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Avalia a caixa delimitadora do objeto de exibição para ver se ela sobrepõe ou faz interseção com a caixa delimitadora do objeto de exibição obj. | DisplayObject | ||
Avalia o objeto de exibição para ver se ele sobrepõe ou faz interseção com o ponto especificado pelos parâmetros x e y. | DisplayObject | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Converte um ponto tridimensional das coordenadas (locais) do objeto de exibição tridimensional em ponto bidimensional das coordenadas (globais) do Palco. | DisplayObject | ||
Converte o objeto de ponto a partir das coordenadas do objeto de exibição (locais) em coordenadas do Palco (globais). | DisplayObject | ||
Envia o indicador de reprodução ao próximo quadro e o interrompe. | MovieClip | ||
Move o indicador de reprodução para a cena seguinte da ocorrência de MovieClip. | MovieClip | ||
Move o indicador de reprodução na linha do tempo do clipe de filme. | MovieClip | ||
Envia o indicador de reprodução ao quando anterior e o interrompe. | MovieClip | ||
Move o indicador de reprodução para a cena anterior da ocorrência de MovieClip. | MovieClip | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Remove uma ocorrência-filho de DisplayObject especificada da lista de filhos da ocorrência de DisplayObjectContainer. | DisplayObjectContainer | ||
Remove um DisplayObject filho da posição de índice especificada na lista de filhos de DisplayObjectContainer. | DisplayObjectContainer | ||
Remove todas as instâncias filho DisplayObject especificadas da lista de filhos da instância DisplayObjectContainer. | DisplayObjectContainer | ||
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | ||
Ativa um teclado virtual. | InteractiveObject | ||
Altera a posição de um filho existente no contêiner de objetos de exibição. | DisplayObjectContainer | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Permite ao usuário arrastar a entidade gráfica especificada. | Sprite | ||
Deixa o usuário arrastar o sprite especificado em um dispositivo ativado pelo toque. | Sprite | ||
Para o indicador de reprodução no clipe de filme. | MovieClip | ||
Interrompe repetitivamente a execução da linha de tempo de todos os MovieClips enraizados neste objeto. | DisplayObjectContainer | ||
Finaliza o método startDrag(). | Sprite | ||
Termina o método startTouchDrag() para o uso com dispositivos ativados pelo toque. | Sprite | ||
Alterna a ordem z (ordem da frente para trás) dos dois objetos filhos especificados. | DisplayObjectContainer | ||
Alterna a ordem z (ordem da frente para trás) dos objetos-filho nas duas posições de índice especificadas na lista de filhos. | DisplayObjectContainer | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
Retorna o valor primitivo do objeto especificado. | Object | ||
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher |
currentFrame | propriedade |
currentFrame:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica o número do quadro no qual o indicador de reprodução está localizado na linha do tempo da ocorrência de MovieClip. Se o clipe de filme tiver várias cenas, esse valor será o número do quadro na cena atual.
Implementação
public function get currentFrame():int
Exemplo ( Como usar este exemplo )
gotoAndStop()
e a propriedade currentFrame
para direcionar o indicador de reprodução do clipe de filme mc1
de forma a mover cinco quadros à frente do seu local atual e interromper:
mc1.gotoAndStop(mc1.currentFrame + 5);
currentFrameLabel | propriedade |
currentFrameLabel:String
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
O rótulo do quadro atual na linha de tempo da ocorrência de MovieClip. Se o quadro atual não tiver rótulo, currentLabel
será null
.
Implementação
public function get currentFrameLabel():String
currentLabel | propriedade |
currentLabel:String
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O rótulo atual no qual o indicador de reprodução está localizado na linha do tempo da ocorrência de MovieClip. Se o quadro atual não tiver rótulo, currentLabel
será definido como o nome do quadro anterior que inclui um rótulo. Se o quadro atual e os quadros anteriores não incluírem um rótulo, currentLabel
retornará null
.
Implementação
public function get currentLabel():String
Exemplo ( Como usar este exemplo )
currentLabel
de um objeto MovieClip denominado mc1
:
trace(mc1.currentLabel);
currentLabels | propriedade |
currentLabels:Array
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna uma matriz de objetos FrameLabel a partir da cena atual. Se a ocorrência de MovieClip não usar cenas, a matriz incluirá todos os rótulos de quadro dessa ocorrência inteira de MovieClip.
Implementação
public function get currentLabels():Array
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
currentLabels
de um 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); }
currentScene | propriedade |
currentScene:Scene
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A cena atual na qual o indicador de reprodução está localizado na linha do tempo da ocorrência de MovieClip.
Implementação
public function get currentScene():Scene
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
currentScene
de um objeto MovieClip denominado mc1
:
import flash.display.Scene; var scene:Scene = mc1.currentScene; trace(scene.name + ": " + scene.numFrames + " frames");
enabled | propriedade |
enabled:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor booliano que indica se um clipe de filme está ativado. O valor padrão de enabled
é true
. Se enabled
estiver definida como false
, os quadros Sobre, Para baixo e Acima serão desativados. O clipe de filme continuará a receber eventos (por exemplo, mouseDown
, mouseUp
, keyDown
e keyUp
).
A propriedade enabled
controla apenas as propriedades de botão de um clipe de filme. A propriedade enabled
pode ser alterada a qualquer momento; o clipe de filme é imediatamente ativado ou desativado. Se enabled
estiver definida como false
, o objeto não será incluído na ordenação automática da tabulação.
Implementação
public function get enabled():Boolean
public function set enabled(value:Boolean):void
Exemplo ( Como usar este exemplo )
enabled
para desativar as propriedades de botão de um objeto MovieClip denominado mc1
:
mc1.enabled = false;
framesLoaded | propriedade |
framesLoaded:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O número de quadros carregados a partir de um arquivo SWF de fluxo. Você pode usar a propriedade framesLoaded
para determinar se foram carregados o conteúdo de um quadro específico e de todos os quadros antes dele e estão disponíveis localmente no navegador. Ela também pode ser usada para monitorar o download de arquivos SWF grandes. Por exemplo, é possível exibir uma mensagem aos usuários indicando que o arquivo SWF está sendo carregado até um quadro específico nesse arquivo SWF terminar de ser carregado.
Se o clipe de filme tiver várias cenas, a propriedade framesLoaded
retornará o número de quadros carregados para todas as cenas no clipe de filme.
Implementação
public function get framesLoaded():int
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
framesLoaded
e totalFrames
para determinar se um objeto MovieClip de fluxo denominado mc1
está totalmente carregado:
if (mc1.framesLoaded == mc1.totalFrames) { trace("OK."); }
isPlaying | propriedade |
scenes | propriedade |
scenes:Array
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Uma matriz de objetos Scene, cada um listando o nome, o número de quadros e os rótulos de quadro para uma cena na ocorrência de MovieClip.
Implementação
public function get scenes():Array
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
scenes
de um 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"); }
totalFrames | propriedade |
totalFrames:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O número total de quadros na ocorrência de MovieClip.
Se o clipe de filme tiver vários quadros, a propriedade totalFrames
retornará o número total de quadros carregados em todas as cenas no clipe de filme.
Implementação
public function get totalFrames():int
Exemplo ( Como usar este exemplo )
totalFrames
de um objeto MovieClip denominado mc1
:
trace(mc1.totalFrames);
trackAsMenu | propriedade |
trackAsMenu:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Indica se outros objetos da tela que são objetos de MovieClip ou SimpleButton podem receber eventos de liberação de mouse ou outros eventos de liberação de entrada do usuário. A propriedade trackAsMenu
permite criar menus. Você pode definir a propriedade trackAsMenu
em qualquer objeto SimpleButton ou MovieClip. O valor padrão da propriedade trackAsMenu
é false
.
A propriedade trackAsMenu
pode ser alterada a qualquer momento; o clipe de filme modificado usa imediatamente o novo comportamento.
Implementação
public function get trackAsMenu():Boolean
public function set trackAsMenu(value:Boolean):void
Exemplo ( Como usar este exemplo )
trackAsMenu
de modo a ativar eventos de soltar o mouse para um objeto MovieClip denominado mc1
:
mc1.trackAsMenu = true;
MovieClip | () | Construtor |
public function MovieClip()
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cria uma nova ocorrência de MovieClip. Depois de criar MovieClip, chame o método addChild()
ou addChildAt()
de um contêiner de objeto de exibição que esteja no palco.
gotoAndPlay | () | método |
public function gotoAndPlay(frame:Object, scene:String = null):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Inicia a reprodução do arquivo SWF no quadro especificado. Isso acontecerá depois que a execução de todas as ações restantes no quadro tiver terminado. Para especificar uma cena e um quadro, especifique um valor para o parâmetro cena
.
Parâmetros
frame:Object — Um número que representa o número do quadro, ou uma string que representa o rótulo do quadro, ao qual o indicador de reprodução é despachado. Se você especificar um número, ele será relativo ao palco especificado. Se você não especificar uma cena, a cena atual determinará o número do quadro global a ser reproduzido. Se você especificar uma cena, o indicador de reprodução saltará para o número do quadro na cena especificada.
| |
scene:String (default = null ) — O nome da cena a ser reproduzida. Este parâmetro é opcional.
|
Exemplo ( Como usar este exemplo )
gotoAndPlay()
para direcionar o indicador de reprodução do clipe de filme mc1
de forma a mover cinco quadros à frente do seu local atual:
mc1.gotoAndPlay(mc1.currentFrame + 5);
gotoAndPlay()
para direcionar o indicador de reprodução do clipe de filme mc1
ao quadro com o rótulo "intro"
na cena denominada "Cena 12"
:
mc1.gotoAndPlay("intro", "Scene 12");
gotoAndStop | () | método |
public function gotoAndStop(frame:Object, scene:String = null):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Traz o indicador de reprodução para o quadro especificado do clipe de filme e o interrompe nesse local. Isso acontecerá depois que a execução de todas as ações restantes no quadro tiver terminado. Se você quiser especificar uma cena além de um quadro, especifique um parâmetro cena
.
Parâmetros
frame:Object — Um número que representa o número do quadro, ou uma string que representa o rótulo do quadro, ao qual o indicador de reprodução é despachado. Se você especificar um número, ele será relativo ao palco especificado. Se você não especificar uma cena, a cena atual determinará o número do quadro global a ser acessado e no qual parar. Se você especificar uma cena, o indicador de reprodução irá para o número do quadro na cena especificada e será interrompido.
| |
scene:String (default = null ) — O nome da cena. Este parâmetro é opcional.
|
Lança
ArgumentError — Se a cena ou o quadro especificado não for encontrado nesse clipe de filme.
|
Exemplo ( Como usar este exemplo )
gotoAndStop()
e a propriedade currentFrame
para direcionar o indicador de reprodução do clipe de filme mc1
de forma a mover cinco quadros à frente do seu local atual e interromper:
mc1.gotoAndStop(mc1.currentFrame + 5);
gotoAndStop()
para direcionar o indicador de reprodução do clipe de filme mc1
ao quadro com o rótulo "finale"
na cena denominada "Cena 12"
e interromper o indicador de reprodução:
mc1.gotoAndStop("finale", "Scene 12");
nextFrame | () | método |
public function nextFrame():void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Envia o indicador de reprodução ao próximo quadro e o interrompe. Isso acontecerá depois que a execução de todas as ações restantes no quadro tiver terminado.
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
prev
move o indicador de reprodução até o quadro anterior, enquanto o botão nextBtn
move o indicador de reprodução até o próximo quadro.
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
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Move o indicador de reprodução para a cena seguinte da ocorrência de MovieClip. Isso acontecerá depois que a execução de todas as ações restantes no quadro tiver terminado.
Exemplo ( Como usar este exemplo )
prevBtn
move o indicador de reprodução até o quadro anterior, enquanto o botão nextBtn
move o indicador de reprodução até a próxima cena.
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
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Move o indicador de reprodução na linha do tempo do clipe de filme.
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
stop()
para interromper um clipe de filme denominado mc1
e para reiniciar a reprodução quando o usuário clicar no campo de texto denominado 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
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Envia o indicador de reprodução ao quando anterior e o interrompe. Isso acontecerá depois que a execução de todas as ações restantes no quadro tiver terminado.
Exemplo ( Como usar este exemplo )
prev
move o indicador de reprodução até o quadro anterior, enquanto o botão nextBtn
move o indicador de reprodução até o próximo quadro.
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
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Move o indicador de reprodução para a cena anterior da ocorrência de MovieClip. Isso acontecerá depois que a execução de todas as ações restantes no quadro tiver terminado.
Exemplo ( Como usar este exemplo )
prevBtn
move o indicador de reprodução até o quadro anterior, enquanto o botão nextBtn
move o indicador de reprodução até a próxima cena.
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
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Para o indicador de reprodução no clipe de filme.
- A função de construtor define um campo de texto, que é usado para exibir valores de propriedades do objeto MovieClipExample (que estende MovieClip).
- O valor de retorno do método
getPropertiesString()
é usado como texto para o campo de textooutputText
. O métodogetPropertiesString()
retorna uma string que é preenchida com valores das seguintes propriedades do clipe de filme:currentFrame
,currentLabel
,currentScene
,framesLoaded
,totalFrames
etrackAsMenu
. - Duas linhas de código na função de construtor ajustam as propriedades de
largura
ealtura
do campo de textooutputText
. - A última linha da função de construtor adiciona o campo de texto
outputText
á lista de exibição.
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; } } }
Wed Jun 13 2018, 11:10 AM Z