CheckMenuRadioItem, fonction (winuser.h)

  • Article

Vérifie un élément de menu spécifié et en fait un élément radio. En même temps, la fonction efface tous les autres éléments de menu du groupe associé et efface l’indicateur de type d’élément radio pour ces éléments.

Syntaxe

BOOL CheckMenuRadioItem(
  [in] HMENU hmenu,
  [in] UINT  first,
  [in] UINT  last,
  [in] UINT  check,
  [in] UINT  flags
);

Paramètres

[in] hmenu

Type : HMENU

Handle du menu qui contient le groupe d’éléments de menu.

[in] first

Type : UINT

Identificateur ou position du premier élément de menu du groupe.

[in] last

Type : UINT

Identificateur ou position du dernier élément de menu du groupe.

[in] check

Type : UINT

Identificateur ou position de l’élément de menu à case activée.

[in] flags

Type : UINT

Indique la signification de idFirst, idLast et idCheck. Si ce paramètre est MF_BYCOMMAND, les autres paramètres spécifient les identificateurs d’éléments de menu. S’il est MF_BYPOSITION, les autres paramètres spécifient les positions des éléments de menu.

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’erreur étendues, utilisez la fonction GetLastError .

Remarques

La fonction CheckMenuRadioItem définit l’indicateur de type MFT_RADIOCHECK et l’état MFS_CHECKED pour l’élément spécifié par idCheck et, en même temps, efface les deux indicateurs pour tous les autres éléments du groupe. L’élément sélectionné est affiché à l’aide d’une bitmap de puces au lieu d’une bitmap de marque case activée.

Pour plus d’informations sur le type d’élément de menu et les indicateurs d’état, consultez la structure MENUITEMINFO .

Exemples

Pour obtenir un exemple, consultez Exemple d’utilisation de bitmaps de coche personnalisées.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [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-menu-l1-1-0 (introduit dans Windows 8)

Voir aussi

Conceptuel

MENUITEMINFO

Menus

Référence