CheckMenuItem-Funktion (winuser.h)

Artikel
03/15/2023
2 Minuten Lesedauer

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

Legt den Status des Häkchen-Attributs des angegebenen Menüelements entweder aktiviert oder deaktiviert fest.

Syntax

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

Parameter

[in] hMenu

Typ: HMENU

Ein Handle zum Menü des Interesses.

[in] uIDCheckItem

Typ: UINT

Das Menüelement, dessen Häkchen-Attribut festgelegt werden soll, wie durch den 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 0x000000000L	Gibt an, dass der uIDCheckItem-Parameter den Bezeichner des Menüelements erhält. Das MF_BYCOMMAND Flag ist die Standardeinstellung, wenn weder das MF_BYCOMMAND noch MF_BYPOSITION Flag angegeben wird.
MF_BYPOSITION 0x00000400L	Gibt an, dass der uIDCheckItem-Parameter die nullbasierte relative Position des Menüelements gibt.
MF_CHECKED 0x00000008L	Legt das Häkchen-Attribut auf den ausgewählten Zustand fest.
MF_UNCHECKED 0x000000000L	Legt das Häkchen-Attribut auf den klaren 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, lautet der Rückgabewert –1.

Bemerkungen

Ein Element in einer Menüleiste kann nicht über ein Häkchen verfügen.

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

Beispiele

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (enthalten Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-menu-l1-1-0 (eingeführt in Windows 8)