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

Статья
03/13/2024

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

Синтаксис

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

Параметры

[in] lpMsg

Тип: const MSG*

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

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

Тип: LRESULT

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

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

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

Примеры

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

Примечание

Заголовок winuser.h определяет DispatchMessage как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	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)