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

Статья
08/27/2023

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

Синтаксис

int GetDlgCtrlID(
  [in] HWND hWnd
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор элемента управления .

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

Тип: int

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

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

GetDlgCtrlID принимает дочерние дескрипторы окон, а также дескрипторы элементов управления в диалоговых окнах. Приложение задает идентификатор дочернего окна при создании окна, присваивая значение идентификатора параметру hmenu при вызове функции CreateWindow или CreateWindowEx .

Хотя GetDlgCtrlID может возвращать значение, если hwndCtl является дескриптором для окна верхнего уровня, окна верхнего уровня не могут иметь идентификаторы, и такое возвращаемое значение никогда не является допустимым.

Примеры

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

Требования


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