GetDlgCtrlID
Функция GetDlgCtrlID возвращает идентификатор заданного элемента управления.
int
GetDlgCtrlID
(
HWND
hwndCtl
// дескриптор элемента управления
);
Параметры
hwndCtl - идентифицирует элемент управления.
Возвращаемые значения
В случае успеха возвращается идентификатор элемента управления.
В случае неудачи возвращается
NULL
. Вызов функции также закончится неудачей при неверном значении параметра
hwndCtl
.
Комментарии
GetDlgCtrlID
также принимает в качестве параметров и дескрипторы дочерних окон, наравне с дескрипторами элементов управления в диалоговых окнах. Приложение устанавливает идентификатор для дочернего окна, присваивая значение идентификатора параметру
hMenu
при вызове функций
CreateWindow
или
CreateWindowEx
.
Хотя функция
GetDlgCtrlID
может вернуть значение в случае, если параметр
hwndCtl
идентифицирует окно верхнего уровня, такие окна не могут иметь идентификаторов и, соответственно, не будет возвращено правильного значения.
См . также
CreateWindow , CreateWindowEx , GetDlgItem .