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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] lpMsg

Тип: const MSG*

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

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

Тип: LRESULT

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

Замечания

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

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

Примеры

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll
набор API	ext-ms-win-ntuser-message-l1-1-0 (представлено в Windows 8)