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


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

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

Синтаксис

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)

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

Основные понятия

GetMessage

IsDialogMessage

MSG

Сообщения и очереди сообщений

PeekMessage

Справочные материалы

TranslateMessage

WM_TIMER