CWnd::HiliteMenuItem

Artikel
02/26/2013

Hervorhebungen oder entfernt die Hervorhebung von einem (Menüleisten) Menüelement der obersten Ebene.

BOOL HiliteMenuItem(
   CMenu* pMenu,
   UINT nIDHiliteItem,
   UINT nHilite 
);

Parameter

pMenu
Identifiziert das Menü der obersten Ebene, das das hervorgehoben wird Element enthält.
nIDHiliteItem
Gibt das an, je nach dem Wert des Parameters nHilite hervorgehoben wird Menüelement.
nHilite
Gibt an, ob das Menüelement hervorgehoben wird, oder die Hervorhebung entfernt wird.Es kann eine Kombination von MF_HILITE oder von MF_UNHILITE mit MF_BYCOMMAND oder MF_BYPOSITION sein.Die Werte können mithilfe des OR-Operators bitweisen kombiniert werden.Diese Werte haben folgende Bedeutung:
- MF_BYCOMMAND interpretiert nIDHiliteItem als die Menüelement ID (die Standardinterpretation).
- MF_BYPOSITION interpretiert nIDHiliteItem als nullbasierte Offset des Menüelements.
- MF_HILITE hebt das Element hervor.Wenn dieser Wert nicht angegeben ist, wird die Hervorhebung vom Element entfernt.
- MF_UNHILITE entfernt die Hervorhebung aus dem Element.

Rückgabewert

Gibt an, ob das Menüelement hervorgehoben wurde.Ungleich 0 (null), wenn das Element hervorgehoben wurde; 0 andernfalls.

Hinweise

Die MF_HILITE und MF_UNHILITE-Flags können nur mit dieser Memberfunktion verwendet werden; sie können nicht mit der CMenu::ModifyMenu-Memberfunktion verwendet werden.