Функция DispatchMessage (winuser.h)

Статья
08.06.2023

Отправляет сообщение в процедуру окна. Обычно он используется для отправки сообщения, полученного функцией GetMessage .

Синтаксис

C++

LRESULT DispatchMessage(
  [in] const MSG *lpMsg
);

Параметры

[in] lpMsg

Тип: const MSG*

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

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

Тип: LRESULT

Возвращаемое значение указывает значение, возвращаемое процедурой окна. Хотя его значение зависит от отправляемого сообщения, возвращаемое значение обычно игнорируется.

Структура MSG должна содержать допустимые значения сообщений. Если параметр lpmsg указывает на сообщение WM_TIMER , а параметр lParamсообщения WM_TIMER не имеет значения NULL, lParam указывает на функцию, которая вызывается вместо процедуры окна.

Обратите внимание, что приложение отвечает за получение и отправку входных сообщений в диалоговое окно. Большинство приложений используют для этого цикл сообщений main. Однако, чтобы разрешить пользователю переходить к элементам управления и выбирать их с помощью клавиатуры, приложение должно вызвать IsDialogMessage. Дополнительные сведения см. в разделе Интерфейс клавиатуры диалогового окна.

Примеры

Пример см. в разделе Создание цикла сообщений.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-message-l1-1-0 (представлено в Windows 8)