Uso do componente UILoader

O componente UILoader é um contêiner que pode exibir arquivos SWF, JPEG, JPEG progressivo, PNG e GIF. Você pode usar um carregador de UI sempre que precisar recuperar conteúdo de um local remoto e inseri-lo em um aplicativo Flash. Por exemplo, você pode usar um carregador de UI para adicionar o logotipo de uma empresa (arquivo JPEG) a um formulário. Você também pode usar o componente UILoader em um aplicativo que exiba fotos. Use o método load() para carregar o conteúdo, a propriedade percentLoaded para determinar o volume de conteúdo que já foi carregado e o evento complete para determinar quando o carregamento será concluído.

Você pode dimensionar o conteúdo do carregador de UI ou redimensionar o próprio carregador de UI para acomodar o tamanho do conteúdo. Por padrão, o conteúdo é ajustado ao carregador de UI. Você também pode carregar o conteúdo em tempo de execução e monitorar o progresso do carregamento (embora o conteúdo seja armazenado em cache após seu carregamento, o progresso salta rapidamente para 100%). Se você especificar um local ao carregar o conteúdo no carregador de UI, deverá especificar o local (coordenadas X e Y) como 0, 0.

Interação do usuário com o componente UILoader

Um componente UILoader pode receber o foco. No entanto, o conteúdo carregado no componente UILoader pode aceitar o foco e ter suas próprias interações de foco. Para obter mais informações sobre o controle do foco, consulte a classe FocusManager na Referência do ActionScript 3.0 para Flash Professional e Trabalho com o FocusManager .

Parâmetros do componente UILoader

Você pode definir os seguintes parâmetros de autoria no Inspetor de propriedades ou no Inspetor de componentes de cada instância do componente UILoader: autoLoad , maintainAspectRatio , source e scaleContent . Cada um desses parâmetros tem uma propriedade ActionScript correspondente de mesmo nome.

Uma visualização ao vivo de cada ocorrência de UILoader reflete as alterações feitas nos parâmetros no Inspetor de propriedades ou no Inspetor de componentes durante a criação.

Você pode escrever o ActionScript de modo a definir opções adicionais para as ocorrências de UILoader usando seus métodos, propriedades e eventos. Para obter mais informações, consulte a classe UILoader na Referência do ActionScript 3.0 para Flash Professional .

Criação de um aplicativo com o componente UILoader

O procedimento a seguir explica como adicionar um componente UILoader a um aplicativo durante a criação. Neste exemplo, o carregador obtém uma imagem GIF de um logotipo.

  1. Crie um novo documento Flash (ActionScript 3.0).

  2. Arraste um componente UILoader do painel Componentes para o Palco.

  3. No Inspetor de propriedades, digite o nome de ocorrência aUI .

  4. Selecione o carregador no Palco e no Inspetor de componentes, e digite http://www.helpexamples.com/images/logo.gif como parâmetro source .

Criação de uma ocorrência do componente UILoader por meio do ActionScript

Este exemplo cria um componente UILoader com o ActionScript e carrega uma imagem de flor JPEG. Quando o evento complete ocorre, ele exibe o número de bytes carregados no painel Saída.

  1. Crie um novo documento Flash (ActionScript 3.0).

  2. Arraste o componente UILoader do painel Componentes para o painel Biblioteca.

  3. Abra o painel Ações, selecione Quadro 1 na Linha do tempo principal e digite o seguinte código do ActionScript: 

    import fl.containers.UILoader; 
 
var aLoader:UILoader = new UILoader(); 
aLoader.source = "http://www.flash-mx.com/images/image1.jpg"; 
aLoader.scaleContent = false; 
addChild(aLoader); 
 
aLoader.addEventListener(Event.COMPLETE, completeHandler); 
function completeHandler(event:Event) { 
    trace("Number of bytes loaded: " + aLoader.bytesLoaded); 
}

  4. Selecione Controlar > Testar filme.