RadioButton.AutoCheck Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

RadioButton.cs

Obtém ou define um valor que indica se o Checked valor e a aparência do controle são alterados automaticamente quando o controle é clicado.

public:
 property bool AutoCheck { bool get(); void set(bool value); };

public bool AutoCheck { get; set; }

member this.AutoCheck : bool with get, set

Public Property AutoCheck As Boolean

Valor da propriedade

Boolean

true se o Checked valor e a aparência do controle forem alterados automaticamente no Click evento; caso contrário, false. O valor padrão é true.

Exemplos

O exemplo de código a seguir cria e inicializa um RadioButton, fornece a ele a aparência de um controle de alternância, define sua AutoCheck propriedade como false, e adiciona-a a um Form.

private void InitializeMyRadioButton()
{
   // Create and initialize a new RadioButton.
   RadioButton radioButton1 = new RadioButton();

   // Make the radio button control appear as a toggle button.
   radioButton1.Appearance = Appearance.Button;

   // Turn off the update of the display on the click of the control.
   radioButton1.AutoCheck = false;

   // Add the radio button to the form.
   Controls.Add(radioButton1);
}

Private Sub InitializeMyRadioButton()
    ' Create and initialize a new RadioButton. 
    Dim radioButton1 As New RadioButton()
       
    ' Make the radio button control appear as a toggle button.
    radioButton1.Appearance = Appearance.Button
       
    ' Turn off the update of the display on the click of the control.
    radioButton1.AutoCheck = False
       
    ' Add the radio button to the form.
    Controls.Add(radioButton1)
End Sub

Comentários

Se o Checked valor for definido como false, a RadioButton parte do controle deverá ser verificada no código no Click manipulador de eventos. Além disso, se faz RadioButton parte de um RadioButton grupo de controle, essa propriedade garante que apenas um dos controles seja verificado em um determinado momento.

Se a AutoCheck propriedade estiver definida como false, um grupo de RadioButton controles não atuará como um grupo mutuamente exclusivo e a Checked propriedade deverá ser atualizada no código.