Win32 API. Справочник по диалоговому окну - Функция 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 Нет
Замечания по платформе Не имеется