Partilhar via

Visão geral do controle RadioButton (Windows Forms)

  • Artigo

Os controles RadioButton Windows Forms apresentam um conjunto de duas ou mais opções mutuamente exclusivas para o usuário. Embora os botões de opção e as caixas de seleção possam parecer funcionar de forma semelhante, há uma diferença importante: quando um usuário seleciona um botão de opção, os outros botões de opção no mesmo grupo também não podem ser selecionados. Em contraste, qualquer número de caixas de seleção pode ser marcado. Definir um grupo de botões de opção indica ao utilizador: "Aqui está um conjunto de opções do qual pode escolher apenas uma."

Usando o controle

Quando um controle RadioButton é clicado, sua propriedade Checked é definida como true e o manipulador de eventos Click é chamado. O evento CheckedChanged é gerado quando o valor da propriedade Checked muda. Se a propriedade AutoCheck estiver definida como true (o padrão), quando o botão de opção for selecionado, todos os outros no grupo serão automaticamente limpos. Essa propriedade geralmente só é definida como false quando o código de validação é usado para garantir que o botão de opção selecionado seja uma opção permitida. O texto exibido dentro do controle é definido com a propriedade Text, que pode conter atalhos de tecla de acesso. Uma tecla de acesso permite que um usuário "clique" no controle pressionando a tecla ALT com a tecla de acesso. Para obter mais informações, consulte Como criar chaves de acesso para controles do Windows Forms e Como definir o texto exibido por um controle do Windows Forms.

O controle RadioButton pode aparecer como um botão de comando que parece estar pressionado caso seja selecionado, se a propriedade Appearance estiver definida como Button. Os botões de opção também podem exibir imagens usando as propriedades Image e ImageList. Para obter mais informações, consulte Como definir a imagem exibida por um controle do Windows Forms.

Ver também