The HiliteMenuItem function highlights or removes the highlighting from an item in a menu bar.
BOOL HiliteMenuItem(
| HWND hwnd, | // handle to the window with the menu |
| HMENU hmenu, | // handle to the menu |
| UINT uItemHilite, | // menu item to highlight or unhighlight |
| UINT uHilite | // highlight flags |
| ); |
Parameters
hwnd
Identifies the window that contains the menu.
hmenu
Identifies the menu bar that contains the item to be highlighted.
uItemHilite
Specifies the menu item to be highlighted. This parameter is either the identifier of the menu item or the offset of the menu item in the menu bar, depending on the value of the uHilite parameter.
uHilite
Specifies flags that control the interpretation of the uItemHilite parameter and indicates whether the menu item is highlighted. This parameter must be a combination of either MF_BYCOMMAND or MF_BYPOSITION and MF_HILITE or MF_UNHILITE.
| Value | Meaning |
| MF_BYCOMMAND | Indicates that uItemHilite gives the identifier of the menu item. |
| MF_BYPOSITION | Indicates that uItemHilite gives the zero-based relative position of the menu item. |
| MF_HILITE | Highlights the menu item. If this flag is not specified, the highlighting is removed from the item. |
| MF_UNHILITE | Removes highlighting from the menu item. |
Return Values
If the menu item is set to the specified highlight state, the return value is nonzero.
If the menu item is not set to the specified highlight state, the return value is zero.
Remarks
The MF_HILITE and MF_UNHILITE flags can be used only with the HiliteMenuItem function; they cannot be used with the ModifyMenu function.
See Also