Функция GetDlgCtrlID

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

Синтаксис

int GetDlgCtrlID(
    HWND hwndCtl
);

Параметры

hwndCtl

[in] Дескриптор органа управления.

Возвращаемое значение

Если функция завершается успешно, возвращаемое значение - идентификатор органа управления.

Если функция завершается ошибкой, возвращаемое значение равняется нулю. Недопустимое значение параметра hwndCtl, например, становится причиной того, что функция завершается ошибкой. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

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

Хотя GetDlgCtrlID может возвратить значение, если hwndCtl - дескриптор окна верхнего уровня, но окна верхнего уровня не могут иметь идентификаторов, и такое возвращаемое значение никогда не допустимо.

Пример

Пример, см. в статье Инициализация диалогового окна.

Смотри также 

Обзор Диалоговые окнаФункции, используемые диалоговыми окнами,   CreateWindowCreateWindowExGetDlgItem

Размещение и совместимость 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz