Функция GetDlgCtrlID извлекает идентификатор заданного органа управления.
Синтаксис
int GetDlgCtrlID( HWND hwndCtl ); |
Параметры
hwndCtl
[in] Дескриптор органа управления.Возвращаемое значение
Если функция завершается успешно, возвращаемое значение - идентификатор органа управления.
Если функция завершается ошибкой, возвращаемое значение равняется нулю. Недопустимое значение параметра hwndCtl, например, становится причиной того, что функция завершается ошибкой. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Функция GetDlgCtrlID принимает дескрипторы дочерних окон так же как и дескрипторы органов управления в диалоговых окнах. Приложение устанавливает идентификатор для дочернего окна, когда оно создает окно, присваивая значение идентификатора параметру hmenu при вызове функции CreateWindow или CreateWindowEx.
Хотя GetDlgCtrlID может возвратить значение, если hwndCtl - дескриптор окна верхнего уровня, но окна верхнего уровня не могут иметь идентификаторов, и такое возвращаемое значение никогда не допустимо.
Пример
Пример, см. в статье Инициализация диалогового окна.
Смотри также
Обзор Диалоговые окна, Функции, используемые диалоговыми окнами, CreateWindow, CreateWindowEx, GetDlgItem
|
Размещение и совместимость GetDlgCtrlID |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |