Método IContextMenu2::HandleMenuMsg (shobjidl_core.h)

  • Artigo

Permite que objetos cliente da interface IContextMenu manipulem mensagens associadas a itens de menu desenhados pelo proprietário.

Sintaxe

HRESULT HandleMenuMsg(
  UINT   uMsg,
  WPARAM wParam,
  LPARAM lParam
);

Parâmetros

uMsg

Tipo: UINT

A mensagem a ser processada. No caso de algumas mensagens, como WM_INITMENUPOPUP, WM_DRAWITEM, WM_MENUCHAR ou WM_MEASUREITEM, o objeto cliente chamado pode fornecer itens de menu desenhados pelo proprietário.

wParam

Tipo: WPARAM

Informações adicionais da mensagem. O valor desse parâmetro depende do valor do parâmetro uMsg .

lParam

Tipo: LPARAM

Informações adicionais da mensagem. O valor desse parâmetro depende do valor do parâmetro uMsg .

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

IContextMenu2::HandleMenuMsg geralmente é substituído por HandleMenuMsg2. HandleMenuMsg2 é chamado quando IContextMenu determina que IContextMenu3 tem suporte e recebe uma das mensagens especificadas na descrição do parâmetro uMsg . No entanto, em alguns casos, IContextMenu2::HandleMenuMsg ainda é chamado.

Se IContextMenu2 ou IContextMenu3 for necessário, a melhor implementação para novos menus de contexto será implementar toda a lógica em HandleMenuMsg2 e ter sua implementação IContextMenu2::HandleMenuMsg simplesmente delegar a chamada para HandleMenuMsg2 e passar NULL como o parâmetro plResult .

Nota Se IContextMenu3 não for implementado, não haverá garantia de que IContextMenu2 será chamado em seu lugar. Em alguns casos, a ausência de IContextMenu3 é determinada e, em seguida, o processo é interrompido.
 

Requisitos

   
Cliente mínimo com suporte Windows XP [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 shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll (versão 4.0 ou posterior)

Confira também

HandleMenuMsg2

IContextMenu2