IsDlgButtonChecked, fonction (winuser.h)

  • Article

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