Partager via

CheckRadioButton, fonction (winuser.h)

  • Article

Ajoute une marque case activée à (vérifie) une case d’option spécifiée dans un groupe et supprime une marque case activée de (efface) toutes les autres cases d’option du groupe.

Syntaxe

BOOL CheckRadioButton(
  [in] HWND hDlg,
  [in] int  nIDFirstButton,
  [in] int  nIDLastButton,
  [in] int  nIDCheckButton
);

Paramètres

[in] hDlg

Type : HWND

Handle de la boîte de dialogue qui contient la case d’option.

[in] nIDFirstButton

Type : int

Identificateur de la première case d’option du groupe.

[in] nIDLastButton

Type : int

Identificateur de la dernière case d’option du groupe.

[in] nIDCheckButton

Type : int

Identificateur de la case d’option à sélectionner.

Valeur retournée

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.

Remarques

La fonction CheckRadioButton envoie un message BM_SETCHECK à chacune des cases d’option du groupe indiqué.

Les paramètres nIDFirstButton et nIDLastButton spécifient une plage d’identificateurs de bouton (normalement les ID de ressource des boutons). La position des boutons dans l’ordre de tabulation n’est pas pertinente ; si un bouton fait partie d’un groupe, mais qu’il a un ID en dehors de la plage spécifiée, il n’est pas affecté par cet appel.

Configuration requise

Condition requise Valeur
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-2 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

CheckDlgButton

IsDlgButtonChecked

Référence