HiliteMenuItem-Funktion (winuser.h)

Fügt einem Element in einer Menüleiste Hervorhebungen hinzu oder entfernt sie.

Syntax

BOOL HiliteMenuItem(
  [in] HWND  hWnd,
  [in] HMENU hMenu,
  [in] UINT  uIDHiliteItem,
  [in] UINT  uHilite
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster, das das Menü enthält.

[in] hMenu

Typ: HMENU

Ein Handle für die Menüleiste, die das Element enthält.

[in] uIDHiliteItem

Typ: UINT

Das Menüelement. Dieser Parameter ist entweder der Bezeichner des Menüelements oder der Offset des Menüelements in der Menüleiste, abhängig vom Wert des uHilite-Parameters .

[in] uHilite

Typ: UINT

Steuert die Interpretation des uItemHilite-Parameters und gibt an, ob das Menüelement hervorgehoben ist. Dieser Parameter muss eine Kombination aus MF_BYCOMMAND oder MF_BYPOSITION und MF_HILITE oder MF_UNHILITE sein.

Wert	Bedeutung
MF_BYCOMMAND 0x00000000L	Gibt an, dass uItemHilite den Bezeichner des Menüelements angibt.
MF_BYPOSITION 0x00000400L	Gibt an, dass uItemHilite die nullbasierte relative Position des Menüelements angibt.
MF_HILITE 0x00000080L	Hebt das Menüelement hervor. Wenn dieses Flag nicht angegeben ist, wird die Hervorhebung aus dem Element entfernt.
MF_UNHILITE 0x00000000L	Entfernt hervorhebungen aus dem Menüelement.

Rückgabewert

Typ: BOOL

Wenn das Menüelement auf den angegebenen Hervorhebungszustand festgelegt ist, ist der Rückgabewert ungleich null.

Wenn das Menüelement nicht auf den angegebenen Hervorhebungszustand festgelegt ist, ist der Rückgabewert null.

Hinweise

Die flags MF_HILITE und MF_UNHILITE können nur mit der Funktion HiliteMenuItem verwendet werden. sie können nicht mit der ModifyMenu-Funktion verwendet werden.

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

Siehe auch

Konzept

Menüs

ModifyMenu

Referenz