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