Método IOleInPlaceSiteWindowless::OnDefWindowMessage (ocidl.h)

  • Artigo

Invoca o processamento padrão para todas as mensagens passadas para um objeto .

Sintaxe

HRESULT OnDefWindowMessage(
  [in]  UINT    msg,
  [in]  WPARAM  wParam,
  [in]  LPARAM  lParam,
  [out] LRESULT *plResult
);

Parâmetros

[in] msg

O identificador da mensagem de janela fornecida ao contêiner pelo Windows.

[in] wParam

Um parâmetro para a mensagem de janela fornecida ao contêiner pelo Windows.

[in] lParam

Um parâmetro para a mensagem de janela fornecida ao contêiner pelo Windows.

[out] plResult

Um ponteiro para o código de resultado da mensagem de janela.

Retornar valor

Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
S_FALSE
 O processamento padrão do contêiner para a mensagem de janela não foi invocado. Consulte Observação aos implementadores abaixo.

Comentários

Um objeto sem janelas pode invocar explicitamente o processamento padrão de uma mensagem de janela chamando esse método. Um contêiner envia mensagens de janela para seus objetos sem janela chamando IOleInPlaceObjectWindowless::OnWindowMessage. O objeto geralmente retorna S_FALSE para indicar que não processou a mensagem. Em seguida, o contêiner pode executar o comportamento padrão para a mensagem chamando a função DefWindowProc .

Em vez disso, o objeto pode chamar esse método no objeto de site do contêiner para invocar explicitamente o processamento padrão. Em seguida, o objeto poderá executar uma ação por conta própria se o contêiner não manipular a mensagem.

Observações aos implementadores

O contêiner deve passar as seguintes mensagens de janela para seu procedimento de janela padrão (a função DefWindowProc ) e retornar S_OK. Observe que *plResult deve conter o valor retornado por DefWindowProc.
  • WM_CHAR
  • WM_DEADCHAR
  • WM_IMExxx
  • WM_KEYDOWN
  • WM_KEYUP
  • WM_MOUSEMOVE
  • WM_SYSCHAR
  • WM_SYSDEADCHAR
  • WM_SYSKEYUP
  • WM_XBUTTONDOWN
  • WM_XBUTTONUP
  • WM_XBUTTONDBLCLK
O contêiner pode processar as mensagens da janela como suas próprias e retornar S_OK ou não fazer nada e retornar S_FALSE.
  • WM_CONTEXTMENU
  • WM_HELP
  • WM_SETCURSOR
Se o contêiner retornar S_FALSE, o objeto poderá executar uma ação para processar a mensagem da janela por conta própria.

Requisitos

Requisito Valor
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 ocidl.h

Confira também

IOleInPlaceObjectWindowless::OnWindowMessage

Ioleinplacesitewindowless