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

  • Artículo

Invoca el procesamiento predeterminado para todos los mensajes pasados a un objeto.

Sintaxis

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

Parámetros

[in] msg

Identificador del mensaje de ventana proporcionado al contenedor por Windows.

[in] wParam

Parámetro para el mensaje de ventana proporcionado al contenedor por Windows.

[in] lParam

Parámetro para el mensaje de ventana proporcionado al contenedor por Windows.

[out] plResult

Puntero al código de resultado del mensaje de ventana.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto Descripción
S_FALSE
 No se invocó el procesamiento predeterminado del contenedor para el mensaje de ventana. Vea Nota para los implementadores a continuación.

Comentarios

Un objeto sin ventana puede invocar explícitamente el procesamiento predeterminado para un mensaje de ventana llamando a este método. Un contenedor envía mensajes de ventana a sus objetos sin ventana mediante una llamada a IOleInPlaceObjectWindowless::OnWindowMessage. Normalmente, el objeto devuelve S_FALSE para indicar que no procesó el mensaje. A continuación, el contenedor puede realizar el comportamiento predeterminado para el mensaje llamando a la función DefWindowProc .

En su lugar, el objeto puede llamar a este método en el objeto de sitio del contenedor para invocar explícitamente el procesamiento predeterminado. A continuación, el objeto puede tomar medidas por sí solo si el contenedor no controla el mensaje.

Notas para los implementadores

El contenedor debe pasar los siguientes mensajes de ventana a su procedimiento de ventana predeterminado (la función DefWindowProc ) y devolver S_OK. Tenga en cuenta que *plResult debe contener el valor devuelto 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
El contenedor puede procesar los mensajes de ventana como propios y devolver S_OK o no hacer nada y devolver S_FALSE.
  • WM_CONTEXTMENU
  • WM_HELP
  • WM_SETCURSOR
Si el contenedor devuelve S_FALSE, el objeto puede realizar acciones para procesar el mensaje de ventana por sí mismo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ocidl.h

Consulte también

IOleInPlaceObjectWindowless::OnWindowMessage

IOleInPlaceSiteWindowless