Win32 API. Справочник по диалоговому окну
Страница 15. Функция GetDlgItem


Функция GetDlgItem

(ПолучитьЭлементДиалога)

Функция GetDlgItem извлекает дескриптор органа управления в заданном диалоговом окне.

Синтаксис

HWND GetDlgItem
(
HWND hDlg,// дескриптор диалогового окна
int nIDDlgItem// идентификатор элемента управления
);

Параметры
hDlg
Идентифицирует диалоговое окно, которое содержит орган управления.
nIDDlgItem
Определяет идентификатор элемента управления, который будет возвращен обратно.

Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - дескриптор окна данного органа управления.
Если функция не выполняет задачу, возвращаемое значение ПУСТО (NULL), который указывает на недопустимый дескриптор диалогового окна или на несуществующий элемент управления.

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

Смотри также
CreateWindow, CreateWindowEx, GetDlgItemInt, GetDlgItemText

Размещение и совместимость GetDlgItem

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотекаuser32.lib
Заголовочный файлwinuser.h
UnicodeНет
Замечания по платформеНе имеется

 

 
« Предыдущая статья   Следующая статья »