CheckMenuRadioItem-Funktion (winuser.h)

  • Artikel

Ü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

MENUITEMINFO

Menüs

Referenz