Uso do componente RadioButton

Um botão de opção pode ser ativado ou desativado. Um botão de opção desativado não recebe entradas de mouse nem de teclado. Quando o usuário clica em um grupo do componente RadioButton ou o acessa por meio da tecla tab, apenas o botão de opção selecionado recebe o foco. Em seguida, o usuário poderá utilizar as seguintes teclas para controlá-lo:

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

Uma visualização ao vivo de cada ocorrência de RadioButton no Palco reflete as alterações feitas nos parâmetros no Inspetor de propriedades ou no Inspetor de componentes durante a criação. No entanto, a exclusão mútua da seleção não é exibida na visualização ao vivo. Se você definir o parâmetro selecionado como true para dois botões de opção do mesmo grupo, eles aparecerão selecionados mesmo que somente a última ocorrência criada apareça selecionada em tempo de execução. Para obter mais informações, consulte Parâmetros do componente RadioButton .

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

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

A acessibilidade de um componente é ativada somente uma vez, independentemente de quantas ocorrências do componente existem. Para obter mais informações, consulte o Capítulo 18, “Criação de conteúdo acessível”, em Uso do Flash .

Você pode definir os seguintes parâmetros de autoria no Inspetor de propriedades ou no Inspetor de componentes de cada instância do componente RadioButton: groupName, label, LabelPlacement, selected e value . 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 RadioButton na Referência do ActionScript 3.0 para Flash Professional .

Você pode escrever o ActionScript para definir as opções adicionais das ocorrências de RadioButton usando os métodos, as propriedades e os eventos da classe RadioButton.

O procedimento a seguir explica como adicionar um componente RadioButton a um aplicativo durante a criação. Neste exemplo, os RadioButtons são usados para apresentar uma pergunta sim-ou-não. Os dados do RadioButton são exibidos em uma TextArea.

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

2. Arraste dois componentes RadioButton do painel Componentes para o Palco.

3. Selecione o primeiro botão de opção. No Inspetor de propriedades, atribua a ele o nome de ocorrência yesRb e o nome de grupo rbGroup.

4. Selecione o segundo botão de opção. No Inspetor de propriedades, atribua a ele o nome de ocorrência noRb e o nome de grupo rbGroup.

5. Arraste um componente TextArea do painel Componentes para o Palco e atribua a ele o nome de ocorrência aTa .

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

   yesRb.label = "Yes"; 
   yesRb.value = "For"; 
   noRb.label = "No"; 
   noRb.value = "Against"; 
    
   yesRb.move(50, 100); 
   noRb.move(100, 100); 
   aTa.move(50, 30); 
   noRb.addEventListener(MouseEvent.CLICK, clickHandler); 
   yesRb.addEventListener(MouseEvent.CLICK, clickHandler); 
    
   function clickHandler(event:MouseEvent):void { 
       aTa.text = event.target.value; 
   }

7. Selecione Controlar > Testar filme para executar o aplicativo.