HiliteMenuItem-Funktion (winuser.h)

  • Artikel

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