Uso do componente UIScrollBar

O componente UIScrollBar permite adicionar uma barra de rolagem a um campo de texto. Você pode adicionar uma barra de rolagem a um campo de texto durante a criação ou em tempo de execução com o ActionScript. Para usar o componente UIScrollBar, crie um campo de texto no Palco e arraste o componente UIScrollBar do painel Componentes para qualquer quadrante da caixa delimitadora do campo de texto.

Se a barra de rolagem for menor que o tamanho combinado de suas setas de rolagem, ela não será exibida corretamente. Um dos botões de seta ficará oculto atrás do outro. O Flash não fornece verificação de erro para isso. Nesse caso, é recomendável ocultar a barra de rolagem com o ActionScript. Se a barra de rolagem for dimensionada para que haja espaço suficiente para a caixa de rolagem (miniatura), o Flash tornará a caixa de rolagem invisível.

O componente UIScrollBar funciona como qualquer outra barra de rolagem. Ele contém botões de seta em ambas as extremidades, e uma trilha de rolagem e uma caixa de rolagem (miniatura) entre eles. O componente UIScrollBara pode ser anexado a qualquer borda de um campo de texto e usado verticalmente e horizontalmente.

Para obter informações sobre TextField, consulte a classe TextField na Referência do ActionScript 3.0 para Flash Professional .

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

Diferente de muitos outros componentes, o componente UIScrollBar pode receber uma entrada de mouse contínua, quando, por exemplo, o usuário mantém pressionado o botão do mouse, em vez de exigir repetidos cliques.

Não há interação do teclado com o componente UIScrollBar.

Parâmetros do componente UIScrollBar

Você pode definir os seguintes parâmetros de autoria no Inspetor de propriedades ou no Inspetor de componentes de cada instância do componente UIScrollBar: direction e scrollTargetName . Cada um desses parâmetros tem uma propriedade ActionScript correspondente de mesmo nome.

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

Criação de um aplicativo com o componente UIScrollBar

O procedimento a seguir descreve como adicionar um componente UIScrollBar a um aplicativo durante a criação.

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

  2. Crie um campo de texto dinâmico que tenha altura suficiente para reter uma ou duas linhas de texto, e atribua a ele o nome de ocorrência myText no Inspetor de propriedades.

  3. No Inspetor de propriedades, defina o tipo de linha do campo de entrada de texto para Multilinha ou Multilinha sem quebra caso você pretenda usar a barra de rolagem horizontalmente.

  4. Abra o painel Ações, selecione Quadro 1 na Linha do tempo principal e digite o seguinte código do ActionScript para preencher a propriedade text , a fim de que um usuário precise rolá-lo para vê-lo na íntegra: 

    myText.text="When the moon is in the seventh house and Jupiter aligns with Mars, then peace will guide the planet and love will rule the stars."
    Nota: Verifique se o campo de texto no Palco é pequeno demais a ponto de ser necessária a rolagem para que ele seja exibido completamente. Se não for, a barra de rolagem não aparecerá ou poderá aparecer simplesmente como duas linhas sem miniatura (a parte que você arrasta para rolar o conteúdo).

  5. Verifique se o encaixe do objeto está ativado (Exibir > Encaixe > Encaixar nos objetos).

  6. Arraste uma ocorrência de UIScrollBar do painel Componentes para o campo de entrada de texto próximo ao lado ao qual você deseja anexá-lo. O componente deve ser sobreposto ao campo de texto quando você soltar o mouse a fim de que seja corretamente ligado ao campo. Atribua a ele o nome de ocorrência mySb .

    A propriedade scrollTargetName do componente é preenchida automaticamente com o nome de ocorrência do campo de texto no Inspetor de propriedades e no Inspetor de componentes. Se ela não aparecer na aba Parâmetros, é provável que a ocorrência de UIScrollBar não tenha sido suficientemente sobreposta.

  7. Selecione Controlar > Testar filme.

Criar um componente UIScrollBar por meio do ActionScript

Você pode criar uma ocorrência de UIScrollBar com o ActionScript e associá-la a um campo de texto em tempo de execução. O exemplo a seguir cria uma ocorrência de UIScrollBar orientada horizontalmente e a anexa à parte inferior de uma ocorrência de campo de texto chamada myTxt , que é carregada com o texto a partir de uma URL. O exemplo também define o tamanho da barra de rolagem para que corresponda ao tamanho do campo de texto:

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

  2. Arraste o componente ScrollBar 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 flash.net.URLLoader; 
import fl.controls.UIScrollBar; 
import flash.events.Event; 
 
var myTxt:TextField = new TextField(); 
myTxt.border = true; 
myTxt.width = 200; 
myTxt.height = 16; 
myTxt.x = 200; 
myTxt.y = 150; 
 
var mySb:UIScrollBar = new UIScrollBar(); 
mySb.direction = "horizontal"; 
// Size it to match the text field. 
mySb.setSize(myTxt.width, myTxt.height);  
 
// Move it immediately below the text field. 
mySb.move(myTxt.x, myTxt.height + myTxt.y); 
 
// put them on the Stage 
addChild(myTxt); 
addChild(mySb); 
// load text 
var loader:URLLoader = new URLLoader(); 
var request:URLRequest = new URLRequest("http://www.helpexamples.com/flash/lorem.txt"); 
loader.load(request); 
loader.addEventListener(Event.COMPLETE, loadcomplete); 
 
function loadcomplete(event:Event) { 
    // move loaded text to text field 
    myTxt.text = loader.data; 
    // Set myTxt as target for scroll bar. 
    mySb.scrollTarget = myTxt; 
}

  4. Selecione Controlar > Testar filme.