Método IMenuBand::TranslateMenuMessage (shobjidl_core.h)

  • Artigo

Converte uma mensagem para um objeto COM (Component Object Model).

Sintaxe

HRESULT TranslateMenuMessage(
  [in, out] MSG     *pmsg,
  [out]     LRESULT *plRet
);

Parâmetros

[in, out] pmsg

Tipo: MSG*

Um ponteiro para uma estrutura MSG que contém a mensagem de entrada.

[out] plRet

Tipo: LRESULT*

Um ponteiro para a mensagem traduzida.

Valor retornado

Tipo: HRESULT

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 A mensagem foi tratada e deve ser excluída.
S_FALSE
 A mensagem não foi tratada. Nesse caso, *plRet é NULL.

Comentários

Normalmente, IMenuBand::IsMenuMessage é chamado antes desse método. O proc da janela pai, não a bomba de mensagem, deve chamar IMenuBand::TranslateMenuMessage para cada mensagem.

Esse método pode alterar os valores de pmsg. Nesse caso, as alterações devem ser encaminhadas.

Esse método é necessário porque algumas bombas de mensagem modal não permitem uma chamada para um método de tradução personalizado.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll