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

Статья
08/27/2023

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

Синтаксис

HWND GetDlgItem(
  [in, optional] HWND hDlg,
  [in]           int  nIDDlgItem
);

Параметры

[in, optional] hDlg

Тип: HWND

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

[in] nIDDlgItem

Тип: int

Идентификатор извлекаемого элемента управления.

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

Тип: HWND

Если функция выполняется успешно, возвращаемое значение является дескриптором окна указанного элемента управления.

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

Функцию GetDlgItem можно использовать с любой парой "родитель-потомок", а не только с диалоговым окном. Если параметр hDlg указывает родительское окно, а дочернее окно имеет уникальный идентификатор (как указано в параметре hMenu в функции CreateWindow или CreateWindowEx , создающей дочернее окно), GetDlgItem возвращает допустимый дескриптор дочернему окну.

Примеры

Пример см. в разделе Инициализация диалогового окна.

Требования

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