CheckMenuItem-Funktion (winuser.h)

Artikel
08/27/2023

[CheckMenuItem ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. 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 auf ausgewählt oder clear fest.

Syntax

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

Parameter

[in] hMenu

Typ: HMENU

Ein Handle für das menü von Interesse.

[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 Zustand 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 uIDCheckItem-Parameter den Bezeichner des Menüelements angibt. Das MF_BYCOMMAND-Flag ist die Standardeinstellung, wenn weder das MF_BYCOMMAND - noch MF_BYPOSITION-Flag angegeben ist.
MF_BYPOSITION 0x00000400L	Gibt an, dass der uIDCheckItem-Parameter 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 clear-Zustand fest.

Rückgabewert

Art: DWORD

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

Hinweise

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

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 oder den Bezeichner des Elements 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 (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-menu-l1-1-0 (in Windows 8 eingeführt)