CheckDlgButton, fonction (winuser.h)

Modifie l’état case activée d’un contrôle bouton.

Syntaxe

BOOL CheckDlgButton(
  [in] HWND hDlg,
  [in] int  nIDButton,
  [in] UINT uCheck
);

[in] hDlg

Type : HWND

Handle de la boîte de dialogue qui contient le bouton.

[in] nIDButton

Type : int

Identificateur du bouton à modifier.

[in] uCheck

Type : UINT

État case activée du bouton. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
BST_CHECKED	Définit l’état du bouton sur activé.
BST_INDETERMINATE	Définit l’état du bouton sur grisé, indiquant un état indéterminé. Utilisez cette valeur uniquement si le bouton a le style BS_3STATE ou BS_AUTO3STATE .
BST_UNCHECKED	Définit l’état du bouton sur désactivé

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

La fonction CheckDlgButton envoie un message BM_SETCHECK au contrôle de bouton spécifié dans la boîte de dialogue spécifiée.

Pour obtenir un exemple, consultez Création d’une boîte de dialogue sans mode dans Utilisation de boîtes de dialogue.


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-dialogbox-l1-1-0 (introduit dans Windows 8)

Référence