CheckMenuRadioItem-Funktion (winuser.h)
Überprüft ein angegebenes Menüelement und macht es zu einem Optionselement. Gleichzeitig löscht die Funktion alle anderen Menüelemente in der zugeordneten Gruppe und löscht das Funkelementtypflag für diese Elemente.
Syntax
BOOL CheckMenuRadioItem(
[in] HMENU hmenu,
[in] UINT first,
[in] UINT last,
[in] UINT check,
[in] UINT flags
);
Parameter
[in] hmenu
Typ: HMENU
Ein Handle für das Menü, das die Gruppe von Menüelementen enthält.
[in] first
Typ: UINT
Der Bezeichner oder die Position des ersten Menüelements in der Gruppe.
[in] last
Typ: UINT
Der Bezeichner oder die Position des letzten Menüelements in der Gruppe.
[in] check
Typ: UINT
Der Bezeichner oder die Position des zu überprüfenden Menüelements.
[in] flags
Typ: UINT
Gibt die Bedeutung von idFirst, idLast und idCheck an. Wenn dieser Parameter MF_BYCOMMAND ist, geben die anderen Parameter Menüelementbezeichner an. Wenn es MF_BYPOSITION ist, geben die anderen Parameter die Menüelementpositionen an.
Rückgabewert
Typ: BOOL
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Verwenden Sie die GetLastError-Funktion , um erweiterte Fehlerinformationen abzurufen.
Hinweise
Die CheckMenuRadioItem-Funktion legt das MFT_RADIOCHECK Typflag und den MFS_CHECKED Zustand für das durch idCheck angegebene Element fest und löscht gleichzeitig beide Flags für alle anderen Elemente in der Gruppe. Das ausgewählte Element wird mit einem Aufzählungszeichen anstelle eines Häkchenbitbits angezeigt.
Weitere Informationen zu Menüelementtyp und Statusflags finden Sie in der MENUITEMINFO-Struktur .
Beispiele
Ein Beispiel finden Sie unter Beispiel für die Verwendung von benutzerdefinierten Häkchen-Bitmaps.
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 (windows.h einschließen) |
Bibliothek | User32.lib |
DLL | User32.dll |
APIs | ext-ms-win-ntuser-menu-l1-1-0 (eingeführt in Windows 8) |
Siehe auch
Konzept
Referenz