Exporter (0) Imprimer
Développer tout

CheckBox, classe

Représente un CheckBox Windows.

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

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

Utilisez CheckBox pour proposer à l'utilisateur un choix de type vrai/faux ou oui/non. Le contrôle CheckBox peut afficher une image, du texte ou les deux à la fois.

Les contrôles CheckBox et RadioButton possèdent une fonction similaire : ils permettent à l'utilisateur d'effectuer son choix parmi une liste d'options. Les contrôles CheckBox permettent à l'utilisateur de sélectionner une combinaison d'options. Les contrôles RadioButton permettent par contre à l'utilisateur d'effectuer son choix parmi des options s'excluant mutuellement.

La propriété Appearance détermine si CheckBox s'affiche sous la forme de CheckBox traditionnelle ou sous la forme d'un bouton.

La propriété ThreeState détermine si le contrôle prend en charge deux ou trois états. Utilisez la propriété Checked pour obtenir ou définir la valeur d'un contrôle CheckBox à deux états et utilisez la propriété CheckState pour obtenir ou définir la valeur d'un contrôle CheckBox à trois états.

RemarqueRemarque

Si true est affecté à la propriété ThreeState, la propriété Checked retournera alors true pour indiquer un état activé ou indéterminé.

La propriété FlatStyle détermine le style et la forme du contrôle. Si FlatStyle.System est affecté à la propriété FlatStyle, le système d'exploitation de l'utilisateur détermine alors la forme du contrôle.

RemarqueRemarque

Lorsque FlatStyle.System est affecté à la propriété FlatStyle, la propriété CheckAlign est ignorée et le contrôle s'affiche selon l'alignement ContentAlignment.MiddleLeft ou ContentAlignment.MiddleRight. Si l'un des alignements à droite est affecté à la propriété CheckAlign, le contrôle s'affiche alors selon l'alignement ContentAlignment.MiddleRight ; sinon, il s'affiche selon l'alignement ContentAlignment.MiddleLeft.

L'exemple suivant illustre un état indéterminé. Vous disposez de CheckBox qui détermine si le texte sélectionné dans RichTextBox est en gras. Lorsque vous sélectionnez du texte, vous pouvez cliquer sur CheckBox pour mettre en gras la sélection. De la même manière, lorsque vous sélectionnez du texte, CheckBox indique si le texte sélectionné est en gras. Si vous avez sélectionné du texte comportant du texte en gras et du texte normal, l'état de CheckBox est alors indéterminé.

L'exemple de code suivant crée et initialise un CheckBox, lui donne son apparence de bouton bascule, donne la valeur false à AutoCheck et l'ajoute à 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);
 }
 

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft