Compartilhar via


Função HiliteMenuItem (winuser.h)

Adiciona ou remove o realce de um item em uma barra de menus.

Sintaxe

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

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela que contém o menu.

[in] hMenu

Tipo: HMENU

Um identificador para a barra de menus que contém o item.

[in] uIDHiliteItem

Tipo: UINT

O item de menu. Esse parâmetro é o identificador do item de menu ou o deslocamento do item de menu na barra de menus, dependendo do valor do parâmetro uHilite .

[in] uHilite

Tipo: UINT

Controla a interpretação do parâmetro uItemHilite e indica se o item de menu está realçado. Esse parâmetro deve ser uma combinação de MF_BYCOMMAND ou MF_BYPOSITION e MF_HILITE ou MF_UNHILITE.

Valor Significado
MF_BYCOMMAND
0x000000000L
Indica que uItemHilite fornece o identificador do item de menu.
MF_BYPOSITION
0x00000400L
Indica que uItemHilite fornece a posição relativa baseada em zero do item de menu.
MF_HILITE
0x00000080L
Realça o item de menu. Se esse sinalizador não for especificado, o realce será removido do item.
MF_UNHILITE
0x000000000L
Remove o realce do item de menu.

Valor retornado

Tipo: BOOL

Se o item de menu for definido como o estado de realce especificado, o valor retornado não será zero.

Se o item de menu não estiver definido como o estado de realce especificado, o valor retornado será zero.

Comentários

Os sinalizadores MF_HILITE e MF_UNHILITE só podem ser usados com a função HiliteMenuItem ; eles não podem ser usados com a função ModifyMenu .

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll

Confira também

Conceitual

Menus

Modifymenu

Referência