CheckBox (Clase)

Utilice un control CheckBox para dar al usuario una opción del tipo verdadero/falso o sí/no. El control CheckBox de casilla de verificación puede mostrar una imagen o texto, o ambos.

Los controles CheckBox y RadioButton tienen una función similar: ambos permiten al usuario elegir de una lista de opciones. Los controles CheckBox permiten al usuario elegir una combinación de opciones. Por otra parte, los controles RadioButton permiten al usuario elegir a partir de opciones que se excluyen mutuamente.

La propiedad Appearance determina si la casilla de verificación CheckBox como un control CheckBox típico o como un botón.

La propiedad ThreeState determina si el control admite dos o tres estados. Utilice la propiedad Checked para obtener o establecer el valor de un control CheckBox de casilla de verificación de dos estados y use la propiedad CheckState para obtener o establecer el valor de un control CheckBox de casilla de verificación de tres estados.

Nota:
Si se establece la propiedad ThreeState en true, la propiedad Checked devuelve true para los estados activado o indeterminado.

La propiedad FlatStyle determina el estilo y el aspecto del control. Si la propiedad FlatStyle se establece en FlatStyle.System, el sistema operativo del usuario determina la apariencia del control.

Nota:

Cuando se establece la propiedad FlatStyle en FlatStyle.System, se omite la propiedad CheckAlign y se muestra el control con la alineación ContentAlignment.MiddleLeft o ContentAlignment.MiddleRight. Si se establece la propiedad CheckAlign en una de las alineaciones a la derecha, se muestra el control con la alineación ContentAlignment.MiddleRight; de lo contrario, se muestra con la alineación ContentAlignment.MiddleLeft.

A continuación se describe en qué consiste un estado indeterminado. Dispone de un control CheckBox que determina si el texto seleccionado en un control RichTextBox está en negrita. Cuando seleccione texto, puede hacer clic en la casilla de verificación CheckBox para poner en negrita la selección. De forma parecida , al seleccionar parte del texto, la casilla CheckBox muestra si el texto seleccionado está en negrita. Si el texto seleccionado contiene texto con formato normal y con formato de negrita, la casilla de verificación CheckBox tendrá un estado indeterminado.

En el siguiente ejemplo de código se crea y se inicializa un control CheckBox, se le da la apariencia de un botón de alternar, se establece AutoCheck en false y se agrega a un formulario Form.

public void InstantiateMyCheckBox()
 {
    // Create and initialize a CheckBox.   
    CheckBox checkBox1 = new CheckBox(); 

    // Make the check box control appear as a toggle button.
    checkBox1.Appearance = Appearance.Button;

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

    // Add the check box control to the form.
    Controls.Add(checkBox1);
 }

public void InstantiateMyCheckBox()
{
    // Create and initialize a CheckBox.   
    CheckBox checkBox1 = new CheckBox();

    // Make the check box control appear as a toggle button.
    checkBox1.set_Appearance(Appearance.Button);

    // Turn off the update of the display on the click of the control.
    checkBox1.set_AutoCheck(false);

    // Add the check box control to the form.
    get_Controls().Add(checkBox1);
} //InstantiateMyCheckBox

public function InstantiateMyCheckBox()
 {
    // Create and initialize a CheckBox.   
    var checkBox1 : CheckBox = new CheckBox(); 

    // Make the check box control appear as a toggle button.
    checkBox1.Appearance = Appearance.Button;

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

    // Add the check box control to the form.
    Controls.Add(checkBox1);
 }

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework

.NET Compact Framework

Referencia

Otros recursos