Метод IOleInPlaceSiteWindowless::OnDefWindowMessage (ocidl.h)

Статья
08/25/2023

Вызывает обработку по умолчанию для всех переданных объекту сообщений.

Синтаксис

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

Параметры

[in] msg

Идентификатор сообщения окна, предоставленного контейнеру Windows.

[in] wParam

Параметр для сообщения окна, предоставленного контейнеру Windows.

[in] lParam

Параметр для сообщения окна, предоставленного контейнеру Windows.

[out] plResult

Указатель на код результата для сообщения окна.

Возвращаемое значение

Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.

Код возврата	Описание
S_FALSE	Не было вызвана обработка контейнера по умолчанию для сообщения окна. См. примечание по реализации ниже.

Объект без окон может явно вызвать обработку сообщения окна по умолчанию, вызвав этот метод. Контейнер отправляет сообщения окна своим объектам без окон путем вызова IOleInPlaceObjectWindowless::OnWindowMessage. Объект обычно возвращает S_FALSE, чтобы указать, что сообщение не было обработано. Затем контейнер может выполнить поведение по умолчанию для сообщения, вызвав функцию DefWindowProc .

Вместо этого объект может вызвать этот метод в объекте сайта контейнера, чтобы явно вызвать обработку по умолчанию. Затем объект может выполнить действие самостоятельно, если контейнер не обрабатывает сообщение.

Примечания для разработчиков

Контейнер должен передать следующие сообщения окна в свою процедуру окна по умолчанию (функция DefWindowProc ) и вернуть S_OK. Обратите внимание, что *plResult должно содержать значение, возвращаемое 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

Контейнер может обрабатывать сообщения окна как собственные и возвращать S_OK или ничего не делать и возвращать S_FALSE.

WM_CONTEXTMENU
WM_HELP
WM_SETCURSOR

Если контейнер возвращает S_FALSE, объект может самостоятельно обработать сообщение окна.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	ocidl.h

См. также раздел

IOleInPlaceObjectWindowless::OnWindowMessage

IOleInPlaceSiteWindowless

Поделиться через