GetDlgCtrlID

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

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

Параметры

hwndCtl
Идентифицирует элемент управления.

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

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

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

Примечания

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

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

Windows CE: Идентификаторы действительны только для дочерних окон.

Идентификатор можно задать путем передачи его в качестве параметра hMenu CreateWindowEx функции. Его можно также задать и получены путем вызова SetWindowLong и GetWindowLong функций с помощью параметра nIndex равным GWL_ID.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Использование user32.lib.

Родственные слова

Диалоговое окно Обзор коробки, Box функции диалога CreateWindow CreateWindowEx, GetDlgItem

Index