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

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 .

Requisitos

Confira também

HandleMenuMsg2

IContextMenu2