Método IContextMenu3::HandleMenuMsg2 (shobjidl_core.h)

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

Sintaxe

HRESULT HandleMenuMsg2(
  UINT    uMsg,
  WPARAM  wParam,
  LPARAM  lParam,
  LRESULT *plResult
);

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 .

plResult

Tipo: LRESULT*

O endereço de um valor LRESULT que o proprietário do menu retornará da mensagem. Este parâmetro pode ser NULL.

Retornar valor

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

IContextMenu3::HandleMenuMsg2 geralmente substitui IContextMenu2::HandleMenuMsg e é chamado quando IContextMenu determina que IContextMenu3 tem suporte e uma das mensagens com suporte (consulte uMsg) foi recebida. No entanto, em alguns casos, IContextMenu2::HandleMenuMsg ainda é chamado. Os hosts de menu de contexto podem expedir mensagens de menu por meio de ambos os métodos. Consequentemente, se uma extensão shell implementar IContextMenu2::HandleMenuMsg e IContextMenu3::HandleMenuMsg2, ela deverá estar preparada para que as mensagens de menu cheguem por meio de qualquer método.

Requisitos