Uso do componente CheckBox

A CheckBox é uma caixa quadrada que pode ser marcada ou desmarcada. Quando ele é marcado, uma caixa de seleção aparece na caixa. Você pode adicionar um rótulo de texto a uma CheckBox e colocá-lo à esquerda, à direita, acima ou abaixo da CheckBox.

Você pode usar as CheckBoxes para reunir um conjunto de valores verdadeiro ou falso que não sejam mutuamente exclusivos. Por exemplo, um aplicativo que reúne informações sobre o tipo de carro a ser comprado pode usar CheckBoxes para permitir que você selecione recursos.

Interação do usuário com a CheckBox

É possível ativar ou desativar uma CheckBox em um aplicativo. Se a CheckBox estiver ativada e o usuário clicar nela ou em seu rótulo, ela receberá o foco de entrada e será exibida com a aparência pressionada. Se um usuário mover o ponteiro para fora da área delimitadora de uma CheckBox ou de seu rótulo enquanto pressiona o botão do mouse, a aparência do componente retornará ao seu estado original e reterá o foco de entrada. O estado de uma CheckBox muda apenas depois que o mouse é solto sobre o componente. Além disso, a CheckBox tem dois estados desativados, marcado e desmarcado, que usam selectedDisabledSkin e disabledSkin , respectivamente, que não permitem a interação do mouse ou do teclado.

Se uma CheckBox for desativada, ela será exibida como desativada, independentemente da interação do usuário. No estado desativado, uma CheckBox não recebe a entrada do mouse ou do teclado.

Uma ocorrência de CheckBox receberá o foco se um usuário clicar nela ou acessá-la por meio da tecla tab. Quando uma ocorrência de CheckBox estiver com o foco, você poderá usar as seguintes teclas para controlá-la:

Tecla

Descrição

Shift+Tab

Move o foco para o elemento anterior.

Barra de espaço

Marca ou desmarca o componente e aciona o evento change .

Tabulação

Move o foco para o elemento seguinte.

Para obter mais informações sobre o controle do foco, consulte Trabalho com o FocusManager e a classe FocusManager na Referência do ActionScript 3.0 para Flash Professional .

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

Quando você adicionar o componente CheckBox a um aplicativo, poderá torná-lo acessível a um leitor de tela adicionando as seguintes linhas do código do ActionScript: 

import fl.accessibility.CheckBoxAccImpl; 
 
CheckBoxAccImpl.enableAccessibility();

A acessibilidade de um componente é ativada somente uma vez, independentemente de quantas ocorrências do componente existem.

Parâmetros do componente CheckBox

Você pode definir os seguintes parâmetros de autoria no Inspetor de propriedades ou no Inspetor de componentes para cada instância do componente CheckBox: label , labelPlacement e selected . Cada um desses parâmetros tem uma propriedade ActionScript correspondente de mesmo nome. Para obter informações sobre os possíveis valores desses parâmetros, consulte a classe CheckBox na Referência do ActionScript 3.0 para Flash Professional .

Criar um aplicativo por meio da CheckBox

O procedimento a seguir explica como adicionar um componente CheckBox a um aplicativo durante a criação, usando um trecho de um formulário de aplicativo de empréstimo. O formulário pergunta se o candidato é um proprietário de imóvel e fornece uma CheckBox para que o usuário responda “sim”. Em caso afirmativo, o formulário apresentará dois botões de opção para o usuário indicar o valor relativo do imóvel.

Criar um aplicativo por meio do componente Checkbox

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

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

  3. No Inspetor de propriedades, faça o seguinte:

    • Digite homeCh como nome de ocorrência.

    • Digite 140 como valor da largura (L).

    • Digite “ Quer ter uma casa própria ?” como parâmetro label.

  4. Arraste dois componentes RadioButton do painel Componentes para o Palco e coloque-os abaixo e à direita da CheckBox. Digite os valores a seguir para eles no Inspetor de propriedades:

    • Digite underRb e overRb como nomes de ocorrência.

    • Digite 120 como parâmetro de largura (L) dos dois RadioButtons.

    • Digite Abaixo de US$ 500.000? como parâmetro label underRb .

    • Digite Acima de US$ 500.000? como parâmetro label overRb .

    • Digite valueGrp como parâmetro groupName dos dois RadioButtons.

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

    homeCh.addEventListener(MouseEvent.CLICK, clickHandler); 
underRb.enabled = false; 
overRb.enabled = false; 
 
function clickHandler(event:MouseEvent):void { 
    underRb.enabled = event.target.selected; 
    overRb.enabled = event.target.selected;     
}

    Esse código cria um manipulador para o evento CLICK que ativará os RadioButtons underRb e overRb se a CheckBox homeCh for marcada e os desativará se homeCh não for marcada. Para obter mais informações, consulte a classe MouseEvent na Referência do ActionScript 3.0 para Flash Professional .

  6. Selecione Controlar > Testar filme.

O exemplo a seguir duplica o aplicativo anterior, mas cria a CheckBox e os RadioButtons com o ActionScript.

Criar uma CheckBox por meio do ActionScript

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

  2. Arraste o componente CheckBox e o componente RadioButton do painel Componentes para o painel Biblioteca do documento atual. Se o painel Biblioteca não estiver aberto, pressione Ctrl+L ou selecione Janela > Biblioteca para abri-lo.

    Isso disponibiliza os componentes para os seus aplicativos, mas não os coloca no Palco.

  3. Abra o painel Ações, selecione Quadro 1 na Linha do tempo principal e digite o seguinte código para criar e posicionar ocorrências de componentes: 

    import fl.controls.CheckBox; 
import fl.controls.RadioButton; 
 
var homeCh:CheckBox = new CheckBox(); 
var underRb:RadioButton = new RadioButton(); 
var overRb:RadioButton = new RadioButton(); 
addChild(homeCh); 
addChild(underRb); 
addChild(overRb); 
underRb.groupName = "valueGrp"; 
overRb.groupName = "valueGrp"; 
homeCh.move(200, 100); 
homeCh.width = 120; 
homeCh.label = "Own your home?"; 
underRb.move(220, 130); 
underRb.enabled = false; 
underRb.width = 120; 
underRb.label = "Under $500,000?"; 
overRb.move(220, 150); 
overRb.enabled = false; 
overRb.width = 120; 
overRb.label = "Over $500,000?";

    Esse código usa os construtores CheckBox() e RadioButton() para criar os componentes e o método addChild() para colocá-los no Palco. Ele usa o método move() para posicionar os componentes no Palco.

  4. Agora, adicione o seguinte ActionScript para criar um ouvinte de evento e uma função de manipulador de evento: 

    homeCh.addEventListener(MouseEvent.CLICK, clickHandler); 
 
function clickHandler(event:MouseEvent):void { 
    underRb.enabled = event.target.selected; 
    overRb.enabled = event.target.selected;     
}

    Esse código cria um manipulador para o evento CLICK que ativará os botões de opção underRb e overRb se a CheckBox homeCh for marcada e os desativará se homeCh não for marcada. Para obter mais informações, consulte a classe MouseEvent na Referência do ActionScript 3.0 para Flash Professional .

  5. Selecione Controlar > Testar filme.