Exportar (0) Imprimir
Expandir todo

CheckBox (Clase)

Representa un control CheckBox de Windows.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
[ComVisibleAttribute(true)] 
public class CheckBox : ButtonBase
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
/** @attribute ComVisibleAttribute(true) */ 
public class CheckBox extends ButtonBase
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
ComVisibleAttribute(true) 
public class CheckBox extends ButtonBase
No aplicable.

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.

NotaNota:

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.

NotaNota:

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);
 }
 

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Mostrar:
© 2014 Microsoft