Pacote | flash.display |
Classe | public class Stage |
Herança | Stage DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Para conteúdo SWF em execução no navegador (no Flash® Player), o Palco representa toda a área em que o conteúdo rich media é mostrado. Para conteúdo em execução no AIR em sistemas operacionais para desktop, cada objeto NativeWindow tem um objeto Stage correspondente.
O objeto Stage não é globalmente acessível. Ele precisa ser acessado por meio da propriedade stage
de uma ocorrência de DisplayObject.
A classe Stage tem várias classes predecessoras — DisplayObjectContainer, InteractiveObject, DisplayObject e EventDispatcher — a partir das quais ela herda propriedades e métodos. Muitas dessas propriedades e métodos são inaplicáveis a objetos Stage ou exigem verificações de segurança quando chamadas em um objeto Stage. As propriedades e os métodos que exigem verificações de segurança são documentos como parte da classe Stage.
Além disso, as seguintes propriedades herdadas são inaplicáveis a objetos Stage. Se você tentar defini-las, um IllegalOperationError será lançado. Essas propriedades podem sempre ser lidas; mas, como não podem ser definidas, elas sempre irão conter valores padrão.
-
accessibilityProperties
-
alpha
-
blendMode
-
cacheAsBitmap
-
contextMenu
-
filters
-
focusRect
-
loaderInfo
-
mask
-
mouseEnabled
-
name
-
opaqueBackground
-
rotation
-
scale9Grid
-
scaleX
-
scaleY
-
scrollRect
-
tabEnabled
-
tabIndex
-
transform
-
visible
-
x
-
y
Alguns eventos que você supõe que façam parte da classe Stage, por exemplo, enterFrame
, exitFrame
, frameConstructed
e render
, não podem ser eventos de palco porque não há garantia de que exista uma referência ao objeto Stage em todas as situações em que esses eventos são usados. Como esses eventos não podem ser despachados pelo objeto Stage, eles são despachados por todas as ocorrências de DisplayObject, ou seja, você pode adicionar um ouvinte de evento a qualquer ocorrência de DisplayObject para ouvir esses eventos. Esses eventos, que fazem parte da classe DisplayObject, são chamados eventos de transmissão para diferenciá-los dos eventos destinados a uma ocorrência específica de DisplayObject. Dois outros eventos de transmissão, activate
e deactivate
, pertencem à subclasse de DisplayObject, EventDispatcher. Os eventos activate
e deactivate
se comportam de modo semelhante aos eventos de transmissão DisplayObject, exceto pelo fato de que esses dois eventos são despachados não só por todas as ocorrências de DisplayObject, mas também por todas as ocorrências de EventDispatcher e ocorrências de outras subclasses EventDispatcher. Para obter mais informações sobre eventos de transmissão, consulte a classe DisplayObject.
Elementos da API relacionados
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 | ||
align : String
Um valor da classe StageAlign que especifica o alinhamento do palco no Flash Player ou no navegador. | Stage | ||
allowsFullScreen : Boolean [somente leitura]
Especifica se este palco permite o uso do modo de tela inteira
| Stage | ||
allowsFullScreenInteractive : Boolean [somente leitura]
Especifica se este palco permite o uso do modo de tela inteira com entrada de texto
| Stage | ||
alpha : Number
Indica o valor de transparência alfa do objeto especificado. | DisplayObject | ||
autoOrients : Boolean
Especifica se o palco é automaticamente reorientado quando a orientação do dispositivo é alterada. | Stage | ||
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 | ||
browserZoomFactor : Number [somente leitura]
Especifica o fator de zoom do navegador. | Stage | ||
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 | ||
color : uint
A cor do fundo de SWF. | Stage | ||
colorCorrection : String
Controla a correção de cores do tempo de execução do Flash para monitores. | Stage | ||
colorCorrectionSupport : String [somente leitura]
Especifica se o tempo de execução do Flash está em execução em um sistema operacional que ofereça suporte à correção de cores e se o perfil de cor do monitor principal pode ser lido e reconhecido pelo tempo de execução do Flash. | Stage | ||
constructor : * | Stage | ||
contentsScaleFactor : Number [somente leitura]
Especifica o fator de dimensionamento de pixel eficaz do palco. | Stage | ||
contextMenu : NativeMenu
Especifica o menu de contexto associado a este objeto. | InteractiveObject | ||
deviceOrientation : String [somente leitura]
A orientação física do dispositivo. | Stage | ||
displayState : String
Um valor a partir da classe StageDisplayState que especifica o estado de exibição a ser usado. | Stage | ||
doubleClickEnabled : Boolean
Especifica se o objeto recebe eventos doubleClick. | InteractiveObject | ||
filters : Array
Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição. | DisplayObject | ||
focus : InteractiveObject
O objeto interativo com foco do teclado; ou "null" se o foco não estiver definido ou se o objeto focado pertencer a uma área de segurança à qual o objeto de chamada não tem acesso. | Stage | ||
focusRect : Object
Especifica se este objeto exibe um retângulo de foco. | InteractiveObject | ||
frameRate : Number
Obtém e define a velocidade de projeção do palco. | Stage | ||
fullScreenHeight : uint [somente leitura]
Retorna a altura do monitor que será usado na transferência para o tamanho de tela cheia, se esse estado for acessado imediatamente. | Stage | ||
fullScreenSourceRect : Rectangle
Define o tempo de execução do Flash para dimensionar uma região específica do palco para o modo de tela cheia. | Stage | ||
fullScreenWidth : uint [somente leitura]
Retorna a largura do monitor que será usado na transferência para o tamanho de tela cheia, se esse estado for acessado imediatamente. | Stage | ||
height : Number [substituir]
Indica a altura do objeto de exibição, em pixels. | Stage | ||
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 [substituir]
Determina se os filhos do objeto são ou não ativados pelo mouse, ou dispositivo de entrada do usuário. | Stage | ||
mouseEnabled : Boolean
Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários. | InteractiveObject | ||
mouseLock : Boolean
Defina como true para ativar o travamento de mouse. | Stage | ||
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 | ||
nativeWindow : NativeWindow [somente leitura]
Uma referência ao objeto NativeWindow que contém este Palco. | Stage | ||
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 [substituir] [somente leitura]
Retorna o número de filhos deste objeto. | Stage | ||
opaqueBackground : Object
Especifica se o objeto de exibição é opaco com uma certa cor de plano de fundo. | DisplayObject | ||
orientation : String [somente leitura]
A orientação atual do palco. | Stage | ||
parent : DisplayObjectContainer [somente leitura]
Indica o objeto DisplayObjectContainer que contém esse objeto de exibição. | DisplayObject | ||
quality : String
Um valor a partir da classe StageQuality que especifica a qualidade de renderização usada. | Stage | ||
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 | ||
scaleMode : String
Um valor a partir da classe StageScaleMode que especifica o modo de escala a ser usado. | Stage | ||
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 | ||
scrollRect : Rectangle
Os limites do retângulo de rolagem do objeto de exibição. | DisplayObject | ||
showDefaultContextMenu : Boolean
Especifica se os itens padrão serão mostrados ou ocultados no menu de contexto do tempo de execução do Flash. | Stage | ||
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 | ||
softKeyboardRect : Rectangle [somente leitura]
Um Retângulo que especifica a área do palco que, no momento, está coberta por um teclado virtual. | Stage | ||
stage : Stage [somente leitura]
O Palco do objeto de exibição. | DisplayObject | ||
stage3Ds : Vector.<Stage3D> [somente leitura]
Uma lista de objetos Stage3D disponíveis para exibir o conteúdo tridimensional. | Stage | ||
stageFocusRect : Boolean
Especifica se os objetos exibem ou não uma borda brilhante quando possuem foco. | Stage | ||
stageHeight : int
A altura atual, em pixels, do Palco. | Stage | ||
stageVideos : Vector.<StageVideo> [somente leitura]
Uma lista de objetos StageVideo disponíveis para reprodução de vídeos externos. | Stage | ||
stageWidth : int
Especifica a largura atual, em pixels, do Palco. | Stage | ||
supportedOrientations : Vector.<String> [somente leitura]
As orientações com suporte no dispositivo atual. | Stage | ||
supportsOrientationChange : Boolean [estático] [somente leitura]
Se o aplicativo suporta mudanças na orientação de tomada (e rotação de dispositivo). | Stage | ||
tabChildren : Boolean [substituir]
Determina se os filhos do objeto estão ativados para tabulação. | Stage | ||
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 [substituir] [somente leitura]
Retorna um objeto TextSnapshot para essa ocorrência de DisplayObjectContainer. | Stage | ||
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 | ||
visible : Boolean
Se o objeto de exibição está ou não visível. | DisplayObject | ||
vsyncEnabled : Boolean
Isso representa o estado atual de vsync de uma solução de gráficos subjacente. Podemos habilitar/desabilitar a sincronização, para renderizar imediatamente sem precisar esperar pelo próximo estado VSYNC. | Stage | ||
width : Number [substituir]
Indica a largura do objeto de exibição, em pixels. | Stage | ||
wmodeGPU : Boolean [somente leitura]
Indica se a composição de GPU está disponível e em uso. | Stage | ||
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 | ||
---|---|---|---|
[substituir]
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. | Stage | ||
[substituir]
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. | Stage | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [substituir]
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | Stage | ||
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 | ||
Define o foco do teclado como o objeto interativo especificado pelo objectToFocus, com a direção do foco especificada pelo parâmetro de direção. | Stage | ||
Determina se o objeto de exibição especificado é um filho da ocorrência de DisplayObjectContainer ou se é a própria ocorrência. | DisplayObjectContainer | ||
[substituir]
Envia um evento para o fluxo de eventos. | Stage | ||
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 | ||
[substituir]
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | Stage | ||
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 | ||
Chamar o método invalidate() dá um sinal para que o Flash Player alerte os objetos de exibição na próxima oportunidade que tiver de renderizar a lista de exibição (por exemplo, quando o indicador de reprodução avança para um novo quadro). | Stage | ||
Determina se a propriedade Stage.focus retornará "null" por motivos de segurança. | Stage | ||
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 | ||
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 | ||
[substituir]
Remove um DisplayObject filho da posição de índice especificada na lista de filhos de DisplayObjectContainer. | Stage | ||
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 | ||
Define o palco com uma orientação com a proporção especificada. | Stage | ||
[substituir]
Altera a posição de um filho existente no contêiner de objetos de exibição. | Stage | ||
Define o palco com a orientação especificada. | Stage | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Interrompe repetitivamente a execução da linha de tempo de todos os MovieClips enraizados neste objeto. | DisplayObjectContainer | ||
Alterna a ordem z (ordem da frente para trás) dos dois objetos filhos especificados. | DisplayObjectContainer | ||
[substituir]
Alterna a ordem z (ordem da frente para trás) dos objetos-filho nas duas posições de índice especificadas na lista de filhos. | Stage | ||
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 | ||
[substituir]
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | Stage |
Evento | Resumo | Definido por | ||
---|---|---|---|---|
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
Despachado quando um objeto de exibição é adicionado à lista de exibição. | DisplayObject | |||
Despachado quando um objeto de exibição é adicionado à lista de exibição no palco, seja diretamente ou através da adição de uma subárvore na qual esse objeto de exibição está contido. | DisplayObject | |||
Despachado quando a propriedade browserZoomFactor do objeto Palco é alterada. | Stage | |||
Despachado quando o usuário seleciona "Clear" (ou "Delete") no menu de contexto do texto. | InteractiveObject | |||
Despachado quando um usuário pressiona e solta o botão principal do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | |||
Despachado quando uma ação do usuário seleciona o menu de contexto associado a esse objeto interativo em um aplicativo do AIR. | InteractiveObject | |||
Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de copiar ou seleciona "Copy" no menu de contexto do texto. | InteractiveObject | |||
Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de cortar ou seleciona "Cut" no menu de contexto do texto. | InteractiveObject | |||
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
Despachado quando um usuário pressiona e solta o botão principal de um dispositivo apontador duas vezes em rápida sucessão sobre o mesmo InteractiveObject quando o sinalizador doubleClickEnabled desse objeto está definido como "true". | InteractiveObject | |||
[evento de transmissão] Despachado quando o indicador de reprodução está entrando em um novo quadro. | DisplayObject | |||
[evento de transmissão] Despachado quando o indicador de reprodução está deixando o quadro atual. | DisplayObject | |||
Despachado depois que um objeto de exibição ganha foco. | InteractiveObject | |||
Despachado depois que um objeto de exibição perde o foco. | InteractiveObject | |||
[evento de transmissão] Despachado depois que são executados os construtores dos objetos de exibição de quadro, mas antes dos scripts. | DisplayObject | |||
Despachado quando o objeto Stage entra no modo de tela cheia ou sai desse modo. | Stage | |||
Enviado quando um usuário cria um ponto de contato na borda da superfície de toque com uma instância InteractiveObject (como tocar na borda da superfície de toque no Siri Remote da Apple TV). Alguns dispositivos também podem interpretar esse contato como uma combinação de vários eventos de toque. | InteractiveObject | |||
Despachado quando o usuário aperta dois pontos de contato na mesma instância InteractiveObject em um dispositivo ativado pelo toque (como pressionar e soltar dois dedos em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário move um ponto de contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como mover os dedos da esquerda para a direita em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário executa uma rotação em um ponto do contato com uma instância InteractiveObject (como tocar com dois dedos e rodá-los em cima de um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário executa um gesto de arrastar em um ponto de contato com uma instância InteractiveObject (como tocar três dedos em uma tela e depois movê-los em paralelo sobre um objeto de exposição em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário cria um ponto do contato com uma instância InteractiveObject, depois toca com um dispositivo ativado pelo toque (como colocar vários dedos em um objeto da tela para abrir um menu e depois toca com um dedo para selecionar um item do menu em um celular ou tablet com tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário executa um zoom em um ponto do contato com uma instância InteractiveObject (como tocar dois dedos em uma tela e depois abrir os dedos por cima de um objeto de exposição em um celular ou tablet com uma tela de toque). | InteractiveObject | |||
Este evento é despachado para qualquer aplicativo cliente que suporte a entrada incorporada com um IME | InteractiveObject | |||
Despachado quando o usuário pressiona uma tecla. | InteractiveObject | |||
Despachado quando o usuário tenta alterar o foco usando a navegação pelo teclado. | InteractiveObject | |||
Despachado quando o usuário solta uma tecla. | InteractiveObject | |||
Despachado quando um usuário pressiona e libera o botão do meio do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário pressiona o botão do meio do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário tenta alterar o foco usando um dispositivo apontador. | InteractiveObject | |||
Despachado pelo objeto Stage quando o ponteiro do se move para fora da área do palco. | Stage | |||
Despachado quando um usuário move o dispositivo apontador enquanto ele está sobre InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando a roda do mouse rola sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado pelo iniciador de arrasto InteractiveObject quando o usuário libera o gesto de arrastar. | InteractiveObject | |||
Despachado pelo InteractiveObject de destino quando um objeto arrastado é solto nele e a liberação tiver sido aceita com uma chamada para DragManager.acceptDragDrop(). | InteractiveObject | |||
Despachado por um InteractiveObject quando o gesto de arrasto entra no respectivo limite. | InteractiveObject | |||
Despachado por um InteractiveObject quando o gesto de arrasto deixa o respectivo limite. | InteractiveObject | |||
Despachado continuamente por um InteractiveObject enquanto o gesto de arrasto permanecer dentro do respectivo limite. | InteractiveObject | |||
Despachado no início de uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag(). | InteractiveObject | |||
Despachado durante uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag(). | InteractiveObject | |||
Despachado pelo objeto Stage quando a orientação do palco é alterada. | Stage | |||
Despachado pelo objeto Stage quando a orientação do palco começa a ser alterada. | Stage | |||
Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de colar ou seleciona "Paste" no menu de contexto do texto. | InteractiveObject | |||
Despachado quando o usuário abaixa um estilo ativo para além do limite de detecção de proximidade da tela. | InteractiveObject | |||
Despachado quando o usuário levanta um estilo ativo acima do limite de detecção de proximidade da tela. | InteractiveObject | |||
Despachado quando o usuário move um estilo ativo sobre a tela enquanto permanece dentro do limite de detecção de proximidade. | InteractiveObject | |||
Despachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela. | InteractiveObject | |||
Despachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela. | InteractiveObject | |||
Despachado quando o usuário move um estilo ativo deste InteractiveObject e algum de seus filhos enquanto permanece dentro do limite de detecção de proximidade da tela. | InteractiveObject | |||
Despachado quando o usuário move um estilo ativo sobre este InteractiveObject do exterior da árvore do objeto de descendentes na lista de exibição (enquanto permanece dentro do limite de detecção de proximidade da tela). | InteractiveObject | |||
Enviado quando um usuário solta o botão no dispositivo apontador depois que o usuário primeiro pressionou o botão sobre uma instância de InteractiveObject e moveu o dispositivo apontador de da instância para fora do InteractiveObject. | InteractiveObject | |||
Despachado quando um objeto de exibição está prestes a ser removido da lista de exibição. | DisplayObject | |||
Despachado quando um objeto de exibição está prestes a ser removido da lista de exibição, seja diretamente ou através da remoção de uma subárvore na qual esse objeto de exibição está contido. | DisplayObject | |||
[evento de transmissão] Despachado quando a lista de exibição está prestes a ser atualizada e renderizada. | DisplayObject | |||
Despachado quando a propriedade scaleMode do objeto Stage é definida como StageScaleMode.NO_SCALE e o arquivo SWF é redimensionado. | Stage | |||
Despachado quando um usuário pressiona e libera o botão direito do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de selecionar tudo ou seleciona "Select All" no menu de contexto do texto. | InteractiveObject | |||
Despachado imediatamente depois que o teclado virtual é elevado. | InteractiveObject | |||
Despachado imediatamente antes de o teclado virtual ser elevado. | InteractiveObject | |||
Despachado imediatamente depois que o teclado virtual é baixado. | InteractiveObject | |||
Despachado pelo objeto Stage quando o estado da propriedade stageVideos é alterado. | Stage | |||
Despachado quando o valor do sinalizador tabChildren do objeto é alterado. | InteractiveObject | |||
Despachado quando o sinalizador tabEnabled do objeto é alterado. | InteractiveObject | |||
Despachado quando o valor da propriedade tabIndex do objeto é alterado. | InteractiveObject | |||
Despachado quando um usuário introduz um ou vários caracteres do texto. | InteractiveObject | |||
Despachado quando o usuário entra em contato pela primeira vez com um dispositivo ativado pelo toque (como tocar com um dedo um celular ou tablet com uma tela sensível toque). | InteractiveObject | |||
Despachado quando o usuário remove o contato com um dispositivo ativado pelo toque (como retirar o dedo de um celular ou tablet com uma tela de toque). | InteractiveObject | |||
Despachado quando o usuário toca o dispositivo, e é despachado continuamente até que o ponto contato seja removido. | InteractiveObject | |||
Despachado quando o usuário move o ponto do contato longe da instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para outro em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário move o ponto do contato longe de uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para um ponto fora do objeto da tela em um celular ou tablet com uma tela sensível toque). | InteractiveObject | |||
Despachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Despachado quando o usuário levanta o ponto do contato na mesma instância InteractiveObject em que o contato foi iniciado em um dispositivo ativado pelo toque (como pressionar e soltar com o dedo um ponto único em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | |||
Enviado pelo objeto Stage quando o estado da propriedade vsync é alterado. | Stage |
align | propriedade |
align:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor da classe StageAlign que especifica o alinhamento do palco no Flash Player ou no navegador. Os seguintes valores são válidos:
Valor | Alinhamento vertical | Horizontal |
---|---|---|
StageAlign.TOP | Superior | Centro |
StageAlign.BOTTOM | Inferior | Centro |
StageAlign.LEFT | Centro | À Esquerda |
StageAlign.RIGHT | Centro | À Direita |
StageAlign.TOP_LEFT | Superior | À Esquerda |
StageAlign.TOP_RIGHT | Superior | À Direita |
StageAlign.BOTTOM_LEFT | Inferior | À Esquerda |
StageAlign.BOTTOM_RIGHT | Inferior | À Direita |
A propriedade align
apenas está disponível a um objeto na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do objeto de chamada, chamando o método Security.allowDomain()
ou Security.alowInsecureDomain()
. Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
Implementação
public function get align():String
public function set align(value:String):void
Elementos da API relacionados
allowsFullScreen | propriedade |
allowsFullScreenInteractive | propriedade |
autoOrients | propriedade |
autoOrients:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2 |
Especifica se o palco é automaticamente reorientado quando a orientação do dispositivo é alterada.
O valor desta propriedade é derivado do elemento autoOrients
do descritor de aplicativo e assume false
como padrão. Ao alterar a propriedade para false
, o comportamento não será garantido. Em alguns dispositivos, o palco permanece na orientação atual. Em outros, a orientação do palco se altera para uma orientação "padrão" definida pelo dispositivo, depois da qual não ocorre nenhuma nova alteração da orientação do palco.
Suporte a perfil do AIR: este recurso conta com suporte em dispositivos móveis, mas não é compatível com sistemas operacionais para desktop nem com dispositivos AIR for TV. Você pode testar o suporte para tempo de execução utilizando a propriedadeStage.supportsOrientantionChange
. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Implementação
public function get autoOrients():Boolean
public function set autoOrients(value:Boolean):void
Elementos da API relacionados
browserZoomFactor | propriedade |
browserZoomFactor:Number
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 15 |
Especifica o fator de zoom do navegador. Uma alteração no fator de zoom do navegador afeta o fator de dimensionamento do palco.
Implementação
public function get browserZoomFactor():Number
color | propriedade |
colorCorrection | propriedade |
colorCorrection:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5 |
Controla a correção de cores do tempo de execução do Flash para monitores. A correção de cores só funcionará se for atribuído ao monitor principal um perfil de cor ICC válido que especifica os atributos específicos de cor do monitor. Por padrão, o tempo de execução do Flash tenta adotar a correção de cores de seu host (geralmente um navegador).
Use a propriedade Stage.colorCorrectionSupport
para determinar se a correção de cores está disponível no sistema atual e o estado padrão. . Se a correção de cor estiver disponível, presume-se que todas as cores no Palco estão no espaço de cor sRGB, que é o espaço de cor mais padrão. Os perfis de origem dos dispositivos de entrada não são considerados durante a correção de cor. Não se aplica correção de cor de entrada; apenas a saída do palco é mapeada para o perfil de cor ICC do monitor principal.
Em geral, entre os benefícios de ativar o gerenciamento de cor estão cores previsíveis e consistentes, melhor conversão, testes precisos e uma saída em várias mídias mais eficiente. Porém, lembre-se de que o gerenciamento de cor não fornece conversões perfeitas porque os dispositivos apresentam gamas diferentes entre si ou imagens originais. O gerenciamento de cor também não elimina a necessidade de perfis personalizados ou editados. Os perfis de cor dependem dos navegadores, dos sistemas operacionais, de suas extensões, dos dispositivos de saída e do suporte ao aplicativo.
A aplicação da correção de cor reduz o desempenho do tempo de execução do Flash. A correção de cor do tempo de execução do Flash é uma correção de cor do estilo do documento porque todos os filmes SWF são considerados documentos com perfis sRGB implícitos. Use a propriedade Stage.colorCorrectionSupport
para dizer ao tempo de execução de Flash corrigir as cores exibindo o arquivo SWF (documento) ao espaço da cor da tela. O tempo de execução do Flash só compensa diferenças entre monitores, e não diferenças entre dispositivos de entrada (câmera, scanner, etc.).
Os três valores possíveis são strings com constantes correspondentes na classe flash.display.ColorCorrection:
"default"
: usa a mesma correção de cores do sistema host."on"
: sempre realiza a correção de cores."off"
: nunca realiza a correção de cores.
Implementação
public function get colorCorrection():String
public function set colorCorrection(value:String):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
Stage.colorCorrection
não for um valor da classe ColorCorrection, então o controlador informa um erro.
function addHandler(add_event:Event) { switch(stage.colorCorrection) { case ColorCorrection.ON: stage.colorCorrection = ColorCorrection.OFF; lblCMEnableState.text = "State: " + stage.colorCorrection; break; case ColorCorrection.OFF: stage.colorCorrection = ColorCorrection.DEFAULT; lblCMEnableState.text = "State: " + stage.colorCorrection; break; case ColorCorrection.DEFAULT: stage.colorCorrection = ColorCorrection.ON; lblCMEnableState.text = "State: " + stage.colorCorrection; break; default: lblCMEnableState.text = "Error."; break; }
colorCorrectionSupport | propriedade |
colorCorrectionSupport:String
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica se o tempo de execução do Flash está em execução em um sistema operacional que ofereça suporte à correção de cores e se o perfil de cor do monitor principal pode ser lido e reconhecido pelo tempo de execução do Flash. Essa propriedade também retorna o estado padrão da correção de cores no sistema host (geralmente o navegador). Atualmente os valores de retorno podem ser:
Os três valores possíveis são strings com constantes correspondentes na classe flash.display.ColorCorrectionSupport:
"unsupported"
: a correção de cores não está disponível."defaultOn"
: sempre realiza a correção de cores."defaultOff"
: nunca realiza a correção de cores.
Implementação
public function get colorCorrectionSupport():String
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
stage.colorCorrectionSupport
para ver se é DEFAULT_ON
ou DEFAULT_OFF
, valores da classe ColorCorrectionSupport. Se a propriedade for um dos valores, então o campo de texto exibe o valor atual. De outra maneira, se o valor não for DEFAULT_ON
nem DEFAULT_OFF
, o campo de texto exibe "não suportado".
function addHandler(add_event:Event) { if (stage.colorCorrectionSupport == ColorCorrectionSupport.DEFAULT_ON || stage.colorCorrectionSupport == ColorCorrectionSupport.DEFAULT_OFF) { lblHasCM.text = "stage.colorCorrectionSupport: " + stage.colorCorrectionSupport; } else { lblHasCM.text = "stage.colorCorrectionSupport: unsupported"; } }
constructor | propriedade |
contentsScaleFactor | propriedade |
contentsScaleFactor:Number
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 11.5 |
Especifica o fator de dimensionamento de pixel eficaz do palco. Esse valor é 1 em telas padrão e em telas HiDPI (tela Retina). Quando o palco é renderizado em telas HiDPI, a resolução de pixel é dobrada, mesmo se o modo de dimensionamento de palco for definido como StageScaleMode.NO_SCALE. Stage.stageWidth e Stage.stageHeight continuam a ser reportados em unidades de pixel clássicas.
Implementação
public function get contentsScaleFactor():Number
deviceOrientation | propriedade |
deviceOrientation:String
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2 |
A orientação física do dispositivo.
Em dispositivos com teclados deslizantes, o estado do teclado tem uma prioridade mais alta na determinação da orientação do dispositivo do que a rotação detectada pelo acelerômetro. Assim, em um dispositivo com proporção de retrato com um teclado montado lateralmente, a propriedade deviceOrientation
indicará ROTATED_LEFT
quando o teclado estiver aberto, independentemente de como o usuário estiver segurando o dispositivo.
Use as constantes definidas na classe StageOrientation ao definir ou comparar valores desta propriedade.
Suporte a perfil do AIR: este recurso conta com suporte em dispositivos móveis, mas não é compatível com sistemas operacionais para desktop nem com dispositivos AIR for TV. Você pode testar o suporte em tempo de execução usando a propriedade Stage.supportsOrientationChange
. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Implementação
public function get deviceOrientation():String
Elementos da API relacionados
displayState | propriedade |
displayState:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Um valor a partir da classe StageDisplayState que especifica o estado de exibição a ser usado. Os seguintes valores são válidos:
StageDisplayState.FULL_SCREEN
define o aplicativo ou o conteúdo AIR no Flash Player para expandir o palco por toda a tela do usuário. A entrada do teclado está desativada, com a exceção de uma seleção limitada de teclas de não impressão.StageDisplayState.FULL_SCREEN_INTERACTIVE
Define o aplicativo para expandir o palco sobre a tela inteira do usuário, com a entrada de teclado ativada. (Disponível no AIR e no Flash Player, a partir do Flash Player 11.3.)StageDisplayState.NORMAL
define o palco de volta ao modo de exibição padrão do palco.
O comportamento de dimensionamento do filme no modo de tela cheia é determinado pela configuração de scaleMode
(definida usando a propriedade Stage.scaleMode
ou as configurações da marca embed
do arquivo SWF no arquivo HTML). Se a propriedade scaleMode
for definida como noScale
enquanto o aplicativo transicionar para o modo de tela cheia, as propriedades width
e height
do Palco serão atualizadas e o Palco despachará um evento resize
. Se algum outro modo de escala for definido, o palco e seu conteúdo serão dimensionados de modo a preencherem as novas dimensões de tela. O objeto Stage conserva seus valores originais de width
e height
e não despacha um evento resize
.
As restrições seguintes aplicam-se a arquivos SWF reproduzidos em uma página HTML (não os que usam o Flash Player independente ou que não são executados no runtime do AIR):
- Para ativar o modo de tela cheia, adicione o parâmetro
allowFullScreen
às marcasobject
eembed
na página HTML que inclui o arquivo SWF, comallowFullScreen
definido como"true"
, como mostra o exemplo a seguir:<param name="allowFullScreen" value="true" /> ... <embed src="example.swf" allowFullScreen="true" ... >
Uma página HTML também pode usar um script para gerar marcas de incorporação SWF. É necessário alterar o script para que ele insira as configurações corretas de
allowFullScreen
. As páginas HTML geradas pelo Flash e pelo Flex Builder usam a funçãoAC_FL_RunContent()
para incorporar referências a arquivos SWF e você precisa adicionar as configurações do parâmetroallowFullScreen
, conforme a seguir:AC_FL_RunContent( ... "allowFullScreen", "true", ... )
- O modo de tela cheia é iniciado em resposta a um clique do mouse ou a um pressionamento de tecla pelo usuário; o filme não pode alterar
Stage.displayState
sem a entrada do usuário. O tempo de execução do Flash restringe a entrada de teclado no modo de tela cheia. As teclas aceitáveis incluem atalhos do teclado que encerram o modo de tela cheia e teclas não imprimíveis, por exemplo, teclas de setas, de espaço, Shift e Tab. (Use o modo de tela cheia interativo para obter o suporte à entrada de teclas adicionais.) Os atalhos de teclado que encerram o modo de tela cheia são os seguintes: Escape (Windows, Linux e Mac), Ctrl+W (Windows), Command+W (Mac) e Alt+F4. - A partir do Flash Player 9.0.115.0, a tela cheia funciona de forma idêntica no modo sem janela e no modo com janela. Se você definir o Modo de janela (
wmode
no HTML) como Opaque Windowless (opaque
) or Transparent Windowless(transparent
), a tela cheia poderá ser iniciada, mas a janela de tela cheia sempre será opaca. - Para ativar o modo interativo de tela cheia que oferece suporte à interatividade do teclado, adicione o parâmetro
allowFullScreenInteractive
às marcasobject
eembed
na página HTML que inclui o arquivo SWF, comallowFullScreenInteractive
definido como"true"
, como mostra o exemplo a seguir:<param name="allowFullScreenInteractive" value="true" /> ...
Essas restrições não estão presentes no conteúdo SWF em execução no Flash Player independente ou no AIR.
Ao entrar no modo de tela cheia, o runtime do Flash exibe brevemente uma notificação sobre o conteúdo SWF para informar aos usuários de que eles estão no modo de tela cheia e que podem pressionar a tecla Escape para sair do modo de tela cheia.
Ao entrar no modo interativo de tela cheia, o Flash Player exibe um prompt de confirmação sobre o conteúdo SWF, permitindo que os usuários permitam acesso a entrada estendida de teclado (incluindo teclas de impressão) e informando aos usuários de que eles podem pressionar a tecla Escape para sair do modo interativo de tela cheia. Você não deve presumir a aparência/localização do prompt de confirmação. Você pode determinar se os usuários permitiram acesso à entrada estendida de teclado observando o evento FullScreenEvent.FULL_SCREEN_INTERACTIVE_ACCEPTED
.
Para o conteúdo do AIR executando no modo tela-cheia, as opções de protetor de tela do sistema e de economia de energia elétrica são desativadas enquanto o conteúdo de vídeo é reproduzido e até que o vídeo pare ou se saia do modo tela-cheia.
No Linux, definir displayState
para StageDisplayState. FULL_SCREEN
ou StageDisplayState.FULL_SCREEN_INTERACTIVE
é uma operação assíncrona.
Implementação
public function get displayState():String
public function set displayState(value:String):void
Lança
SecurityError — Chamar a propriedade displayState de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0. Um erro de segurança será lançado se houver uma tentativa de definir a propriedade displayState enquanto a caixa de diálogo de configuração estiver exibida, sem uma resposta do usuário, ou se o atributo allowFullScreen da marca HTML param ou embed não estiver definido como true .
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
displayState
. Observação: A tela cheia apenas pode ser acionada em certas situações, como se o usuário tiver clicado ou pressionado uma tecla, devido a restrições de segurança. Quando executada em um navegador, a propriedade allowFullScreen deve ser definida como "true".
package { import flash.display.Sprite; import flash.display.Stage; import flash.events.*; import flash.net.NetConnection; import flash.net.NetStream; import flash.media.Video; public class FullScreenExample extends Sprite { private var videoURL:String = "testVideo.flv"; private var connection:NetConnection; private var stream:NetStream; private var video:Video; public function FullScreenExample() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); loaderInfo.addEventListener(Event.INIT, createMouseListener); } private function createMouseListener(event:Event):void { stage.addEventListener(MouseEvent.CLICK,toggleFullScreen); } private function toggleFullScreen(event:MouseEvent):void { switch(stage.displayState) { case "normal": stage.displayState = "fullScreen"; break; case "fullScreen": default: stage.displayState = "normal"; break; } } // Video related: private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); video = new Video(stage.stageWidth,stage.stageHeight); video.attachNetStream(stream); stream.play(videoURL); addChild(video); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } } }
focus | propriedade |
focus:InteractiveObject
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O objeto interativo com foco do teclado; ou null
se o foco não estiver definido ou se o objeto focado pertencer a uma área de segurança à qual o objeto de chamada não tem acesso.
Implementação
public function get focus():InteractiveObject
public function set focus(value:InteractiveObject):void
Lança
Error — Lançará um erro se o foco não puder ser definido no destino.
|
Exemplo ( Como usar este exemplo )
myTF
, de forma que o usuário pode iniciar a digitação sem a necessidade de clicar em algo. Em dispositivos móveis iOS e Android e em dispositivos tvOS, o usuário precisa clicar no campo de texto para ativar o teclado virtual. Se você testar este código dentro da interface de ferramenta de autoria, você só poderá ter acesso a algumas chaves porque o host (navegador ou ferramenta) interpreta a maioria dos pressionamentos de teclas primeiro. Para ver este exemplo funcionando como desejado, compile-o e execute o arquivo SWF.
var myTF:TextField = new TextField(); myTF.border =true; myTF.type = TextFieldType.INPUT; addChild(myTF); stage.focus= myTF;
frameRate | propriedade |
frameRate:Number
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Obtém e define a velocidade de projeção do palco. A velocidade de projeção é definida como quadros por segundo. Por padrão, a taxa é definida como a velocidade de projeção do primeiro arquivo SWF carregado. A faixa válida para a velocidade de projeção é de 0,01 a 1000 quadros por segundo.
Observação: Um aplicativo pode não ser capaz de seguir configurações de taxa de quadros altas, seja porque a plataforma de destino não é rápida o bastante ou porque o player está sincronizado com a duração em branco vertical do dispositivo de exibição (em geral, 60 Hz em dispositivos LCD). Em alguns casos, uma plataforma de destino também poderá optar por reduzir a taxa de quadros máxima se antecipar o alto uso da CPU.
Para conteúdo em execução no Adobe AIR, configurar a propriedade frameRate
de um objeto Stage altera a taxa de quadros de todos os objetos Stage (usados por objetos NativeWindow diferentes).
Implementação
public function get frameRate():Number
public function set frameRate(value:Number):void
Lança
SecurityError — Chamar a propriedade frameRate de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
fullScreenHeight | propriedade |
fullScreenHeight:uint
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Retorna a altura do monitor que será usado na transferência para o tamanho de tela cheia, se esse estado for acessado imediatamente. Se o usuário tiver vários monitores, o monitor usado será aquele que contém a maior parte do palco no momento.
Observação: Se o usuário tiver a oportunidade de mover o navegador de um monitor para outro entre a recuperação do valor e o acesso ao tamanho de tela cheia, o valor poderá estar incorreto. Se você recuperar o valor em um manipulador de evento que defina Stage.displayState
como StageDisplayState.FULL_SCREEN
, o valor estará correto.
Essa é a altura de pixels do monitor e será idêntica à altura do palco se a propriedade Stage.align
estiver definida como StageAlign.TOP_LEFT
e a propriedade Stage.scaleMode
estiver definida como StageScaleMode.NO_SCALE
.
Implementação
public function get fullScreenHeight():uint
Elementos da API relacionados
fullScreenSourceRect
fullScreenWidth
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Exemplo ( Como usar este exemplo )
enterFullScreen()
, que define a propriedade fullScreenSourceRect
e entra no modo de tela cheia. Para definir a propriedade fullScreenSourceRect
, o manipulador de eventos começa com a localização e as dimensões do quadrado vermelho. Em seguida, ele compara a proporção (largura dividida pela altura) do quadrado vermelho com a proporção do palco na larga e altura em tela cheia, para poder expandir o retângulo (fullScreenSourceRect
) de forma a corresponder a proporção da tela. O resultado é que o quadrado vermelho ocupa a altura inteira do monitor, com o plano de fundo verde visível em cada lado. Se a proporção não tivesse sido correspondida, a cor de plano de fundo do palco, que é o branco por padrão, seria exibida em cada lado no lugar do plano de fundo verde.
Observação: teste este exemplo no navegador. Na caixa de diálogo Configurações de publicação Flash, na guia HTML, selecione o modelo Somente Flash – Permitir tela inteira. Especifique o Flash Player versão 9.0.115.0 e certifique-se de que os formatos Flash e HTML estejam selecionados na guia Formatos. Em seguida, publique e abra o arquivo HTML resultante no navegador.
import flash.display.Sprite; import flash.display.Stage; import flash.display.StageDisplayState; import flash.events.MouseEvent; import flash.geom.Rectangle; // cover the stage with a green rectangle var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight); addChild(greenRect); // create red square on stage, turn it into a button for going to full screen var redSquare:Sprite = new Sprite(); redSquare.graphics.beginFill(0xFF0000); redSquare.graphics.drawRect(0, 0, 300, 300); redSquare.x = 50; redSquare.y = 50; redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen); redSquare.buttonMode = true; addChild(redSquare); function enterFullScreen(e:MouseEvent):void { // we will go to full screen zoomed in on the red square var redSquare:Sprite = e.target as Sprite; var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height); // calculate aspect ratio of the red square var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height; // calculate aspect ratio of the screen var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight; // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare // try commenting out this section to see what happens if you do not fix the aspect ratio. if (rectAspectRatio > screenAspectRatio) { var newHeight:Number = fullScreenRect.width / screenAspectRatio; fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2); fullScreenRect.height = newHeight; } else if (rectAspectRatio < screenAspectRatio) { var newWidth:Number = fullScreenRect.height * screenAspectRatio; fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2); fullScreenRect.width = newWidth; } // go to full screen stage.fullScreenSourceRect = fullScreenRect; stage.displayState = StageDisplayState.FULL_SCREEN; }
fullScreenSourceRect | propriedade |
fullScreenSourceRect:Rectangle
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Define o tempo de execução do Flash para dimensionar uma região específica do palco para o modo de tela cheia. Se disponível, o tempo de execução do Flash dimensiona em hardware, quem usa a placa gráfica e de vídeo no computador de um usuário, e geralmente exibe o conteúdo mais rápido que no dimensionamento por software.
Quando essa propriedade é definida como um retângulo válido e a propriedade displayState
é definida como o modo de tela cheia, o tempo de execução do Flash dimensiona a área especificada. O tamanho real de Stage em pixels no ActionScript não é alterado. O tempo de execução do Flash força um limite mínimo para o tamanho do retângulo de forma a acomodar a mensagem padrão "Pressione Esc para sair do modo de tela cheia". Em geral, esse limite está em torno de 260 por 30 pixels, mas pode variar de acordo com a plataforma e a versão do tempo de execução do Flash.
Essa propriedade apenas pode ser definida quando o tempo de execução do Flash não está no modo de tela cheia. Para usá-la corretamente, defina-a primeiro e então defina a propriedade displayState
como o modo de tela cheia, como mostra os exemplos de código. Observação: No Flash Player 15 e em versões posteriores, essa propriedade pode ser definida mesmo quando o tempo de execução de Flash estiver no modo de tela cheia.
Para ativar o dimensionamento, defina a propriedade fullScreenSourceRect
como um objeto de retângulo:
// valid, will enable hardware scaling stage.fullScreenSourceRect = new Rectangle(0,0,320,240);
Para desativar o dimensionamento, defina fullScreenSourceRect=null
no ActionScript 3.0 e undefined
no ActionScript 2.0.
stage.fullScreenSourceRect = null;
O usuário final também pode optar nas Configurações de exibição Flash Player por desativar o dimensionamento em hardware, que está ativado por padrão. Para obter mais informações, consulte www.adobe.com/go/display_settings_br.
Implementação
public function get fullScreenSourceRect():Rectangle
public function set fullScreenSourceRect(value:Rectangle):void
Elementos da API relacionados
Stage.displayState
Stage.scaleMode
flash.events.FullScreenEvent
flash.events.Event.RESIZE
Exemplo ( Como usar este exemplo )
import flash.geom.*; { stage.fullScreenSourceRect = new Rectangle(0,0,320,240); stage.displayState = StageDisplayState.FULL_SCREEN; }
Antes de usar o modo de tela cheia com o dimensionamento em hardware, as condições a seguir devem ser atendidas:
- Flash Player versão 9.0.115.0 ou posterior é necessário, bem como uma ferramenta de autoria que lhe ofereça suporte.
- Os modelos HTML precisam ser modificados para oferecer suporte à tela cheia. O atributo
allowFullScreen
deve ser definido comotrue
para as marcasobject
eembed
. (Os scripts que geram marcas de incorporação SWF também devem permitir a tela cheia.) Para obter uma amostra de arquivos que podem ser usados para o Flex Builder, consulte o artigo Exploring full-screen mode in Flash Player 9 - Seu aplicativo deve ter permissão e acesso a um arquivo de vídeo FLV. Neste exemplo, supõe-se que o arquivo FLV (Flash Video) esteja no mesmo diretório que o arquivo SWF.
- O usuário deve permitir acesso a tela cheia.
- Para obter informações adicionais sobre dimensionamento em hardware, consulte o artigo Exploring Flash Player support for high-definition H.264 video and AAC audio for Flash Player ("Explorando o suporte do Flash Player para vídeo H.264 de alta definição e áudio AAC").
Um arquivo FLV é carregado com o uso dos objetos NetConnection e NetStream. Como o arquivo FLV está no mesmo diretório que o arquivo SWF e se conectará via HTTP, o parâmetro do método NetConnection.connect()
é definido como null
. O objeto NetConnection connect
informa seu status despachando um evento netStatus
que invoca o método netStatusHandler()
. O método netStatusHandler()
verifica se a conexão foi bem-sucedida e invoca o método connectStream()
, que cria um objeto NetStream que usa o objeto NetConnection como parâmetro. Ele também cria um objeto de vídeo e anexa o objeto NetStream a esse objeto. O objeto de vídeo é então adicionado à lista de exibição, e o fluxo é definido para reprodução. Como o arquivo de vídeo FLV não contém metadados ou informações sobre pontos de sinalização, um evento AsyncError
será despachado. Um ouvinte precisa ser configurado para manipular esse evento. Aqui, o ouvinte é configurado e ignora o evento. Outro ouvinte para o evento netStatus
também é configurado para o objeto NetStream. Ele exibirá uma mensagem de erro se o fluxo não for encontrado. (Observe que netStatusHandler()
pode ser usado para manipular qualquer número de diferentes informações de status relatadas para o fluxo ou a conexão.)
Quando as propriedades e os métodos de um arquivo SWF carregado estão acessíveis, o método createMouseListener()
é invocado. Ele configura um ouvinte de evento para o momento em que o mouse for clicado no palco. O método toggleFullScreen()
verifica se o estado de exibição está no modo de tela normal ou cheia. Se estiver no modo normal, o tamanho do objeto de vídeo será definido como o tamanho do fluxo de vídeo. A propriedade fullScreenSourceRect
é definida como um retângulo que corresponde às dimensões do objeto de vídeo. Em seguida, a propriedade Stage.displayMode
é definida como tela cheia, fazendo com que o vídeo no retângulo de origem se expanda de forma a preencher a área da tela cheia. Se os requisitos do sistema forem atendidos, o hardware gráfico do computador será usado para melhorar o desempenho da renderização de vídeo em tela cheia, e o estado de exibição será definido para o modo de tela cheia. Para detectar qualquer erro de segurança que possa ocorrer ao alternar para o modo de tela cheia, uma instrução try...catch
é usada. (Observe que o estado de exibição precisa ser definido para o modo de tela cheia após a definição da propriedade fullScreenSourceRect
.) Antes de alternar para o modo de tela normal, a largura e a altura do objeto de vídeo voltam a ter os valores do objeto de vídeo original salvo. Caso contrário, as alterações feitas no objeto de vídeo para o modo de tela cheia determinarão a largura e a altura.
package { import flash.display.Sprite; import flash.display.StageDisplayState; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; import flash.events.NetStatusEvent; import flash.events.AsyncErrorEvent; import flash.events.SecurityErrorEvent; import flash.events.MouseEvent; import flash.events.Event; import flash.geom.Rectangle; public class Stage_fullScreenSourceRectExample2 extends Sprite { private var videoURL:String = "testVideo1.flv"; private var connection:NetConnection; private var stream:NetStream; private var myVideo:Video; private var savedWidth:uint; private var savedHeight:uint; public function Stage_fullScreenSourceRectExample2() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); loaderInfo.addEventListener(Event.INIT, createMouseListener); } private function createMouseListener(event:Event):void { stage.addEventListener(MouseEvent.CLICK, toggleFullScreen); } private function toggleFullScreen(event:MouseEvent):void { if(stage.displayState == StageDisplayState.NORMAL) { myVideo.width = myVideo.videoWidth; myVideo.height = myVideo.videoHeight; try { stage.fullScreenSourceRect = new Rectangle(myVideo.x, myVideo.y, myVideo.width, myVideo.height); stage.displayState = StageDisplayState.FULL_SCREEN; } catch (e:SecurityError) { trace ("A security error occurred while switching to full screen: " + event); myVideo.width = savedWidth; myVideo.height = savedHeight; } }else { myVideo.width = savedWidth; myVideo.height = savedHeight; stage.displayState = StageDisplayState.NORMAL; } } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace ("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); myVideo = new Video(); myVideo.attachNetStream(stream); stream.play(videoURL); savedWidth = myVideo.width; savedHeight = myVideo.height; addChild(myVideo); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { } } }
fullScreenWidth | propriedade |
fullScreenWidth:uint
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Retorna a largura do monitor que será usado na transferência para o tamanho de tela cheia, se esse estado for acessado imediatamente. Se o usuário tiver vários monitores, o monitor usado será aquele que contém a maior parte do palco no momento.
Observação: Se o usuário tiver a oportunidade de mover o navegador de um monitor para outro entre a recuperação do valor e o acesso ao tamanho de tela cheia, o valor poderá estar incorreto. Se você recuperar o valor em um manipulador de evento que defina Stage.displayState
como StageDisplayState.FULL_SCREEN
, o valor estará correto.
Essa é a largura de pixels do monitor e será idêntica à largura do palco se a propriedade Stage.align
estiver definida como StageAlign.TOP_LEFT
e a propriedade Stage.scaleMode
estiver definida como StageScaleMode.NO_SCALE
.
Implementação
public function get fullScreenWidth():uint
Elementos da API relacionados
fullScreenHeight
fullScreenSourceRect
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Exemplo ( Como usar este exemplo )
enterFullScreen()
, que define a propriedade fullScreenSourceRect
e entra no modo de tela cheia. Para definir a propriedade fullScreenSourceRect
, o manipulador de eventos começa com a localização e as dimensões do quadrado vermelho. Em seguida, ele compara a proporção (largura dividida pela altura) do quadrado vermelho com a proporção do palco na larga e altura em tela cheia, para poder expandir o retângulo (fullScreenSourceRect
) de forma a corresponder a proporção da tela. O resultado é que o quadrado vermelho ocupa a altura inteira do monitor, com o plano de fundo verde visível em cada lado. Se a proporção não tivesse sido correspondida, a cor de plano de fundo do palco, que é o branco por padrão, seria exibida em cada lado no lugar do plano de fundo verde.
Observação: teste este exemplo no navegador. Na caixa de diálogo Configurações de publicação Flash, na guia HTML, selecione o modelo Somente Flash – Permitir tela inteira. Especifique o Flash Player versão 9.0.115.0 e certifique-se de que os formatos Flash e HTML estejam selecionados na guia Formatos. Em seguida, publique e abra o arquivo HTML resultante no navegador.
import flash.display.Sprite; import flash.display.Stage; import flash.display.StageDisplayState; import flash.events.MouseEvent; import flash.geom.Rectangle; // cover the stage with a green rectangle var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight); addChild(greenRect); // create red square on stage, turn it into a button for going to full screen var redSquare:Sprite = new Sprite(); redSquare.graphics.beginFill(0xFF0000); redSquare.graphics.drawRect(0, 0, 300, 300); redSquare.x = 50; redSquare.y = 50; redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen); redSquare.buttonMode = true; addChild(redSquare); function enterFullScreen(e:MouseEvent):void { // we will go to full screen zoomed in on the red square var redSquare:Sprite = e.target as Sprite; var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height); // calculate aspect ratio of the red square var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height; // calculate aspect ratio of the screen var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight; // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare // try commenting out this section to see what happens if you do not fix the aspect ratio. if (rectAspectRatio > screenAspectRatio) { var newHeight:Number = fullScreenRect.width / screenAspectRatio; fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2); fullScreenRect.height = newHeight; } else if (rectAspectRatio < screenAspectRatio) { var newWidth:Number = fullScreenRect.height * screenAspectRatio; fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2); fullScreenRect.width = newWidth; } // go to full screen stage.fullScreenSourceRect = fullScreenRect; stage.displayState = StageDisplayState.FULL_SCREEN; }
height | propriedade |
height:Number
[substituir] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica a altura do objeto de exibição, em pixels. A altura é calculada com base nos limites do conteúdo do objeto de exibição. Quando você define a propriedade height
, a propriedade scaleY
é ajustada de acordo, como mostra o código a seguir:
var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(0, 0, 100, 100); trace(rect.scaleY) // 1; rect.height = 200; trace(rect.scaleY) // 2;
Exceto para objetos TextField e Video, um objeto de exibição sem conteúdo (como uma entidade gráfica vazia) tem uma altura de 0, mesmo que você tente definir height
como um valor diferente.
Implementação
override public function get height():Number
override public function set height(value:Number):void
Lança
SecurityError — Fazer referência à propriedade height de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
| |
IllegalOperationError — É sempre ilegal definir a propriedade height de um objeto Stage, mesmo que o objeto de chamada seja o proprietário do Palco (o arquivo SWF principal).
|
mouseChildren | propriedade |
mouseChildren:Boolean
[substituir] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina se os filhos do objeto são ou não ativados pelo mouse, ou dispositivo de entrada do usuário. Se um objeto estiver ativado,um usuário pode interagir com ele usando um mouse ou dispositivo de entrada do usuário. O padrão é true
.
Essa propriedade é útil quando você cria um botão com uma ocorrência da classe Sprite (em vez de usar a classe SimpleButton). Ao usar uma ocorrência de Sprite para criar um botão, você pode optar por decorar esse botão usando o método addChild()
para incluir ocorrências adicionais de Sprite. Esse processo pode causar um comportamento inesperado com eventos de mouse, já que as ocorrências de Sprite adicionadas como filhos podem se tornar o objeto de destino de um evento de mouse, quando você espera que a ocorrência-pai seja o objeto de destino. Para garantir que a ocorrência-pai atue como o objeto de destino para eventos de mouse, defina a propriedade mouseChildren
dessa ocorrência como false
.
Nenhum evento é despachado com o uso dessa propriedade. É necessário usar o método addEventListener()
para criar uma funcionalidade interativa.
Implementação
override public function get mouseChildren():Boolean
override public function set mouseChildren(value:Boolean):void
Lança
SecurityError — Fazer referência à propriedade mouseChildren de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
mouseLock | propriedade |
mouseLock:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 11.2, AIR 3.2 |
Defina como true
para ativar o travamento de mouse. A ativação do travamento de mouse desativa o cursor e permite o movimento sem restrições do mouse. Você somente pode ativar o travamento do mouse no modo de tela cheia para aplicativos de área de trabalho. Se você configurar em aplicativos que não estejam no modo de tela cheia ou em aplicativos em dispositivos móveis, criará uma exceção.
O travamento de mouse é desativado automaticamente e o cursor do mouse aparece novamente quando:
- O usuário sai do modo de tela cheia usando a tecla Esc (todas as plataformas), Control-W (Windows), Command-W (Mac) ou Alt-F4 (Windows).
- A janela do aplicativo perde o foco.
- Qualquer UI de configuração está visível, incluindo todas as caixas de diálogo de privacidade.
- Uma caixa de diálogo é mostrada, como uma caixa de diálogo de carregamento de arquivo.
Ao sair do modo de tela cheia, esta propriedade será configurada automaticamente como false
.
Eventos associados a movimentos do mouse, como o evento mouseMove
, use a classe MouseEvent para representar o objeto do evento. Quando o travamento do mouse estiver desativado, use as propriedades MouseEvent.localX
e MouseEvent.localY
para determinar a localização do mouse. Quando o travamento do mouse estiver ativado, use as propriedades MouseEvent.movementX
e MouseEvent.movementY
para determinar a localização do mouse. As propriedades movementX
e movementY
contêm alterações na posição do mouse desde o último evento, em vez das coordenadas absolutas da localização do mouse.
Observação: quando o aplicativo está no modo de tela cheia, os ouvintes de evento anexados aos objetos de exibição diferentes do Palco não são despachados. Portanto, para receber deltas de mouse e qualquer outro evento de mouse quando mouseLock
é true
, anexe os ouvintes de evento de mouse ao objeto de Palco.
Implementação
public function get mouseLock():Boolean
public function set mouseLock(value:Boolean):void
Elementos da API relacionados
nativeWindow | propriedade |
nativeWindow:NativeWindow
[somente leitura] Versões de runtime: | AIR 1.0, Flash Lite 4 |
Uma referência ao objeto NativeWindow que contém este Palco.
A janela representa a janela do sistema operacional nativo; o Palco representa o conteúdo contido na janela. Esta propriedade é válida somente para conteúdo em execução no AIR em plataformas com suporte à classe NativeWindow. Em outras plataformas, esta propriedade será null
. No Flash Player (conteúdo em execução em um navegador), esta propriedade será null
.
Implementação
public function get nativeWindow():NativeWindow
numChildren | propriedade |
numChildren:int
[somente leitura] [substituir] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna o número de filhos deste objeto.
Implementação
override public function get numChildren():int
Lança
SecurityError — Fazer referência à propriedade numChildren de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Stage (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
orientation | propriedade |
orientation:String
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2 |
A orientação atual do palco. Esta propriedade é definida para um dos quatro valores, definidos como constantes na classe StageOrientation:
Constante StageOrientation | Orientação do palco |
---|---|
StageOrientation.DEFAULT | A tela está na orientação padrão (o lado direito para cima). |
StageOrientation.ROTATED_RIGHT | A tela é girada para a direita. |
StageOrientation.ROTATED_LEFT | A tela é girada para a esquerda. |
StageOrientation.UPSIDE_DOWN | A tela é girada para baixo. |
StageOrientation.UNKNOWN | O aplicativo ainda não determinou a orientação inicial da tela. Você pode adicionar um ouvinte de evento ao evento orientationChange |
Para definir a orientação do palco, use o método setOrientation()
.
Importante: a propriedade orientation é suportada em dispositivos Android do namespace 2.6 adiante.
Implementação
public function get orientation():String
Elementos da API relacionados
quality | propriedade |
quality:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor a partir da classe StageQuality que especifica a qualidade de renderização usada. Os seguintes valores são válidos:
StageQuality.LOW
- baixa qualidade de renderização. Os gráficos não possuem a suavização de borda, e os bitmaps não são suavizados, mas os tempos de execução ainda usam o mapeamento de mip.StageQuality.MEDIUM
- média qualidade de renderização. Os gráficos possuem a suavização de borda utilizando uma grade de pixel de 2 x 2 e a suavidade de bitmaps é dependente da definição deBitmap.smoothing
. Os tempos de execução usam o mapeamento de mip. Esta configuração é adequada para filmes que não contêm texto.StageQuality.HIGH
- alta qualidade de renderização. Os gráficos possuem a suavização de borda utilizando uma grade de pixel de 4 x 4 e a suavidade de bitmaps é dependente da definição deBitmap.smoothing
. Os tempos de execução usam o mapeamento de mip. Essa é a configuração padrão de qualidade de renderização usada pelo Flash Player.StageQuality.BEST
- qualidade de renderização muito alta. Os gráficos possuem a suavização de borda utilizando uma grade de pixel de 4 x 4. SeBitmap.smoothing
fortrue
, o tempo de execução usa um algoritmo alta qualidade reduzível que produz menos artefatos (contudo, usarStageQuality.BEST
comBitmap.smoothing
definido comotrue
reduz a velocidade do desempenho significativamente e não é uma definição recomendada).
Configurações de qualidade superior produzem melhor renderização de bitmaps dimensionados. No entanto, configurações de qualidade superior são mais caras em termos computacionais. Especificamente na renderização de vídeo dimensionado, usar configurações de qualidade superior pode reduzir a taxa de quadros.
O método BitmapData.draw()
usa o valor da propriedade Stage.quality
. Como alternativa, você pode usar o método BitmapData.drawWithQuality()
, que permite que você especifique o parâmetro quality
para o método, ignorando o valor atual de Stage.quality
.
Para conteúdo em execução no Adobe AIR, a qualidade
pode ser definida como StageQuality.BEST
ou StageQuality.HIGH
(e o valor padrão é StageQuality.HIGH
). Tentar defini-la como outro valor não tem efeito (e a propriedade permanece inalterada). No perfil móvel de AIR, as quatro configurações de qualidade estão disponíveis. O valor padrão em dispositivos móveis é StageQuality.MEDIUM
.
Para conteúdo em execução no Adobe AIR, configurar a propriedade quality
de um objeto Stage altera a qualidade de renderização de todos os objetos Stage (usados por objetos NativeWindow diferentes).
quality
.
Implementação
public function get quality():String
public function set quality(value:String):void
Lança
SecurityError — Chamar a propriedade quality de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
Elementos da API relacionados
scaleMode | propriedade |
scaleMode:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor a partir da classe StageScaleMode que especifica o modo de escala a ser usado. Os seguintes valores são válidos:
StageScaleMode.EXACT_FIT
– O aplicativo inteiro está visível na área especificada sem tentar preservar a proporção original. Podem ocorrer distorções e o aplicativo pode parecer ampliado ou compactado.StageScaleMode.SHOW_ALL
– O aplicativo inteiro está visível na área especificada sem distorções, mantendo a proporção original do aplicativo. As bordas podem aparecer nos dois lados do aplicativo.StageScaleMode.NO_BORDER
- O aplicativo inteiro preenche a área especificada, sem distorções, mas possivelmente com um certo nível de corte, mantendo ao mesmo tempo a proporção original do aplicativo.StageScaleMode.NO_SCALE
- O aplicativo inteiro é fixo, permanecendo inalterado mesmo que haja uma alteração no tamanho da janela do player. Poderão ocorrer cortes se a janela do player for menor do que o conteúdo.
Implementação
public function get scaleMode():String
public function set scaleMode(value:String):void
Lança
SecurityError — Chamar a propriedade scaleMode de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
Elementos da API relacionados
showDefaultContextMenu | propriedade |
showDefaultContextMenu:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Especifica se os itens padrão serão mostrados ou ocultados no menu de contexto do tempo de execução do Flash.
Se a propriedade showDefaultContextMenu
estiver definida como true
(o padrão), todos os itens do menu de contexto aparecerão. Se a propriedade showDefaultContextMenu
estiver definida como false
, apenas os itens de menu de Settings and About aparecerão.
Implementação
public function get showDefaultContextMenu():Boolean
public function set showDefaultContextMenu(value:Boolean):void
Lança
SecurityError — Chamar a propriedade showDefaultContextMenu de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
softKeyboardRect | propriedade |
softKeyboardRect:Rectangle
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2.6, Flash Player 10.2 |
Um Retângulo que especifica a área do palco que, no momento, está coberta por um teclado virtual. Os componentes de Rect são (0,0,0,0) quando o teclado virtual não está ativo.
Implementação
public function get softKeyboardRect():Rectangle
Elementos da API relacionados
stage3Ds | propriedade |
stage3Ds:Vector.<Stage3D>
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 11, AIR 3 |
Uma lista de objetos Stage3D disponíveis para exibir o conteúdo tridimensional.
Você pode usar somente um número limitado de objetos Stage3D de cada vez. O número de objetos Stage3D disponível depende da plataforma e do hardware disponível.
Um objeto Stage3D é desenhado em frente a um objeto StageVideo e atrás da lista de exibição do Flash.
Implementação
public function get stage3Ds():Vector.<Stage3D>
Elementos da API relacionados
stageFocusRect | propriedade |
stageFocusRect:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica se os objetos exibem ou não uma borda brilhante quando possuem foco.
Implementação
public function get stageFocusRect():Boolean
public function set stageFocusRect(value:Boolean):void
Lança
SecurityError — Chamar a propriedade stageFocusRect de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
stageHeight | propriedade |
stageHeight:int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A altura atual, em pixels, do Palco.
Se o valor da propriedade Stage.scaleMode
for definido como StageScaleMode.NO_SCALE
quando o usuário redimensiona a janela, o conteúdo Stage mantém seu tamanho definido, ao passo que a propriedade stageHeight
muda para refletir o novo tamanho de largura da área da tela ocupada pelo arquivo SWF.. (Nos outros modos de escala, a propriedade stageHeight
sempre reflete a altura original do arquivo SWF.) Você pode adicionar um ouvinte de evento ao evento resize
e, em seguida, usar a propriedade stageHeight
da classe Stage para determinar a dimensão real de pixel da janela redimensionada do tempo de execução do Flash. O ouvinte de evento permite controlar como o conteúdo da tela se ajusta quando o usuário redimensiona a janela.
Os dispositivos AIR for TV têm um comportamento ligeiramente diferente daquele apresentado pelos dispositivos de área de trabalho quando você define a propriedade stageHeight
. Se a propriedade Stage.scaleMode
estiver definida como StageScaleMode.NO_SCALE
e você definir a propriedade stageHeight
, a altura do palco não será alterada até o próximo quadro do SWF.
Observação: Em uma página HTML que esteja hospedando o arquivo SWF, o objeto
e os atributosincorporados de
alturada guia
devem ser definidos como um percentual (por exemplo: 100%
), não pixels. Se as configurações forem geradas por código JavaScript, o parâmetro height
do método AC_FL_RunContent()
também deverá ser definido como um percentual. Este percentual é aplicado ao valor stageHeight
.
Implementação
public function get stageHeight():int
public function set stageHeight(value:int):void
Lança
SecurityError — Chamar a propriedade stageHeight de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
Elementos da API relacionados
stageVideos | propriedade |
stageVideos:Vector.<StageVideo>
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2.5, Flash Player 10.2 |
Uma lista de objetos StageVideo disponíveis para reprodução de vídeos externos.
Você pode usar somente um número limitado de objetos StageVideo de cada vez. Quando a execução de um SWF tem início, o número de objetos StageVideo disponíveis depende da plataforma e do hardware disponível.
Para usar um objeto StageVideo, atribua um membro do objeto Vector stageVideos
a uma variável StageVideo.
Todos os objetos StageVideo são exibidos no palco, atrás de qualquer objeto de exibição. Os objetos StageVideo são exibidos no palco na ordem em que aparecem no objeto VectorstageVideos
. Por exemplo, se o objeto VectorstageVideos
contiver três entradas:
- O objeto StageVideo no índice 0 do objeto Vector
stageVideos
é exibido atrás de todos os objetos StageVideo. - O objeto StageVideo no índice 1 é exibido na frente do objeto StageVideo no índice 0.
- O objeto StageVideo no índice 2 é exibido na frente do objeto StageVideo no índice 1.
Use a propriedade StageVideo.depth
para alterar essa ordem.
Nota: dispositivos AIR for TV oferecem suporte a somente um objeto StageVideo.
Implementação
public function get stageVideos():Vector.<StageVideo>
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
var stageVideo:StageVideo; if ( stage.stageVideos.length >= 1 ) { stageVideo = stage.stageVideos[0]; }
stageWidth | propriedade |
stageWidth:int
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica a largura atual, em pixels, do Palco.
Se o valor da propriedade Stage.scaleMode
for definido como StageScaleMode.NO_SCALE
quando o usuário redimensiona a janela, o conteúdo Stage mantém seu tamanho definido, ao passo que a propriedade stageWidth
muda para refletir o novo tamanho de largura da área da tela ocupada pelo arquivo SWF. (Nos outros modos de escala, a propriedade stageWidth
sempre reflete a largura original do arquivo SWF.) Você pode adicionar um ouvinte de evento ao evento resize
e, em seguida, usar a propriedade stageWidth
da classe Stage para determinar a dimensão real de pixel da janela redimensionada do tempo de execução do Flash. O ouvinte de evento permite controlar como o conteúdo da tela se ajusta quando o usuário redimensiona a janela.
Os dispositivos AIR for TV têm um comportamento ligeiramente diferente daquele apresentado pelos dispositivos para área de trabalho quando você define a propriedade stageWidth
. Se a propriedade Stage.scaleMode
for definida como StageScaleMode.NO_SCALE
e você definir a propriedade stageWidth
, a largura do palco não será alterada até o próximo quadro do SWF.
Observação: Em uma página HTML que esteja hospedando o arquivo SWF, o objeto
e os atributosincorporados de
largurada guia
devem ser definidos como um percentual (por exemplo: 100%
), não pixels. Se as configurações forem geradas por código JavaScript, o parâmetro width
do método AC_FL_RunContent()
também deverá ser definido como um percentual. Esse percentual é aplicado ao valor stageWidth
.
Implementação
public function get stageWidth():int
public function set stageWidth(value:int):void
Lança
SecurityError — Chamar a propriedade stageWidth de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
Elementos da API relacionados
supportedOrientations | propriedade |
supportedOrientations:Vector.<String>
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2.6 |
As orientações com suporte no dispositivo atual.
Você pode usar as sequências de caracteres de orientação incluídas nesta lista como parâmetros para o método setOrientation ()
. A definição de uma orientação não suportada falha sem erro.
As orientações possíveis incluem:
Constante StageOrientation | Orientação do palco |
---|---|
StageOrientation.DEFAULT | Defina a orientação do palco para a orientação padrão (o lado direito para cima). |
StageOrientation.ROTATED_RIGHT | Define a orientação do palco para ser girada para a direita. |
StageOrientation.ROTATED_LEFT | Define a orientação do palco para ser girada para a esquerda. |
StageOrientation.UPSIDE_DOWN | Define a orientação do palco para ser girada para baixo. |
Implementação
public function get supportedOrientations():Vector.<String>
Elementos da API relacionados
supportsOrientationChange | propriedade |
supportsOrientationChange:Boolean
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2 |
Se o aplicativo suporta mudanças na orientação de tomada (e rotação de dispositivo). Atualmente, esta propriedade só é true
em aplicativos AIR executados em dispositivos móveis.
Implementação
public static function get supportsOrientationChange():Boolean
Elementos da API relacionados
tabChildren | propriedade |
tabChildren:Boolean
[substituir] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Determina se os filhos do objeto estão ativados para tabulação. Ativa ou desativa a tabulação para os filhos do objeto. O padrão é true
.
Nota: não use a propriedade tabChildren
com Flex. Em vez disso, use a propriedade mx.core.UIComponent.hasFocusableChildren
.
Implementação
override public function get tabChildren():Boolean
override public function set tabChildren(value:Boolean):void
Lança
SecurityError — Fazer referência à propriedade tabChildren de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
textSnapshot | propriedade |
textSnapshot:flash.text:TextSnapshot
[somente leitura] [substituir] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Retorna um objeto TextSnapshot para essa ocorrência de DisplayObjectContainer.
Implementação
override public function get textSnapshot():flash.text:TextSnapshot
Lança
IllegalOperationError — Fazer referência à propriedade textSnapshot de um objeto Stage lança uma exceção porque a classe Stage não implementa essa propriedade. Para evitar isso, chame a propriedade textSnapshot de um contêiner de objetos de exibição diferente do objeto Stage.
|
vsyncEnabled | propriedade |
vsyncEnabled:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 29.0 |
Isso representa o estado atual de vsync de uma solução de gráficos subjacente. Podemos habilitar/desabilitar a sincronização, para renderizar imediatamente sem precisar esperar pelo próximo estado VSYNC. Ler a propriedade é válido a qualquer momento. Entretanto, definir a propriedade é válido somente depois que VsyncStateChangeAvailabilityEvent tenha sido disparado.
Implementação
public function get vsyncEnabled():Boolean
public function set vsyncEnabled(value:Boolean):void
width | propriedade |
width:Number
[substituir] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica a largura do objeto de exibição, em pixels. A largura é calculada com base nos limites do conteúdo do objeto de exibição. Quando você define a propriedade width
, a propriedade scaleX
é ajustada de acordo, como mostra o código a seguir:
var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(0, 0, 100, 100); trace(rect.scaleX) // 1; rect.width = 200; trace(rect.scaleX) // 2;
Exceto para objetos TextField e Video, um objeto de exibição sem conteúdo (como uma entidade gráfica vazia) tem uma largura de 0, mesmo que você tente definir width
como um valor diferente.
Implementação
override public function get width():Number
override public function set width(value:Number):void
Lança
SecurityError — Fazer referência à propriedade width de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
| |
IllegalOperationError — É sempre ilegal definir a propriedade width de um objeto Stage, mesmo que você seja o proprietário do Palco.
|
wmodeGPU | propriedade |
wmodeGPU:Boolean
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10.0.32, AIR 1.5.2, Flash Lite 4 |
Indica se a composição de GPU está disponível e em uso. O valor wmodeGPU
é true
apenas quando todas as três condições seguintes existirem:
- A composição do GPU foi solicitada.
- A composição do GPU está disponível.
- A composição do GPU está em uso.
Especificamente, a propriedade wmodeGPU
indica um dos seguintes:
- A composição do GPU não foi solicitada ou está indisponível. Nesse caso, o valor da propriedade
wmodeGPU
éfalse
. - A composição do GPU foi solicitada (se aplicável e disponível), mas o ambiente está operando no "modo de emergência" (não interpretação ótima) devido a limitações do conteúdo. Nesse caso, o valor da propriedade
wmodeGPU
étrue
. - A composição do GPU foi solicitada (se aplicável e disponível) e o ambiente está funcionando no melhor modo. Nesse caso, o valor da propriedade
wmodeGPU
também étrue
.
Em outras palavras, a propriedade wmodeGPU
identifica a capacidade e o estado do ambiente de renderização. Para tempos de execução que não suportam a composição do GPU, como AIR 1.5.2, o valor é sempre false
, porque (como afirmado anteriormente) o valor é true
somente quando a composição do GPU for solicitada, estiver disponível e em uso.
A propriedade wmodeGPU
é útil para determinar, no tempo de execução, se a composição do GPU está em uso. O valor wmodeGPU
indica se o seu conteúdo será dimensionado pelo hardware ou não, para que você possa apresentar gráficos no tamanho correto. Você também pode determinar se você está aplicando o acabamento em um caminho rápido ou não, para que você possa ajustar a complexidade do conteúdo de acordo.
Para Flash Player em um navegador, a composição do GPU pode ser solicitada pelo valor gpu
para o parâmetro de HTML wmode
na página que hospeda o arquivo SWF. Para outras configurações, a composição do GPU pode ser solicitada no cabeçalho de um arquivo SWF (configure usando ferramentas de autoração SWF).
No entanto, a propriedade wmodeGPU
não identifica o desempenho da aplicação de acabamento atual. Mesmo se a composição do GPU estiver "em uso", o processo de aplicação de acabamento pode não estar funcionando no melhor modo. Para ajustar o conteúdo da renderização ótima, use uma versão de depurador de tempo de execução Flash e defina DisplayGPUBlendsetting
no seu arquivo mm.cfg.
Observação: Esta propriedade é sempre false
quando referido pelo ActionScript que é executado antes que o tempo de execução realize o seu primeiro passo de renderização. Por exemplo, se você examina wmodeGPU
de um script no Quadro 1 do Adobe Flash Professional e o seu arquivo SWF for o primeiro arquivo SWF carregado em uma nova instância do tempo de execução, então o valor wmodeGPU
é false
. Para obter um valor exato, espere que pelo menos uma passagem de renderização tenha ocorrido. Se você gravar um ouvinte de evento para o evento exitFrame
de algum DisplayObject
, o valor wmodeGPU
é o valor correto.
Implementação
public function get wmodeGPU():Boolean
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
wmodeGPU
depois que o Sprite for renderizado, para que você possa obter um valor exato.
mySprite.addEventListener(EXIT_FRAME, exithandler): function exithandler(exiteventobject:Event):void { trace(stage.wmodeGPU); }
addChild | () | método |
override public function addChild(child:DisplayObject):DisplayObject
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. O filho é adicionado à frente (acima) de todos os outros filhos nessa ocorrência de DisplayObjectContainer. (Para adicionar um filho em uma posição de índice específica, use o método addChildAt()
.)
Se você adicionar um objeto-filho que já tenha um contêiner de objetos de exibição diferente como pai, o objeto será removido da lista de filhos do outro contêiner de objetos de exibição.
Observação: O comando stage.addChild()
pode causar problemas com um arquivo SWF publicado, inclusive problemas de segurança e conflitos com outros arquivos SWF carregados. Há só um Palco dentro de uma instância de tempo de execução de Flash, não importa quantos arquivos SWF você carrega no tempo de execução. Portanto, geralmente, os objetos não devem ser adicionados ao Palco, diretamente. O único objeto que o Palco deve conter é o objeto-raiz. Crie um DisplayObjectContainer para conter todos os itens na lista de exibição. Então, se necessário, adicione essa instância DisplayObjectContainer ao Palco.
Parâmetros
child:DisplayObject — A ocorrência de DisplayObject a ser adicionada como filho dessa ocorrência de DisplayObjectContainer.
|
DisplayObject — A ocorrência de DisplayObject que você transmite no parâmetro filho .
|
Lança
SecurityError — Chamar o método addChild() de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
addChildAt | () | método |
override public function addChildAt(child:DisplayObject, index:int):DisplayObject
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. O filho é adicionado na posição de índice especificada. Um índice de 0 representa o final (parte inferior) da lista de exibição para esse objeto DisplayObjectContainer.
Por exemplo, o exemplo a seguir mostra três objetos de exibição, com os rótulos a, b e c, nas posições de índice 0, 2 e 1, respectivamente:
Se você adicionar um objeto-filho que já tenha um contêiner de objetos de exibição diferente como pai, o objeto será removido da lista de filhos do outro contêiner de objetos de exibição.
Parâmetros
child:DisplayObject — A ocorrência de DisplayObject a ser adicionada como filho dessa ocorrência de DisplayObjectContainer.
| |
index:int — A posição de índice à qual o filho é adicionado. Se você especificar uma posição de índice atualmente ocupada, o objeto-filho existente nessa posição e em todas as posições mais altas será movido uma posição para cima na lista de filhos.
|
DisplayObject — A ocorrência de DisplayObject que você transmite no parâmetro filho .
|
Lança
SecurityError — Chamar o método addChildAt() de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
addEventListener | () | método |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. Você pode registrar ouvintes de eventos em todos os nós da lista de exibição de um tipo específico de evento, fase e prioridade.
Depois de registrar um ouvinte de evento com êxito, não será possível alterar a respectiva prioridade por meio de chamadas adicionais para o addEventListener()
. Para alterar a prioridade de um ouvinte, chame primeiramente o removeListener()
. Em seguida, você poderá registrar o ouvinte novamente com o novo nível de prioridade.
Tenha em mente que, após o ouvinte ser registrado, chamadas subsequentes para o addEventListener()
com um valor type
ou useCapture
diferente resultarão na criação de um registro de ouvinte separado. Por exemplo, se você primeiro registrar um ouvinte com o useCapture
definido como true
, ele escutará apenas durante a fase de captura. Se você chamar o addEventListener()
novamente, usando o mesmo objeto de ouvinte, mas com o useCapture
definido como false
, você terá dois ouvintes distintos: um que escuta durante a fase de captura e outro que escuta durante as fases de destino e de bubbling.
Você não pode registrar um ouvinte de evento apenas para a fase de destino ou a fase de bubbling. Essas fases são emparelhadas durante o registro porque o bubbling se aplica apenas aos ancestral do nó-alvo.
Se você não precisar mais de um ouvinte de evento, remova-o, chamando o removeEventListener()
; do contrário, poderão ocorrer problemas de memória. Os ouvintes de evento não são retirados automaticamente da memória porque o coletor de lixo não remove o ouvinte enquanto o objeto de despacho existe (a menos que o parâmetro useWeakReference
seja definido para true
).
Copiar uma ocorrência do EventDispatcher não copia os ouvintes de eventos a ele anexados. (Se o seu recém-criado nó precisar de um ouvinte de evento, anexe o ouvinte após criar o nó). Entretanto, se você mover uma ocorrência do EventDispatcher, os ouvintes de evento anexados se movimentarão com ele.
Se o ouvinte de evento estiver sendo registrado em um nó enquanto um evento estiver sendo processado nesse nó, o ouvinte de evento não será disparado durante a fase atual, mas poderá ser disparado durante uma fase posterior no fluxo de eventos, como a fase de bubbling.
Se um ouvinte de evento for removido de um nó enquanto um evento estiver sendo processado no nó, ele ainda será disparado pelas ações atuais. Depois de removido, o ouvinte de evento nunca mais é chamado novamente (a menos que registrado mais uma vez para processamento futuro).
Parâmetros
type:String — O tipo de evento.
| |
listener:Function — A função de ouvinte que processa o evento. Esta função deve aceitar um objeto Event como seu único parâmetro e não deve retornar nada, como mostra este exemplo:
function(evt:Event):void A função pode ter qualquer nome. | |
useCapture:Boolean (default = false ) —
Determina se o ouvinte trabalha na fase de captura ou nas fases de destino e bubbling. Se useCapture for definido como true , o ouvinte processará o evento apenas durante a fase de captura e não na fase de destino nem de bubbling. Se useCapture for false , o ouvinte processará o evento apenas durante a fase de destino ou de bubbling. Para ouvir o evento em todas as três fases, chame o addEventListener duas vezes, uma vez com o useCapture definido como true , e novamente, com o useCapture definido como false .
| |
priority:int (default = 0 ) — O nível de prioridade do ouvinte de evento. A prioridade é designada por um número inteiro de 32 bits sem sinal. Quanto mais alto o número, maior a prioridade. Todos os ouvintes com prioridade n são processados antes dos ouvintes com prioridade n-1. Se dois ou mais ouvintes compartilham a mesma prioridade, eles são processados pela ordem segundo a qual foram adicionados. A prioridade padrão é 0.
| |
useWeakReference:Boolean (default = false ) — Determina se a referência ao ouvinte é forte ou fraca. Uma referência forte (a padrão) impede que o ouvinte seja coletado como lixo. Uma referência fraca não impede. Funções de membro de nível de classe não estão sujeitas à coleta de lixo, portanto, você pode definir |
Lança
SecurityError — Chamar o método addEventListener de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar essa situação, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
assignFocus | () | método |
public function assignFocus(objectToFocus:InteractiveObject, direction:String):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0 |
Define o foco do teclado como o objeto interativo especificado pelo objectToFocus
, com a direção do foco especificada pelo parâmetro direction
.
O conceito de direção do foco deve ser definido pelo aplicativo (ou estrutura do aplicativo). Não existe nenhuma classificação de foco intrínseca de objetivos interativos, embora você possa usar outras propriedades disponíveis para estabelecer um princípio de ordenação. Por exemplo, você pode classificar objetos interativos de acordo com suas posições em Stage ou na lista de exibição. Chamar o assignFocus()
equivale a configurar a propriedade Stage.focus
, com a capacidade adicional de indicar a direção da qual o foco está sendo definido.
O objectToFocus
despachará um evento focusIn
ao receber o foco. A propriedade direcionar
do objeto FocusEvent relata a configuração do parâmetro direction
.
Caso você atribua um objeto HTMLLoader ao parâmetro objectToFocus
, o objeto HTMLLoader seleciona o objeto focalizável apropriado no HTML DOM com base no valor do parâmetro direction
. Caso ele seja FocusDirection.BOTTOM
, o objeto focalizável no HTML DOM no fim da ordem de leitura recebe o foco. Caso ele seja FocusDirection.TOP
, o objeto focalizável no HTML DOM no início da ordem de leitura recebe o foco. Caso ele seja NONE
, o objeto HTMLLoader recebe o foco sem alterar o elemento focado no momento.
Parâmetros
objectToFocus:InteractiveObject — O objeto a ser focado, ou null , para limpar o foco de qualquer elemento em Stage.
| |
direction:String — A direção a partir da qual o objectToFocus está sendo focado. Valores válidos são enumerados como constantes na classe FocusDirection.
|
Lança
Error — Se o foco não puder ser definido como o destino ou a direção, não é um tipo válido.
|
Elementos da API relacionados
dispatchEvent | () | método |
override public function dispatchEvent(event:Event):Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Envia um evento para o fluxo de eventos. O destino de evento é o objeto EventDispatcher no qual o método dispatchEvent()
é chamado.
Parâmetros
event:Event — O objeto Event que é despachado para o fluxo de eventos. Se o evento estiver sendo redespachado, um clone desse evento será criado automaticamente. Depois que um evento é despachado, sua propriedade target não pode ser alterada, portanto, você pode criar uma nova cópia do evento para reenviar para trabalho.
|
Boolean — Um valor true se o evento foi despachado com sucesso. Um valor false indica falha ou que o preventDefault() foi chamado no evento.
|
Lança
SecurityError — Chamar o método dispatchEvent() de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
hasEventListener | () | método |
override public function hasEventListener(type:String):Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. Isto permite determinar quando um objeto EventDispatcher alterou o tratamento de um tipo de evento na hierarquia de fluxo de eventos. Para determinar se um tipo de evento específico efetivamente dispara um ouvinte de evento, utilize o willTrigger()
.
A diferença entre o hasEventListener()
e o willTrigger()
é que o hasEventListener()
examina só o objeto a que ele pertence, ao passo que o willTrigger()
examina o fluxo de eventos inteiro para o evento especificado pelo parâmetro type
.
Quando o hasEventListener()
é chamado de um objeto LoaderInfo, apenas os ouvintes que o chamador pode acessar são considerados.
Parâmetros
type:String — O tipo de evento.
|
Boolean — Um valor true se um ouvinte do tipo especificado for registrado; do contrário, será false .
|
Lança
SecurityError — Chamar o método hasEventListener() de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
invalidate | () | método |
public function invalidate():void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Chamar o método invalidate()
dá um sinal para que o tempo de execução do Flash alerte os objetos de exibição na próxima oportunidade que tiver de renderizar a lista de exibição (por exemplo, quando o indicador de reprodução avança para um novo quadro). Após a chamada do método invalidate()
, da próxima vez que a lisa de exibição for renderizada, o tempo de execução do Flash enviará um evento render
a cada objeto de exibição que estiver registrado para ouvir esse evento render
. É necessário chamar o método invalidate()
sempre que você quiser que o tempo de execução do Flash envie eventos render
.
O evento render
dá uma oportunidade de fazer alterações na lista de exibição imediatamente antes de ela ser realmente renderizada. Isso permite adiar atualizações na lista de exibição até a última oportunidade. Isso pode aumentar o desempenho ao eliminar atualizações de tela desnecessárias.
O evento render
apenas é despachado para objetos de exibição que estão no mesmo domínio de segurança que o código que chama o método stage.invalidate()
ou para objetos de exibição de um domínio de segurança que recebeu permissão via o método Security.allowDomain()
.
Elementos da API relacionados
isFocusInaccessible | () | método |
public function isFocusInaccessible():Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina se a propriedade Stage.focus
retornará null
por motivos de segurança. Em outras palavras, isFocusInaccessible
retornará true
se o objeto que tiver foco pertencer a uma área de segurança à qual o arquivo SWF não tem acesso.
Boolean — true se o objeto que tiver foco pertencer a uma área de segurança à qual o arquivo SWF não tem acesso.
|
removeChildAt | () | método |
override public function removeChildAt(index:int):DisplayObject
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Remove um DisplayObject filho da posição de index
especificada na lista de filhos de DisplayObjectContainer. A propriedade parent
do filho removido é definida como null
e o objeto será coletado como lixo se não houver outras referências ao filho. As posições de índice de qualquer objeto de exibição acima do filho em DisplayObjectContainer são diminuídas em 1.
O coletor de lixo realoca o espaço de memória não utilizado. Quando uma variável ou objeto deixa de ser ativamente referenciado ou é armazenado em outro local, o coletor de lixo faz uma varredura e limpa o espaço de memória que essa variável ou objeto costumava ocupar, se nenhuma outra referência existir.
Parâmetros
index:int — O índice de filho de DisplayObject a ser removido.
|
DisplayObject — A ocorrência de DisplayObject que foi removida.
|
Lança
SecurityError — Chamar o método removeChildAt() de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o objeto a ser removido. Para evitar isso, o proprietário desse objeto pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
setAspectRatio | () | método |
public function setAspectRatio(newAspectRatio:String):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2 |
Define o palco com uma orientação com a proporção especificada.
Se a orientação do palco for alterada em consequência de uma chamada de método, o objeto Stage emite um evento orientationChange.
Para verificar se a orientação de dispositivo é suportada, verifique o valor da propriedade Stage.supportsOrientantionChange
.
Suporte a perfil do AIR: este recurso conta com suporte em dispositivos móveis, mas não é compatível com sistemas operacionais para desktop nem com dispositivos AIR for TV. Você pode testar o suporte para tempo de execução utilizando a propriedadeStage.supportsOrientantionChange
. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Parâmetros
newAspectRatio:String — O código de tipo da proporção desejada (StageAspectRatio.PORTRAIT , StageAspectRatio.LANDSCAPE ou StageAspectRatio.ANY ).
|
Lança
ArgumentError — O valor passado como o parâmetro newAspectRatio não é válido. O valor deve ser uma das constantes definidas na classe StageAspectRatio.
|
Elementos da API relacionados
setChildIndex | () | método |
override public function setChildIndex(child:DisplayObject, index:int):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Altera a posição de um filho existente no contêiner de objetos de exibição. Isso afeta a disposição de objetos-filho em camadas. Por exemplo, o exemplo a seguir mostra três objetos de exibição, com os rótulos a, b e c, nas posições de índice 0, 1 e 2, respectivamente:
Quando você usa o método setChildIndex()
e especifica uma posição de índice que já está ocupada, as únicas posições alteradas são aquelas entre a posição nova e a anterior do objeto de exibição. Todos as demais permanecem da mesma maneira. Se um filho for movido para um índice INFERIOR ao índice atual respectivo, todos os filhos entre eles AUMENTARÃO em 1 na respectiva referência de índice. Se um filho for movido para um índice SUPERIOR ao índice atual respectivo, todos os filhos entre eles DIMINUIRÃO em 1 na respectiva referência de índice. Por exemplo, se o contêiner de objetos de exibição no exemplo anterior se chamar container
, você poderá alternar a posição dos objetos de exibição com os rótulos a e b, chamando o seguinte código:
container.setChildIndex(container.getChildAt(1), 0);
Esse código resulta na seguinte disposição de objetos:
Parâmetros
child:DisplayObject — A ocorrência-filho de DisplayObject para a qual você deseja alterar o número do índice.
| |
index:int — O número de índice resultante para o objeto de exibição-filho .
|
Lança
SecurityError — Chamar o método setChildIndex() de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
setOrientation | () | método |
public function setOrientation(newOrientation:String):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2 |
Define o palco com a orientação especificada.
Defina o parâmetro newOrientation
para um dos quatro seguintes valores definidos como constantes na classe StageOrientation:
Constante StageOrientation | Orientação do palco |
---|---|
StageOrientation.DEFAULT | Defina a orientação do palco para a orientação padrão (o lado direito para cima). |
StageOrientation.ROTATED_RIGHT | Define a orientação do palco para ser girada para a direita. |
StageOrientation.ROTATED_LEFT | Define a orientação do palco para ser girada para a esquerda. |
StageOrientation.UPSIDE_DOWN | Define a orientação do palco para ser girada para baixo. |
Não defina o parâmetro como StageOrientation.DESCONHECIDO
ou qualquer valor de string diferente dos enumerados na tabela.
Para verificar se a orientação de dispositivo é suportada, verifique o valor da propriedade Stage.supportsOrientantionChange.
Verifique a lista fornecida pela propriedade supportedOrientations
para determinar quais orientações são suportadas pelo dispositivo atual.
A configuração da orientação é uma operação assíncrona. Não há garantia de que seja concluída imediatamente depois de você chamar o método setOrientation()
. Adicione uma escuta de eventos ao evento orientationChange
para determinar quando a orientação é alterada por completo.
Importante:o método setOrientation ()
não era suportado nos dispositivos Android anteriores ao AIR 2.6.
setOrientation()
não faz com que um evento orientationChanging
seja despachado.
Parâmetros
newOrientation:String — A nova orientação do palco.
|
Eventos
orientationChange: — O palco foi redimensionado como resultado da chamada do método setOrientation() .
|
Lança
ArgumentError — O valor passado como o parâmetro newOrientation não é válido. O valor deve corresponder a uma das constantes definidas na classe StageOriention, exceto a constante StageOrientation.UNKNOWN .
|
Elementos da API relacionados
swapChildrenAt | () | método |
override public function swapChildrenAt(index1:int, index2:int):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Alterna a ordem z (ordem da frente para trás) dos objetos-filho nas duas posições de índice especificadas na lista de filhos. Todos os outros objetos-filho no contêiner de objetos de exibição permanecem nas mesmas posições de índice.
Parâmetros
index1:int — A posição de índice do primeiro objeto-filho.
| |
index2:int — A posição de índice do segundo objeto-filho.
|
Lança
SecurityError — Chamar o método swapChildrenAt() de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário de um dos objetos a serem alterados. Para evitar isso, o proprietário do objeto pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
willTrigger | () | método |
override public function willTrigger(type:String):Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. Este método retorna true
se um ouvinte de evento for disparado durante qualquer fase do fluxo de eventos quando um evento do tipo especificado for despachado para esse objeto EventDispatcher ou para algum de seus descendentes.
A diferença entre o método hasEventListener()
e o willTrigger()
é que o hasEventListener()
examina só o objeto a que pertence, ao passo que o método willTrigger()
examina o fluxo de eventos inteiro para o evento especificado pelo parâmetro type.
Quando o willTrigger()
é chamado de um objeto LoaderInfo, apenas os ouvintes que o chamador pode acessar são considerados.
Parâmetros
type:String — O tipo de evento.
|
Boolean — Um valor true se um ouvinte do tipo especificado será disparado; do contrário, será false .
|
Lança
SecurityError — Chamar o método willTrigger() de um objeto Stage lança uma exceção para qualquer chamador que não esteja na mesma área de segurança que o proprietário do Palco (o arquivo SWF principal). Para evitar isso, o proprietário do Palco pode conceder permissão ao domínio do chamador, chamando o método Security.allowDomain() ou Security.allowInsecureDomain() . Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.
|
browserZoomChange | Evento |
flash.events.Event
propriedade Event.type =
flash.events.Event.BROWSER_ZOOM_CHANGE
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 15 |
Despachado quando a propriedade browserZoomFactor
do objeto Stage é alterada
Event.BROWSER_ZOOM_CHANGE
define o valor do tipo
de propriedade de um objeto de evento browserZoomChange
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | A instância do palco. |
fullScreen | Evento |
flash.events.FullScreenEvent
propriedade FullScreenEvent.type =
flash.events.FullScreenEvent.FULL_SCREEN
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Despachado quando o objeto Stage entra no modo de tela cheia ou sai desse modo. Uma alteração no modo em tela cheia pode ser iniciada por meio do ActionScript, ou pelo usuário que esteja invocando um atalho de teclado, ou se o foco atual sair da janela em tela cheia.
A constanteFullScreenEvent.FULL_SCREEN
define o valor da propriedade type
de um objeto de evento fullScreen
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
fullScreen | true se o estado de exibição for tela cheia, ou false se for normal. |
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto Palco. |
mouseLeave | Evento |
flash.events.Event
propriedade Event.type =
flash.events.Event.MOUSE_LEAVE
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado pelo objeto Stage quando o ponteiro do se move para fora da área do palco. Se o botão do mouse for pressionado, o evento não é despachado.
A constanteEvent.MOUSE_LEAVE
define o valor da propriedade type
de um objeto de evento mouseLeave
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto Palco. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
orientationChange | Evento |
flash.events.StageOrientationEvent
propriedade StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGE
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2.0 |
Despachado pelo objeto Stage quando a orientação do palco é alterada.
As alterações de orientação podem ocorrer quando o usuário gira o dispositivo, abre um teclado deslizante, ou quando setAspectRatio()
é chamado.
Observação: Sea propriedade autoOrients
for false
, então a orientação do palco não será alterada quando um dispositivo for girado. Desse modo, os eventos StageOrientationEvents serão despachados somente para a rotação do dispositivo quando autoOrients
for true
.
ORIENTATION_CHANGE
define o valor da propriedade type
de um objeto de evento orientationChange
. Esse evento tem as seguintes propriedades:
Propriedades | Valores |
---|---|
afterOrientation | A nova orientação do palco. |
beforeOrientation | A orientação antiga do palco. |
target | O objeto Stage que emitiu a alteração de orientação. |
bubbles | true |
currentTarget | Indica O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
cancelable | false ; é tarde demais para cancelar a alteração. |
orientationChanging | Evento |
flash.events.StageOrientationEvent
propriedade StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGING
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2.0 |
Despachado pelo objeto Stage quando a orientação do palco começa a ser alterada.
Importante: os eventos orientationChanging não são despachados em dispositivos com o Android.
Observações:
-
Se a propriedade
autoOrients
forfalse
, a orientação do palco não será alterada quando um dispositivo for girado. Desse modo, os eventos StageOrientationEvents serão despachados somente para a rotação do dispositivo quandoautoOrients
fortrue
. -
Quando estabelece a orientação programaticamente com o método
setOrientation ()
, o eventoorientationChanging
não é despachado.
ORIENTATION_CHANGING
define o valor da propriedade type
de um objeto de evento orientationChanging.
Esse evento tem as seguintes propriedades:
Propriedades | Valores |
---|---|
afterOrientation | A nova orientação do palco. |
beforeOrientation | A orientação antiga do palco. |
target | O objeto Stage que emitiu a alteração de orientação. |
bubbles | true |
currentTarget | Indica O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
cancelable | true . |
resize | Evento |
flash.events.Event
propriedade Event.type =
flash.events.Event.RESIZE
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando a propriedade scaleMode
do objeto Stage é definida como StageScaleMode.NO_SCALE
e o arquivo SWF é redimensionado. Despachado também quando a orientação da tela muda no modo de tela cheia no Flash Player 15 e versões posteriores.
Event.RESIZE
define o valor da propriedade type
de um objeto de evento resize
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto Palco. |
stageVideoAvailability | Evento |
flash.events.StageVideoAvailabilityEvent
propriedade StageVideoAvailabilityEvent.type =
flash.events.StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 10.2 |
Despachado pelo objeto Stage quando o estado da propriedade stageVideos é alterado.
Define o valor da propriedadetype
de um objeto de evento stageVideoAvailability
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
disponibilidade | O status informado pelo evento. |
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando o evento ativamente. |
target | O objeto Stage que informa a disponibilidade do vídeo de palco. |
Exemplo ( Como usar este exemplo )
StageExample
para despachar eventos sempre que o palco é ativado ou redimensionado. Essa tarefa é concluída com as seguintes etapas:
- O construtor da classe define primeiro o aplicativo Flash para ser fixo, independentemente do tamanho da janela do Flash Player, e então adiciona dois ouvintes de evento com os métodos
activateHandler()
eresizeHandler()
. - O método
activateHandler()
é executado quando o botão esquerdo do mouse é clicado. - O método
resizeHandler()
é executado quando o palco é redimensionado.
package { import flash.display.Sprite; import flash.display.StageAlign; import flash.display.StageScaleMode; import flash.events.Event; public class StageExample extends Sprite { public function StageExample() { stage.scaleMode = StageScaleMode.NO_SCALE; stage.align = StageAlign.TOP_LEFT; stage.addEventListener(Event.ACTIVATE, activateHandler); stage.addEventListener(Event.RESIZE, resizeHandler); } private function activateHandler(event:Event):void { trace("activateHandler: " + event); } private function resizeHandler(event:Event):void { trace("resizeHandler: " + event); trace("stageWidth: " + stage.stageWidth + " stageHeight: " + stage.stageHeight); } } }
VsyncStateChangeAvailability | Evento |
flash.events.VsyncStateChangeAvailabilityEvent
propriedade VsyncStateChangeAvailabilityEvent.type =
flash.events.VsyncStateChangeAvailabilityEvent
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 29.0 |
Enviado pelo objeto Stage quando o estado da propriedade vsync é alterado.
Define o valor da propriedade de tipo de um objeto de evento VsyncStateChangeAvailabilityEvent
.
Exemplo ( Como usar este exemplo )
VsyncExample
para despachar eventos quando o vsync state do palco puder ser habilitado ou desabilitado. Essa tarefa é concluída com as seguintes etapas:
- O construtor aciona o evento de palco
VsyncStateChangeAvailabilityEvent
- Em seguida, o método
onVsyncStateChangeAvailability
é chamado, e a disponibilidade deVsyncStateChangeAvailabilityEvent
é verificada. - Se estiver disponível, é possível alternar o estado vsync do palco, caso contrário, o valor da propriedade
vsyncEnable
permanece somente leitura. - O valor de vsync enable pode ser acionado somente se o evento for disparado.
package { import flash.display.Sprite; import flash.events.VsyncStateChangeAvailabilityEvent public class VsyncExample extends Sprite { public function VsyncExample() { stage.addEventListener(VsyncStateChangeAvailabilityEvent.VSYNC_STATE_CHANGE_AVAILABILITY, onVsyncStateChangeAvailability); } public function onVsyncStateChangeAvailability(event:VsyncStateChangeAvailabilityEvent):void { if (event.available) { // vsyncEnabled is now changeable and can be turned off. stage.vsyncEnabled = false; // Now, AS can change VSYNC state because event.available is true trace("vsyncEnabled of Stage object is changeable"); } else { // vsyncEnabled is not changeable now. This could be due to fallback to software rendering, for example. stage.vsyncEnabled = false; // This will be ignored because event.available is now false trace("vsyncEnabled of Stage object is read-only"); trace("Current value of vsyncEnabled of Stage object is "+ stage.vsyncEnabled); } } } }
Wed Jun 13 2018, 11:10 AM Z