CheckMenuItem-Funktion (winuser.h)

[CheckMenuItem ist für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen SetMenuItemInfo. ]

Legt den Status des Häkchen-Attributs des angegebenen Menüelements auf das ausgewählte oder deaktivierte Attribut fest.

Syntax

DWORD CheckMenuItem(
  [in] HMENU hMenu,
  [in] UINT  uIDCheckItem,
  [in] UINT  uCheck
);

Parameter

[in] hMenu

Typ: HMENU

Ein Griff zum interessanten Menü.

[in] uIDCheckItem

Typ: UINT

Das Menüelement, dessen Häkchen-Attribut festgelegt werden soll, wie vom uCheck-Parameter bestimmt.

[in] uCheck

Typ: UINT

Die Flags, die die Interpretation des uIDCheckItem-Parameters und den Status des Häkchen-Attributs des Menüelements steuern. Dieser Parameter kann eine Kombination aus MF_BYCOMMAND oder MF_BYPOSITION und MF_CHECKED oder MF_UNCHECKED sein.

Wert Bedeutung
MF_BYCOMMAND
0x00000000L
 Gibt an, dass der Parameter "uIDCheckItem " den Bezeichner des Menüelements angibt. Das MF_BYCOMMAND Flag ist die Standardeinstellung, wenn weder das MF_BYCOMMAND noch das MF_BYPOSITION Flag angegeben wird.
MF_BYPOSITION
0x00000400L
 Gibt an, dass der Parameter "uIDCheckItem " die nullbasierte relative Position des Menüelements angibt.
MF_CHECKED
0x00000008L
 Legt das Häkchen-Attribut auf den ausgewählten Zustand fest.
MF_UNCHECKED
0x00000000L
 Legt das Häkchen-Attribut auf den deaktivierten Zustand fest.

Rückgabewert

Art: DWORD

Der Rückgabewert gibt den vorherigen Status des Menüelements an ( entweder MF_CHECKED oder MF_UNCHECKED). Wenn das Menüelement nicht vorhanden ist, wird der Rückgabewert UINT_MAX.

Bemerkungen

Ein Element in einer Menüleiste kann kein Häkchen aufweisen.

Der Parameter "uIDCheckItem " identifiziert ein Element, das ein Untermenü oder ein Befehlselement öffnet. Für ein Element, das ein Untermenü öffnet, muss der Parameter "uIDCheckItem " die Position des Elements angeben. Bei einem Befehlselement kann der uIDCheckItem-Parameter entweder die Position des Elements oder dessen Bezeichner angeben.

Beispiele

Ein Beispiel finden Sie unter Simulieren von Kontrollkästchen in einem Menü.

Requirements

Anforderung Wert
Mindestens unterstützter Client Windows 2000 Professional [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Header winuser.h (enthalten Windows.h)
Bibliothek User32.lib
DLL User32.dll
API-Satz ext-ms-win-ntuser-menu-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Konzeptionelle

EnableMenuItem

GetMenuItemID

Menüs

Referenz

SetMenuItemBitmaps

SetMenuItemInfo

  • Last updated on