| Pacote | flash.html |
| Classe | public class HTMLLoader |
| Herança | HTMLLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Subclasses | FlexHTMLLoader |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Suporte a perfil do AIR: este recurso conta com suporte em todos os sistemas operacionais para desktop, mas não é compatível com dispositivos móveis nem com dispositivos AIR for TV. Você pode testar o suporte para tempo de execução utilizando a propriedadeHTMLLoader.isSupported. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Em computadores desktop (nos perfis de desktop e desktops estendidos), a classe HTMLLoader usa o mecanismo interno WebKit do AIR. Os recursos disponíveis e a aparência de renderização são iguais às da classe StageWebView, além de integração próxima e do script que fecham entre o ActionScript e o JavaScript. Como a classe StageWebView usa o controle da Web do sistema fornecido pelo plug-in Flash Player, não encorajamos o uso simultâneo de instâncias StageWebView e HTMLLoader já que têm comportamento indefinido e possivelmente podem encerrar o aplicativo.
As dimensões padrão de um HTMLLoader são 0 x 0 pixels. Defina as propriedades largura e altura para tornar visível o objeto HTMLLoader.
O tamanho máximo de um objeto HTMLLoader é de 4,096 pixels de altura e 4,096 pixels de largura. Definir width ou height de um objeto HTMLLoader como um número maior que 4,095 faz com que o objeto HTMLLoader lance uma exceção ArgumentError. (Observe que, antes do AIR 2, o tamanho máximo do objeto HTMLLoader era 2.880 pixels.)
Observação: Quando exibido em uma janela transparente, o conteúdo de SWF incorporado em uma página de HTML deve ser incorporado usando qualquer wmode transparent ou opaque. O valor padrão de wmode é window; assim, se você não especificar um valor, o conteúdo de SWF poderá não ser exibido. No Windows e no Linux, o conteúdo de SWF sempre é exibido sobre outro conteúdo quando wmode é definido como window ou opaque. O conteúdo de PDF não pode ser exibido em uma janela transparente, independentemente da configuração de wmode usada.
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
A implementação de acessibilidade atual (AccessibilityImplementation) para esta instância do InteractiveObject. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
As opções de acessibilidade atuais para este objeto de exibição. | DisplayObject | |
| alpha : Number
Indica o valor de transparência alfa do objeto especificado. | DisplayObject | |
| authenticate : Boolean
Especifica se as solicitações de autenticação devem ser manipuladas (true) ou não (false) para solicitações HTTP emitidas por este objeto. | HTMLLoader | ||
| blendMode : String
Um valor a partir da classe BlendMode que especifica o modo de mesclagem a ser usado. | DisplayObject | |
| blendShader : Shader [somente gravação]
Define um shader usado para mesclar o primeiro plano e o segundo plano. | DisplayObject | |
| buttonMode : Boolean
Especifica o modo de botão desta entidade gráfica. | Sprite | |
| cacheAsBitmap : Boolean
Se definido como true, tempo de execução do Flash armazenará em cachê uma representação interna em bitmap do objeto de exibição. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Se não nulo, este objeto Matrix definirá como um objeto exibição será renderizado quando cacheAsBitmap for definido como verdadeiro. | DisplayObject | |
| cacheResponse : Boolean
Especifica se os dados de resposta bem-sucedidos devem ser armazenados em cache para as solicitações HTTP enviadas por este objeto. | HTMLLoader | ||
| constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| contentHeight : Number [somente leitura]
A altura, em pixels, do conteúdo HTML. | HTMLLoader | ||
| contentWidth : Number [somente leitura]
A largura, em pixels, do conteúdo HTML. | HTMLLoader | ||
| contextMenu : NativeMenu
Especifica o menu de contexto associado a este objeto. | InteractiveObject | |
| doubleClickEnabled : Boolean
Especifica se o objeto recebe eventos doubleClick. | InteractiveObject | |
| dropTarget : DisplayObject [somente leitura]
Especifica o objeto de exibição sobre o qual a entidade gráfica está sendo arrastada ou no qual a entidade gráfica foi solta. | Sprite | |
| filters : Array
Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição. | DisplayObject | |
| focusRect : Object
Especifica se este objeto exibe um retângulo de foco. | InteractiveObject | |
| graphics : Graphics [somente leitura]
Especifica o objeto Graphics pertencente a esta entidade gráfica em que comandos de desenho de vetor podem ocorrer. | Sprite | |
| hasFocusableContent : Boolean [somente leitura]
Indica se algum conteúdo do objeto HTMLLoader é focalizável. | HTMLLoader | ||
| height : Number [substituir]
Especifica a altura do retângulo da tela HTML em renderização. | HTMLLoader | ||
| historyLength : uint [somente leitura]
O comprimento geral da lista do histórico, incluindo entradas dianteiras e traseiras. | HTMLLoader | ||
| historyPosition : uint
A posição atual na lista do histórico. | HTMLLoader | ||
| hitArea : Sprite
Designa outra entidade gráfica para atuar como área de ocorrência para uma entidade gráfica. | Sprite | |
| htmlHost : flash.html:HTMLHost
O objeto HTMLHost usado para lidar com as alterações em certos elementos da interface do usuário, tais como a propriedade window.document.title do objeto HTMLLoader. | HTMLLoader | ||
| idleTimeout : Number
Especifica o valor de tempo limite ocioso (em milissegundos) para pedidos de HTTP emitidos por este objeto. | HTMLLoader | ||
| isSupported : Boolean [estático] [somente leitura]
Indica se a classe HTMLLoader é suportada no sistema do cliente. | HTMLLoader | ||
| loaded : Boolean [somente leitura]
Indica se o evento load do JavaScript correspondente à chamada anterior para o método load() ou loadString() foi entregue ao HTML DOM no objeto HTMLLoader. | HTMLLoader | ||
| 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 | |
| location : String [somente leitura]
O URL para o conteúdo carregado no objeto HTMLLoader. | HTMLLoader | ||
| manageCookies : Boolean
Especifica se a pilha de protocolo HTTP deve gerenciar cookies para este objeto. | HTMLLoader | ||
| mask : DisplayObject
O objeto de exibição de chamada é mascarado pelo objeto "mask" especificado. | DisplayObject | |
| metaData : Object
Obtém o objeto de metadados da instância DisplayObject se os metadados forem armazenados juntamente com a instância desse DisplayObject no arquivo SWF por uma marca PlaceObject4. | DisplayObject | |
| mouseChildren : Boolean
Determina se os filhos do objeto são ou não ativados pelo mouse, ou dispositivo de entrada do usuário. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários. | InteractiveObject | |
| mouseX : Number [somente leitura]
Indica a coordenada x da posição do dispositivo do mouse ou de entrada do usuário, em pixels. | DisplayObject | |
| mouseY : Number [somente leitura]
Indica a coordenada y da posição do dispositivo do mouse ou de entrada do usuário, em pixels. | DisplayObject | |
| name : String
Indica o nome da ocorrência de DisplayObject. | DisplayObject | |
| navigateInSystemBrowser : Boolean
Especifica se a navegação do quadro-raiz do conteúdo HTML (por exemplo, quando o usuário clica em um link, quando a propriedade window.location é definida ou ao chamar window.open()) resulta em navegação no objeto HTMLLoader (false) ou no navegador da web padrão do sistema (true). | HTMLLoader | ||
| needsSoftKeyboard : Boolean
Especifica se um teclado virtual (teclado de software, na tela) deve ser exibido quando esta instância InteractiveObject recebe foco. | InteractiveObject | |
| numChildren : int [somente leitura]
Retorna o número de filhos deste objeto. | DisplayObjectContainer | |
| opaqueBackground : Object
Especifica se o objeto de exibição é opaco com uma certa cor de plano de fundo. | DisplayObject | |
| paintsDefaultBackground : Boolean
Especifica se o segundo plano do documento HTMLLoader é branco opaco (true) ou não (false). | HTMLLoader | ||
| parent : DisplayObjectContainer [somente leitura]
Indica o objeto DisplayObjectContainer que contém esse objeto de exibição. | DisplayObject | |
| pdfCapability : int [estático] [somente leitura]
O tipo de suporte a PDF no sistema do usuário, definido como um valor de código integral. | HTMLLoader | ||
| placeLoadStringContentInApplicationSandbox : Boolean
Especifica se o conteúdo carregado através do método loadString() é colocado na área de segurança do aplicativo (verdadeiro) ou em uma área de segurança não aplicativo (falso). | HTMLLoader | ||
| 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 | |
| runtimeApplicationDomain : ApplicationDomain
O domínio do aplicativo a ser usado no objeto window.runtime no JavaScript na página HTML. | HTMLLoader | ||
| scale9Grid : Rectangle
A grade de dimensionamento atual que está em vigor. | DisplayObject | |
| scaleX : Number
Indica a escala horizontal (porcentagem) do objeto aplicada a partir do ponto de registro. | DisplayObject | |
| scaleY : Number
Indica a escala vertical (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. | DisplayObject | |
| scaleZ : Number
Indica a escala de profundidade (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. | DisplayObject | |
| scrollH : Number
A posição da barra de rolagem horizontal do conteúdo HTML no objeto HTMLLoader. | HTMLLoader | ||
| scrollRect : Rectangle
Os limites do retângulo de rolagem do objeto de exibição. | DisplayObject | |
| scrollV : Number
A posição da barra de rolagem vertical do conteúdo HTML no objeto HTMLLoader. | HTMLLoader | ||
| softKeyboard : String
Controla a aparência do teclado suave. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Define a área que deve permanecer na tela quando um teclado virtual for exibido (não disponível no iOS) | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Controla o som nesta entidade gráfica. | Sprite | |
| stage : Stage [somente leitura]
O Palco do objeto de exibição. | DisplayObject | |
| swfCapability : int [estático] [somente leitura]
O tipo de suporte a SWF no sistema do usuário, definido como um valor de código integral. | HTMLLoader | ||
| tabChildren : Boolean
Determina se os filhos do objeto estão ativados para tabulação. | DisplayObjectContainer | |
| tabEnabled : Boolean
Especifica se este objeto está na ordem de tabulação. | InteractiveObject | |
| tabIndex : int
Especifica a ordem de tabulação de objetos em um arquivo SWF. | InteractiveObject | |
| textEncodingFallback : String
A codificação de caractere usado pelo conteúdo HTMLLoader se uma página HTML não especificar uma codificação de caracteres. | HTMLLoader | ||
| textEncodingOverride : String
O caractere codificado usado pelo conteúdo HTMLLoader, substituindo qualquer configuração na página HTML. | HTMLLoader | ||
| textSnapshot : flash.text:TextSnapshot [somente leitura]
Retorna um objeto TextSnapshot para essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | |
| 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 | |
| useCache : Boolean
Especifica se o cache local deve ser consultado antes que as solicitações HTTP emitidas por este objeto realizem a busca dos dados. | HTMLLoader | ||
| useHandCursor : Boolean
Um valor booliano que indica se a mão que aponta (cursor de mão) aparece quando o ponteiro passa sobre uma entidade gráfica em que a propriedade buttonMode esteja definida como "true". | Sprite | |
| userAgent : String
A string user agent a ser usada em qualquer solicitação de conteúdo a ser apresentado a partir deste objeto HTMLLoader. | HTMLLoader | ||
| visible : Boolean
Se o objeto de exibição está ou não visível. | DisplayObject | |
| width : Number [substituir]
Especifica a largura do retângulo da tela HTML em renderização. | HTMLLoader | ||
| window : Object [somente leitura]
O objeto global JavaScript para o conteúdo carregado no controle HTML. | HTMLLoader | ||
| x : Number
Indica a coordenada x da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. | DisplayObject | |
| y : Number
Indica a coordenada y da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. | DisplayObject | |
| z : Number
Indica a posição da coordenada z ao longo do eixo z da ocorrência DisplayObject em relação ao contêiner 3D pai. | DisplayObject | |
| Método | Definido por | ||
|---|---|---|---|
Cria um objeto HTMLLoader. | HTMLLoader | ||
|
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | |
|
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | |
|
Indica se restrições de segurança fariam com que qualquer objeto de exibição fosse omitido da lista retornada com a chamada do método DisplayObjectContainer.getObjectsUnderPoint() junto com o ponto especificado. | DisplayObjectContainer | |
Cancela qualquer operação de carga em andamento. | HTMLLoader | ||
|
Determina se o objeto de exibição especificado é um filho da ocorrência de DisplayObjectContainer ou se é a própria ocorrência. | DisplayObjectContainer | |
createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader [estático]
Cria um novo objeto NativeWindow que contém um objeto HTMLLoader. | HTMLLoader | ||
|
Envia um evento para o fluxo de eventos. | EventDispatcher | |
|
Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace. | DisplayObject | |
|
Retorna a ocorrência do objeto de exibição-filho que existe no índice especificado. | DisplayObjectContainer | |
|
Retorna o objeto de exibição-filho que existe com o nome especificado. | DisplayObjectContainer | |
|
Retorna a posição de índice de uma ocorrência-filho de DisplayObject. | DisplayObjectContainer | |
Retorna a entrada do histórico na posição especificada. | HTMLLoader | ||
|
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 | |
|
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
Navega de volta para o histórico do navegador, se possível. | HTMLLoader | ||
Navega para frente no histórico do navegador, se possível. | HTMLLoader | ||
Navegue no número indicado de etapas no histórico do navegador. | HTMLLoader | ||
|
Avalia a caixa delimitadora do objeto de exibição para ver se ela sobrepõe ou faz interseção com a caixa delimitadora do objeto de exibição obj. | DisplayObject | |
|
Avalia o objeto de exibição para ver se ele sobrepõe ou faz interseção com o ponto especificado pelos parâmetros x e y. | DisplayObject | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
Carrega o objeto HTMLLoader com dados do site especificado pelo parâmetro urlRequestToLoad. | HTMLLoader | ||
Carrega o objeto HTMLLoader com o conteúdo HTML contido na string HTML. | HTMLLoader | ||
|
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 | |
Recarrega a página a partir do local atual. | HTMLLoader | ||
|
Remove uma ocorrência-filho de DisplayObject especificada da lista de filhos da ocorrência de DisplayObjectContainer. | DisplayObjectContainer | |
|
Remove um DisplayObject filho da posição de índice especificada na lista de filhos de DisplayObjectContainer. | DisplayObjectContainer | |
|
Remove todas as instâncias filho DisplayObject especificadas da lista de filhos da instância DisplayObjectContainer. | DisplayObjectContainer | |
|
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | |
|
Ativa um teclado virtual. | InteractiveObject | |
|
Altera a posição de um filho existente no contêiner de objetos de exibição. | DisplayObjectContainer | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Permite ao usuário arrastar a entidade gráfica especificada. | Sprite | |
|
Deixa o usuário arrastar o sprite especificado em um dispositivo ativado pelo toque. | Sprite | |
|
Interrompe repetitivamente a execução da linha de tempo de todos os MovieClips enraizados neste objeto. | DisplayObjectContainer | |
|
Finaliza o método startDrag(). | Sprite | |
|
Termina o método startTouchDrag() para o uso com dispositivos ativados pelo toque. | Sprite | |
|
Alterna a ordem z (ordem da frente para trás) dos dois objetos filhos especificados. | DisplayObjectContainer | |
|
Alterna a ordem z (ordem da frente para trás) dos objetos-filho nas duas posições de índice especificadas na lista de filhos. | DisplayObjectContainer | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
|
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher | |
| 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 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 | ||
| Sinaliza que a última operação de carregamento solicitada pelo método loadString ou load foi concluída. | HTMLLoader | |||
| 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 | ||
| 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 | ||
| Sinaliza que uma ou ambas as propriedades contentWidth e contentHeight do objeto HTMLLoader foram alteradas. | HTMLLoader | |||
| Sinaliza que o HTML DOM foi criado em resposta a uma operação de carregamento. | HTMLLoader | |||
| Sinaliza que a renderização do conteúdo no objeto HTMLLoader foi completamente atualizada. | HTMLLoader | |||
| 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 | ||
| Sinaliza que a propriedade location do objeto HTMLLoader foi alterada. | HTMLLoader | |||
| Sinaliza que a propriedade location do objeto HTMLLoader foi alterada. | HTMLLoader | |||
| Sinaliza que a propriedade location do objeto HTMLLoader está prestes a ser alterada. | HTMLLoader | |||
| 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 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 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 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 | ||
| Sinaliza que a propriedade scrollH ou scrollV foi alterada pelo objeto HTMLLoader. | HTMLLoader | |||
| 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 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 | ||
| Sinaliza que uma exceção JavaScript não capturada ocorreu no objeto HTMLLoader. | HTMLLoader | |||
authenticate | propriedade |
authenticate:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Especifica se as solicitações de autenticação devem ser manipuladas (true) ou não (false) para solicitações HTTP emitidas por este objeto. Se for false, os desafios de autenticação retornam um erro HTTP.
O valor padrão é initialized from URLRequestDefaults.authenticate.
Implementação
public function get authenticate():Boolean public function set authenticate(value:Boolean):voidElementos da API relacionados
cacheResponse | propriedade |
cacheResponse:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Especifica se os dados de resposta bem-sucedidos devem ser armazenados em cache para as solicitações HTTP enviadas por este objeto. Ao ser definido como true, o objeto HTMLLoader usará o cache HTTP do sistema operacional.
O valor padrão é initialized from URLRequestDefaults.cacheResponse.
Implementação
public function get cacheResponse():Boolean public function set cacheResponse(value:Boolean):voidElementos da API relacionados
contentHeight | propriedade |
contentHeight:Number [somente leitura] | Versões de runtime: | AIR 1.0 |
A altura, em pixels, do conteúdo HTML. Essa propriedade pode alterar as dimensões da alteração do objeto HTMLLoader. Por exemplo, uma página HTML usa geralmente a altura inteira do objeto HTMLLoader, e a propriedade contentHeight pode ser alterada se a altura do objeto HTMLLoader for alterada.
Implementação
public function get contentHeight():Number contentWidth | propriedade |
contentWidth:Number [somente leitura] | Versões de runtime: | AIR 1.0 |
A largura, em pixels, do conteúdo HTML. Essa propriedade pode alterar as dimensões da alteração do objeto HTMLLoader. Por exemplo, uma página HTML usa geralmente a largura inteira do objeto HTMLLoader, e a propriedade contentWidth pode ser alterada se a largura do objeto HTMLLoader for alterada.
Implementação
public function get contentWidth():Number hasFocusableContent | propriedade |
height | propriedade |
height:Number[substituir] | Versões de runtime: | AIR 1.0 |
Especifica a altura do retângulo da tela HTML em renderização. Este valor de propriedade é a altura do objeto de exibição HTMLLoader em pixels. O valor máximo da altura é 4095 pixels. A alteração dessa propriedade fará com que o objeto HTMLLoader renderize novamente o documento HTML. Os eventos htmlBoundsChanged podem ser despachados em resposta à alteração dessa propriedade.
Quando você define as propriedades width e height de um objeto HTMLLoader, os limites do objeto são alterados, mas o conteúdo não é dimensionado (como aconteceria com outros tipos de objetos de exibição).
Implementação
override public function get height():Number override public function set height(value:Number):void historyLength | propriedade |
historyLength:uint [somente leitura] | Versões de runtime: | AIR 1.0 |
O comprimento geral da lista do histórico, incluindo entradas dianteiras e traseiras. Essa propriedade possui o mesmo valor da propriedade JavaScript window.history.length da página HTML.
Implementação
public function get historyLength():uintElementos da API relacionados
historyPosition | propriedade |
historyPosition:uint| Versões de runtime: | AIR 1.0 |
A posição atual na lista do histórico. A lista de histórico corresponde ao objeto window.history da página HTML. As entradas inferiores à posição atual são da lista "back"; as entradas maiores são "forward." Tentativas de definir a posição além do final a definirão para o final.
Implementação
public function get historyPosition():uint public function set historyPosition(value:uint):voidElementos da API relacionados
htmlHost | propriedade |
htmlHost:flash.html:HTMLHost| Versões de runtime: | AIR 1.0 |
O objeto HTMLHost usado para lidar com as alterações em certos elementos da interface do usuário, tais como a propriedade window.document.title do objeto HTMLLoader. Para substituir os comportamentos padrão do objeto HTMLLoader, crie uma subclasse da classe HTMLHost e substitua as suas funções de membro para manipular várias alterações de interface do usuário no conteúdo HTML.
Implementação
public function get htmlHost():flash.html:HTMLHost public function set htmlHost(value:flash.html:HTMLHost):voidElementos da API relacionados
idleTimeout | propriedade |
idleTimeout:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2 |
Especifica o valor de tempo limite ocioso (em milissegundos) para pedidos de HTTP emitidos por este objeto.
O tempo limite ocioso é o período de tempo (em milissegundos) que o cliente espera por uma resposta do servidor, depois que a conexão é estabelecida, antes de abandonar o pedido.
O valor padrão é initialized from URLRequestDefaults.idleTimeout.
Implementação
public function get idleTimeout():Number public function set idleTimeout(value:Number):voidElementos da API relacionados
isSupported | propriedade |
loaded | propriedade |
loaded:Boolean [somente leitura] | Versões de runtime: | AIR 1.0 |
Indica se o evento load do JavaScript correspondente à chamada anterior para o método load() ou loadString() foi entregue ao HTML DOM no objeto HTMLLoader. Essa propriedade é true antes de o evento complete ser despachado. É possível que essa propriedade nunca seja true. Isso sempre acontece quando o evento complete nunca é despachado.
Implementação
public function get loaded():Boolean location | propriedade |
manageCookies | propriedade |
manageCookies:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Especifica se a pilha de protocolo HTTP deve gerenciar cookies para este objeto. Se true, cookies serão adicionados à solicitação e cookies de resposta serão memorizados. Se for false, os cookies não são adicionados à solicitação e os cookies de resposta não são lembrados.
O valor padrão é initialized from URLRequestDefaults.manageCookies.
Implementação
public function get manageCookies():Boolean public function set manageCookies(value:Boolean):voidElementos da API relacionados
navigateInSystemBrowser | propriedade |
navigateInSystemBrowser:Boolean| Versões de runtime: | AIR 1.0 |
Especifica se a navegação do quadro-raiz do conteúdo HTML (por exemplo, quando o usuário clica em um link, quando a propriedade window.location é definida ou ao chamar window.open()) resulta em navegação no objeto HTMLLoader (false) ou no navegador da web padrão do sistema (true). Defina esta propriedade como true se desejar que toda a navegação ocorra no navegador da web do sistema (não no objeto HTMLLoader).
O valor padrão é false.
Implementação
public function get navigateInSystemBrowser():Boolean public function set navigateInSystemBrowser(value:Boolean):void paintsDefaultBackground | propriedade |
paintsDefaultBackground:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Determina se o segundo plano do documento HTMLLoader é branco opaco (true) ou não (false). Se essa propriedade estiver definida como false, o objeto HTMLLoader usa seu contêiner de objeto de exibição como segundo plano para o HTML e usa a opacidade (valor alpha) do contêiner de objeto de exibição como segundo plano do HTML. Entretanto, se o elemento body ou qualquer outro elemento do documento HTML tiver uma cor de segundo plano opaca (especificada por style="background-color:gray", por exemplo), parte do HTML renderizado usará a cor de segundo plano opaca.
Implementação
public function get paintsDefaultBackground():Boolean public function set paintsDefaultBackground(value:Boolean):void pdfCapability | propriedade |
pdfCapability:int [somente leitura] | Versões de runtime: | AIR 1.0 |
O tipo de suporte a PDF no sistema do usuário, definido como um valor de código integral. Um objeto HTMLLoader pode exibir o conteúdo PDF somente se esta propriedade avaliar PDFCapability.STATUS_OK. A classe PDFCapability define constantes para valores possíveis da propriedade pdfCapability conforme a seguir:
| Constante PDFCapability | Significado |
|---|---|
STATUS_OK | Uma versão suficiente (8.1 ou superior) do Acrobat ou do Adobe Reader foi detectada e o conteúdo PDF pode ser carregado em um objeto HTMLLoader.
Nota: no Windows, se o Acrobat ou o Adobe Reader versão 7.x ou superior estiver em execução no sistema do usuário, essa versão será usada, mesmo se houver instalada uma versão superior que ofereça suporte a PDF carregado em um objeto HTMLLoader. Nesse caso, se o valor da propriedade |
ERROR_INSTALLED_READER_NOT_FOUND | Nenhuma versão do Acrobat ou do Adobe Reader detectada. Um objeto HTMLLoader não pode exibir conteúdo em PDF. |
ERROR_INSTALLED_READER_TOO_OLD | O Acrobat ou o Adobe Reader foi detectado, mas a versão é muito antiga. Um objeto HTMLLoader não pode exibir conteúdo em PDF. |
ERROR_PREFERED_READER_TOO_OLD | Uma versão suficiente (8.1 ou superior) do Acrobat ou do Adobe Reader foi detectada, mas a versão configurada para manipular conteúdo PDF é anterior à versão 8.1. Um objeto HTMLLoader não pode exibir conteúdo PDF. |
Implementação
public static function get pdfCapability():intElementos da API relacionados
placeLoadStringContentInApplicationSandbox | propriedade |
placeLoadStringContentInApplicationSandbox:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.5 |
Especifica se o conteúdo carregado através do método loadString() é colocado na área de segurança do aplicativo (true) ou em uma área de segurança não aplicativo (false).
Quando essa propriedade está definida como false, o conteúdo carregado por meio do método loadString() é colocado em uma caixa de proteção que não seja do aplicativo com as seguintes características:
- Ela tem acesso ao conteúdo carregado na rede (mas não no sistema de arquivos).
- Ela não pode carregar dados usando XMLHttpRequest.
- A propriedade
window.locationé definida como"about:blank". - O conteúdo não pode acessar a propriedade
window.runtime(assim como o conteúdo em qualquer caixa de proteção que não seja do aplicativo).
Quando essa propriedade está definida como true, o conteúdo carregado por meio do método loadString() é colocado na caixa de proteção do aplicativo, com acesso à propriedade window.runtime e a todas as APIs do AIR. Você deve verificar se a fonte de dados de uma string usada em uma chamada para o método loadString() é confiável. Instruções de código na string HTML são executadas com todos os privilégios do aplicativo quando essa propriedade está definida como true. Você só deve definir essa propriedade como true quando tiver certeza de que a string não pode conter código mal-intencionado.
Em aplicativos compilados com SDKs do AIR 1.0 ou do AIR 1.1, o conteúdo carregado por meio do método loadString() é colocado na caixa de proteção do aplicativo.
O valor padrão é false.
Implementação
public function get placeLoadStringContentInApplicationSandbox():Boolean public function set placeLoadStringContentInApplicationSandbox(value:Boolean):voidElementos da API relacionados
runtimeApplicationDomain | propriedade |
runtimeApplicationDomain:ApplicationDomain| Versões de runtime: | AIR 1.0 |
O domínio do aplicativo a ser usado no objeto window.runtime no JavaScript na página HTML.
Se for null ou se o conteúdo HTML estiver em um domínio de segurança diferente do conteúdo SWF que contém o objeto HTMLLoader, a página usará um domínio do aplicativo padrão como seu domínio.
Implementação
public function get runtimeApplicationDomain():ApplicationDomain public function set runtimeApplicationDomain(value:ApplicationDomain):voidLança
SecurityError — Se o objeto ApplicationDomain não for do domínio de segurança do chamador.
|
Elementos da API relacionados
scrollH | propriedade |
scrollV | propriedade |
swfCapability | propriedade |
swfCapability:int [somente leitura] | Versões de runtime: | AIR 2 |
O tipo de suporte a SWF no sistema do usuário, definido como um valor de código integral. Um objeto HTMLLoader poderá exibir o conteúdo SWF somente se esta propriedade avaliar HTMLSWFCapability.STATUS_OK. A classe PDFCapability define constantes para valores possíveis da propriedade swfCapability conforme a seguir:
| constante HTMLSWFCapability | Significado |
|---|---|
STATUS_OK | Uma versão suficiente de Adobe Flash Player é detectada e o conteúdo de SWF pode ser carregado em um objeto HTMLLoader. |
ERROR_INSTALLED_PLAYER_NOT_FOUND | Não foi detectada nenhuma versão do Adobe Flash Player. Um objeto HTMLLoader não pode exibir conteúdo em SWF. |
ERROR_INSTALLED_PLAYER_TOO_OLD | O Adobe Flash Player foi detectado, mas a versão é muito antiga. Um objeto HTMLLoader não pode exibir conteúdo em SWF. |
Implementação
public static function get swfCapability():intElementos da API relacionados
textEncodingFallback | propriedade |
textEncodingFallback:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
A codificação de caractere usado pelo conteúdo HTMLLoader se uma página HTML não especificar uma codificação de caracteres. Uma página HTML especifica a codificação de caractere em uma marca meta, como a seguinte:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
Os valores são definidos na lista IANA de conjuntos de caracteres válidos.
Se nenhuma codificação for especificada pela página HTML pela propriedade textEncodingFallback ou pela propriedade textEncodingOverride, o conteúdo HTML usará a codificação ISO-8859-1.
Implementação
public function get textEncodingFallback():String public function set textEncodingFallback(value:String):voidElementos da API relacionados
textEncodingOverride | propriedade |
textEncodingOverride:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O caractere codificado usado pelo conteúdo HTMLLoader, substituindo qualquer configuração na página HTML. Uma página HTML especifica a codificação de caractere em uma marca meta, como a seguinte:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
Esta definição também substitui qualquer definição na propriedade textEncodingFallback.
Os valores são definidos na lista IANA de conjuntos de caracteres válidos.
Defina a propriedade textEncodingOverride depois de o conteúdo HTML ser carregado para que o AIR atualize o conteúdo HTML usando a codificação especificada. Depois que o HTMLLoader navegar para uma nova página, será necessário definir a propriedade novamente se desejar que a nova página use a codificação específica.
Se nenhuma codificação for especificada pela página HTML pela propriedade textEncodingFallback ou pela propriedade textEncodingOverride, o conteúdo HTML usará a codificação ISO-8859-1.
A definição da propriedade textEncodingOverride para null recupera o comportamento padrão.
Implementação
public function get textEncodingOverride():String public function set textEncodingOverride(value:String):voidElementos da API relacionados
useCache | propriedade |
useCache:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Especifica se o cache local deve ser consultado antes que as solicitações HTTP emitidas por este objeto realizem a busca dos dados.
O valor padrão é initialized from URLRequestDefaults.useCache.
Implementação
public function get useCache():Boolean public function set useCache(value:Boolean):voidElementos da API relacionados
userAgent | propriedade |
userAgent:String| Versões de runtime: | AIR 1.0 |
A string user agent a ser usada em qualquer solicitação de conteúdo a ser apresentado a partir deste objeto HTMLLoader.
Para definir a string user agent, defina a propriedade userAgent do objeto HTMLLoader antes de chamar o método load(). A propriedade userAgent do objeto URLRequest transmitida para o método load() não é usada.
Você pode definir a string de agente do usuário padrão usada pelos objetos HTMLLoader no domínio de um aplicativo configurando a propriedade URLRequestDefaults.userAgent. Se nenhum valor for definido para a propriedade userAgent do objeto HTMLLoader (ou se o valor for definido como null), o valor da string de agente do usuário será definido como o da propriedade estática URLRequestDefaults.userAgent.
Se um valor não for definido para a propriedade userAgent do HTMLLoader nem para URLRequestDefaults.userAgent, será usado um valor padrão como a string user agent. Esse valor padrão varia em função do sistema operacional do tempo de execução (tal como Mac OS, Linux ou Windows), do idioma do tempo de execução e da versão, como nos dois exemplos a seguir:
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, como Gecko) AdobeAIR/1.5""Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, como Gecko) AdobeAIR/1.5""Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, como Gecko) AdobeAIR/1.5"
Implementação
public function get userAgent():String public function set userAgent(value:String):voidElementos da API relacionados
width | propriedade |
width:Number[substituir] | Versões de runtime: | AIR 1.0 |
Especifica a largura do retângulo da tela HTML em renderização. Esta é a largura do objeto de exibição HTMLLoader em pixels. O valor máximo da largura é 4095 pixels. A alteração dessa propriedade fará com que o objeto HTMLLoader renderize novamente o documento HTML. Os eventos htmlBoundsChange podem ser despachados em resposta à alteração dessa propriedade. Quando você define as propriedade largura e altura de um objeto HTMLLoader, os limites do objeto são alterados, mas o conteúdo não é dimensionado (como aconteceria com outros tipos de objetos de exibição).
Implementação
override public function get width():Number override public function set width(value:Number):void window | propriedade |
HTMLLoader | () | Construtor |
public function HTMLLoader()| Versões de runtime: | AIR 1.0 |
Cria um objeto HTMLLoader.
cancelLoad | () | método |
public function cancelLoad():void| Versões de runtime: | AIR 1.0 |
Cancela qualquer operação de carga em andamento.
createRootWindow | () | método |
public static function createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader| Versões de runtime: | AIR 1.0 |
Cria um novo objeto NativeWindow que contém um objeto HTMLLoader. Usa o objeto HTMLLoader que retornou por meio deste método para carregar o conteúdo HTML.
Por padrão (ao não definir parâmetros na chamada deste método), a nova janela usará o sistema cromo padrão e incluirá controles de barra de rolagem para o conteúdo. Você pode definir os parâmetros para alterar as propriedades da nova janela.
Como a janela carrega o conteúdo e aplica folhas de estilo, problemas gráficos de menor importância podem ocorrer. Para impedir que essas descontinuidades sejam visíveis, defina o parâmetro visible como false. Quando a janela carregar e desenhar o seu conteúdo, revele-o definindo a propriedade window.nativeWindow.visible como true ou chame o método window.nativeWindow.activate().
Parâmetros
visible:Boolean (default = true) | |
windowInitOptions:NativeWindowInitOptions (default = null)null usar valores padrão NativeWindowInitOptions.
| |
scrollBarsVisible:Boolean (default = true) | |
bounds:Rectangle (default = null)null, especifica os limites da janela. Se qualquer x, y, largura ou altura for NaN, a dimensão correspondente da janela será deixada com o valor padrão.
|
flash.html:HTMLLoader — Um novo objeto HTMLLoader que está no palco do novo objeto NativeWindow.
|
getHistoryAt | () | método |
public function getHistoryAt(position:uint):flash.html:HTMLHistoryItem| Versões de runtime: | AIR 1.0 |
Retorna a entrada do histórico na posição especificada.
Parâmetros
position:uint — A posição na lista do histórico.
|
flash.html:HTMLHistoryItem — Um objeto URLRequest para a entrada do histórico na posição especificada.
|
Elementos da API relacionados
historyBack | () | método |
public function historyBack():void| Versões de runtime: | AIR 1.0 |
Navega de volta para o histórico do navegador, se possível.
A chamada desse método do objeto HTMLLoader possui o mesmo efeito de uma chamada ao método back() da propriedade window.history em JavaScript na página HTML.
Esta função não lança nenhum erro.
Elementos da API relacionados
historyForward | () | método |
public function historyForward():void| Versões de runtime: | AIR 1.0 |
Navega para frente no histórico do navegador, se possível.
A chamada desse método do objeto HTMLLoader possui o mesmo efeito de uma chamada ao método forward() da propriedade window.history em JavaScript na página HTML.
Esta função não lança nenhum erro.
Elementos da API relacionados
historyGo | () | método |
public function historyGo(steps:int):void| Versões de runtime: | AIR 1.0 |
Navegue no número indicado de etapas no histórico do navegador. Navegue para frente, se for positivo, e para trás, se for negativo. A navegação por zero força uma recarga.
Este método é equivalente a chamar o método go() da propriedade window.history em JavaScript na página HTML.
Esta função não lança nenhum erro.
Parâmetros
steps:int — O número de etapas na lista do histórico para avançar (positivo) ou voltar (negativo).
|
Elementos da API relacionados
load | () | método |
public function load(urlRequestToLoad:URLRequest):void| Versões de runtime: | AIR 1.0 |
Carrega o objeto HTMLLoader com dados do site especificado pelo parâmetro urlRequestToLoad. A chamada deste método inicialmente define a propriedade loaded para false. Este método inicia uma operação que é sempre concluída de modo assíncrono.
Uma chamada para esse método cancela implicitamente qualquer operação anterior de carregamento pendente iniciada com ele ou com o método loadString(). O evento complete para a operação anterior de carregamento nunca será entregue.
É possível que o evento complete nunca seja entregue. Isso acontece se qualquer conteúdo HTML carregado no objeto HTMLLoader nunca foi baixado completamente. Isso pode acontecer se o conteúdo HTML fizer referência a um URL para um script CGI que repetidamente gera um conteúdo indefinidamente.
Parâmetros
urlRequestToLoad:URLRequest — O objeto URLRequest que contém informações sobre o URL a ser carregado. Além do URL a ser carregado, um objeto URLRequest contém propriedades que definem o método de submissão de formulário HTTP (GET ou POST), quaisquer dados transmitidos com a solicitação e os cabeçalhos de solicitação.
|
Elementos da API relacionados
loadString | () | método |
public function loadString(htmlContent:String):void| Versões de runtime: | AIR 1.0 |
Carrega o objeto HTMLLoader com o conteúdo HTML contido na string HTML. Quando a renderização do HTML na string for concluída, o evento complete será despachado. O evento complete é sempre despachado assincronamente.
Uma chamada para esse método cancela implicitamente qualquer operação anterior de carregamento pendente iniciada com ele ou com o método load(). O evento complete para a operação anterior de carregamento nunca será entregue.
Se o HTML especificado na string não tiver referências a recursos externos, este método renderizará o HTML de modo síncrono. Contudo, o evento complete ainda será despachado assincronamente. Se a propriedade loaded desta classe for true seguindo imediatamente uma chamada para esta função, o conteúdo HTML especificado no argumento htmlContent foi renderizado de modo assincronamente.
É possível que o evento complete nunca seja entregue. Isso acontece se qualquer conteúdo HTML carregado no objeto HTMLLoader nunca foi baixado completamente. Isso pode acontecer se o conteúdo HTML fizer referência a um URL para um script CGI que repetidamente gera um conteúdo indefinidamente.
Conteúdo carregado por meio do método loadString() só é colocado na área de segurança do aplicativo caso a propriedade placeLoadStringContentInApplicationSandbox seja definida como true.
Parâmetros
htmlContent:String — A string com o conteúdo HTML para carregar no objeto HTMLLoader.
|
Elementos da API relacionados
reload | () | método |
public function reload():void| Versões de runtime: | AIR 1.0 |
Recarrega a página a partir do local atual.
complete | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.COMPLETE| Versões de runtime: | AIR 1.0 |
Sinaliza que a última operação de carregamento solicitada pelo método loadString ou load foi concluída. O evento é despachado depois de o evento JavaScript load ter disparado no HTML DOM no objeto HTMLLoader. Este evento é sempre despachado assincronamente. O manipulador de evento deste evento pode chamar qualquer método ou acessar qualquer propriedade do objeto HTMLLoader.
Event.COMPLETE define o valor da propriedade type de um objeto de evento complete.
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 de rede que concluiu o carregamento. |
Elementos da API relacionados
htmlBoundsChange | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.HTML_BOUNDS_CHANGE| Versões de runtime: | AIR 1.0 |
Sinaliza que uma ou ambas as propriedades contentWidth e contentHeight do objeto HTMLLoader foram alteradas. Isso pode resultar em uma nova imagem ou no carregamento de um outro conteúdo, por exemplo. Manipuladores de evento chamam qualquer método ou acessam qualquer propriedade do objeto HTMLLoader.
O objeto HTMLLoader pode despachar este evento a qualquer momento depois de iniciada uma operação de carregamento, mesmo após o objeto despachar o evento complete.
Event.HTML_BOUNDS_CHANGE define o valor da propriedade type de um objeto de evento htmlBoundsChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto HTMLLoader. |
target | O objeto HTMLLoader. |
Elementos da API relacionados
htmlDOMInitialize | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.HTML_DOM_INITIALIZE| Versões de runtime: | AIR 1.0 |
Sinaliza que o HTML DOM foi criado em resposta a uma operação de carregamento. Os métodos load() e loadString() do objeto HTMLLoader lançam uma exceção enquanto este evento é despachado. Qualquer propriedade ou método de qualquer objeto JavaScript acessível a partir da propriedade window do objeto HTMLLoader que controla o URL carregado no objeto HTMLLoader lança uma exceção se for definido ou chamado enquanto o evento é despachado. Por exemplo, definir window.location configurando a propriedade window do objeto HTMLLoader resulta em uma exceção JavaScript.
Event.HTML_DOM_INITIALIZE define o valor da propriedade type de um objeto de evento htmlDOMInitialize.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto HTMLLoader. |
target | O objeto HTMLLoader. |
Elementos da API relacionados
htmlRender | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.HTML_RENDER| Versões de runtime: | AIR 1.0 |
Sinaliza que a renderização do conteúdo no objeto HTMLLoader foi completamente atualizada. Este evento pode ser despachado com frequência—sempre que qualquer alteração de renderização é feita no conteúdo HTML. Por exemplo, este evento é despachado quando um novo conteúdo é exibido como resultado de um clique do usuário em um link ou quando o JavaScript da página renderiza o HTML. Ouvintes de evento podem chamar qualquer método ou acessar qualquer propriedade do objeto HTMLLoader.
Os manipuladores deste evento devem verificar as propriedades contentWidth e contentHeight do objeto HTMLLoader para atualizar qualquer barra de rolagem associada a ele.
O objeto HTMLLoader pode despachar este evento a qualquer momento depois de iniciada uma operação de carregamento, mesmo após o objeto despachar o evento complete.
Event.HTML_RENDER define o valor da propriedade type de um objeto de evento htmlRender.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto HTMLLoader. |
target | O objeto HTMLLoader. |
locationChange | Evento |
flash.events.LocationChangeEventpropriedade LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE| Versões de runtime: | AIR 2.7 |
Sinaliza que a propriedade location do objeto HTMLLoader foi alterada. O manipulador de evento deste evento pode chamar qualquer método ou acessar qualquer propriedade do objeto HTMLLoader.
A locationChange o evento do tipo LocationChangeEvent é despachado pelo HTMLLoader em aplicativos que usam AIR namespace 2.7 e depois. Em versões mais recentes do AIR, o objeto de evento despachado é uma instância da classe Event.
Elementos da API relacionados
locationChange | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.LOCATION_CHANGE| Versões de runtime: | AIR 1.0 |
Sinaliza que a propriedade location do objeto HTMLLoader foi alterada. O manipulador de evento deste evento pode chamar qualquer método ou acessar qualquer propriedade do objeto HTMLLoader.
Um evento locationChange do tipo Event é despachado pelo HTMLLoader em aplicativos que usam o namespace de um AIR anterior ao 2.7. No AIR 2.7 e posterior, o objeto de evento é uma instância da classe LocationChangeEvent, que fornece um conjunto de propriedades location adicional à URL da nova página.
Event.LOCATION_CHANGE define o valor da propriedade type de um objeto de evento locationChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto HTMLLoader. |
target | O objeto HTMLLoader. |
Elementos da API relacionados
locationChanging | Evento |
flash.events.LocationChangeEventpropriedade LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.7 |
Sinaliza que a propriedadelocation do objeto HTMLLoader está prestes a ser alterada.
Um evento locationChanging é despachado apenas quando a alteração de local é iniciada pela interação do usuário, como quando um usuário clica em um link, ou pelo código executado no HTMLLoader, como um redirecionamento pelo cliente. Por padrão, o novo local é exibido nesse objeto HTMLLoader. Você pode chamar o método preventDefault() do objeto de evento para cancelar o comportamento padrão. Por exemplo, você pode usar a função flash.net.navigateToURL() para abrir a página no navegador do sistema com base na propriedade location do objeto de evento.
Um evento locationChanging() não é despachado quando você chama os seguintes métodos:
- load()
- loadString()
- reload()
- historyBack()
- historyForward()
- historyGo()
Além disso, este evento não é despachado quando a propriedade navigateInSystemBrowser é true e a página de destino é aberta no navegador de sistema, desde que o local HTMLLoader não seja alterado.
LOCATION_CHANGING define o valor do objeto LocationChangeEvent da propriedade type despachado antes de uma alteração no local da página.
Exemplo ( Como usar este exemplo )
package{
import flash.display.Sprite;
import flash.html.HTMLLoader;
import flash.net.URLRequest;
public class LocationChanging extends Sprite
{
var htmlLoader:HTMLLoader = new HTMLLoader();
public function LocationChanging()
{
htmlLoader.width = stage.stageWidth;
htmlLoader.height = stage.stageHeight;
htmlLoader.addEventListener( LocationChangeEvent.LOCATION_CHANGING, onLocationChanging );
htmlLoader.load( new URLRequest( "http://www.adobe.com" ) );
this.addChild( htmlLoader );
}
private function onLocationChanging( event:LocationChangeEvent ):void
{
trace( "Location changing: " + event.location );
if ( event.location.indexOf( "http://www.adobe.com" ) < 0 )
{
event.preventDefault();
}
}
}
}
scroll | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.SCROLL| Versões de runtime: | AIR 1.0 |
Sinaliza que a propriedade scrollH ou scrollV foi alterada pelo objeto HTMLLoader. O objeto HTMLLoader despacha este evento quando o JavaScript em execução no objeto HTMLLoader invoca o método scrollTo() do objeto window e o local desejado ainda não é visível. O evento não é despachado quando o código ActionScript altera a propriedade scrollH ou a scrollV. Manipuladores de evento chamam qualquer método ou acessam qualquer propriedade do objeto HTMLLoader.
Manipuladores de evento para este evento devem verificar as propriedades scrollH e scrollV para atualizar quaisquer barras de rolagem associadas com o objeto HTMLLoader.
O objeto HTMLLoader pode despachar este evento a qualquer momento depois de iniciada uma operação de carregamento, mesmo após o objeto despachar o evento complete.
Event.SCROLL define o valor da propriedade type de um objeto de evento scroll.
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 TextField que foi rolado. A propriedade target nem 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. |
uncaughtScriptException | Evento |
flash.events.HTMLUncaughtScriptExceptionEventpropriedade HTMLUncaughtScriptExceptionEvent.type =
flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION| Versões de runtime: | AIR 1.0 |
Sinaliza que uma exceção JavaScript não capturada ocorreu no objeto HTMLLoader. Manipuladores de evento chamam qualquer método ou acessam qualquer propriedade do objeto HTMLLoader. O evento é cancelável e o comportamento padrão durante a execução do AIR Debug Launcher é enviar a pilha do JavaScript para a saída trace.
A constanteHTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION define o valor da propriedade type de um objeto de evento uncaughtScriptException.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
exceptionValue | O resultado da avaliação da expressão na instrução throw que resultou em uma exceção não capturada. |
stackTrace | Uma matriz de objetos que representa o rastreio da pilha no momento da instrução throw que resultou na exceção não capturada a ser executada. |
target | O objeto HTMLLoader. |
Elementos da API relacionados
package {
import flash.display.Sprite;
import flash.html.HTMLLoader;
import flash.net.URLRequest;
public class HTMLLoaderExample extends Sprite
{
public function HTMLLoaderExample()
{
var html:HTMLLoader = new HTMLLoader();
var urlReq:URLRequest = new URLRequest("http://www.adobe.com/");
html.width = stage.stageWidth;
html.height = stage.stageHeight;
html.load(urlReq);
addChild(html);
}
}
}
Wed Jun 13 2018, 11:10 AM Z