IsDlgButtonChecked, fonction (winuser.h)

Article
08/27/2023

La fonction IsDlgButtonChecked détermine si un contrôle bouton est activé ou si un contrôle de bouton à trois états est activé, désactivé ou indéterminé.

Syntaxe

UINT IsDlgButtonChecked(
  [in] HWND hDlg,
  [in] int  nIDButton
);

Paramètres

[in] hDlg

Type : HWND

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

[in] nIDButton

Type : int

Identificateur du contrôle bouton.

Valeur retournée

Type : UINT

La valeur de retour d’un bouton créé avec les styles BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON ou BS_3STATE peut être l’une des valeurs du tableau suivant. Si le bouton a un autre style, la valeur de retour est zéro.

Code de retour	Description
BST_CHECKED	Le bouton est activé.
BST_INDETERMINATE	Le bouton est dans un état indéterminé (s’applique uniquement si le bouton a le style BS_3STATE ou BS_AUTO3STATE ).
BST_UNCHECKED	Le bouton n’est pas activé.

Remarques

La fonction IsDlgButtonChecked envoie un message BM_GETCHECK au contrôle de bouton spécifié.

Exemples

Pour obtenir un exemple, consultez la section intitulée « Création d’une boîte de dialogue sans mode » dans Utilisation de boîtes de dialogue.

Configuration requise


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)

Voir aussi

CheckDlgButton

Partager via