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


Функция GetDlgCtrlID

(ПлучитьИдентификаторЭлементаУправленияДиалога)

Функция GetDlgCtrlID возвращает значение идентификатора заданного органа управления.

Синтаксис

int GetDlgCtrlID
(
HWND hwndCtl // дескриптор элемента управления
);

Параметры
hwndCtl
Идентифицирует орган управления.

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

Замечания
Функция GetDlgCtrlID принимает дескрипторы дочерних окон, а также дескрипторы органов управления в блоках диалога. Прикладная программа устанавливает идентификатор для дочернего окна, когда она создает окно, присваивая значение идентификатора параметру hmenu при вызове функции CreateWindow или CreateWindowEx.
Несмотря на то, что GetDlgCtrlID может возвратить значение, если hwndCtl идентифицирует окно верхнего уровня, окна верхнего уровня не могут иметь идентификаторы, и такое возвращаемое значение никогда не правильно.

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

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

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

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