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

Статья
11/20/2024

Отправляет сообщение указанному элементу управления в диалоговом окне.

Синтаксис

LRESULT SendDlgItemMessageA(
  [in] HWND   hDlg,
  [in] int    nIDDlgItem,
  [in] UINT   Msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

Параметры

[in] hDlg

Тип: HWND

Дескриптор диалогового окна, содержащего элемент управления.

[in] nIDDlgItem

Тип: int

Идентификатор элемента управления, получающего сообщение.

[in] Msg

Тип: UINT

Отправленное сообщение.

Списки системных сообщений см. в System-Defined сообщениях.

[in] wParam

Тип: WPARAM

Дополнительные сведения о сообщении.

[in] lParam

Тип: LPARAM

Дополнительные сведения о сообщении.

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

Тип: LRESULT

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

Замечания

Функция SendDlgItemMessage не возвращается до обработки сообщения.

Использование SendDlgItemMessage идентично получению дескриптора указанному элементу управления и вызову функции SendMessage.

Примеры

Пример см. в разделе Создание диалогового окна без режима.

Заметка

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

Требования

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

См. также

концептуальные

диалоговое окно

Справочник

SendMessage

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