GetDlgCtrlID

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

int GetDlgCtrlID ( HWND  hwndCtl / / ручка керування);
 

Параметри

hwndCtl
Визначає елемента керування.

Повернення значень

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

Якщо функцію не вдається, значення дорівнює нулю. Неприпустиме значення для параметра hwndCtl , наприклад, буде викликати функцію на провал. Щоб отримати докладні відомості про помилку, зателефонуйте GetLastError.

Зауваження

GetDlgCtrlID приймає ручки вікна дитини, а також ручки елементів керування в діалогових вікнах. Застосунок встановлює ідентифікатор дочірнього вікна, коли він створює вікна шляхом присвоєння значення ідентифікатора для параметра hmenu , при виклику функції CreateWindow або CreateWindowEx.

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

Windows CE: Ідентифікатори, дійсні тільки для windows дитини.

Ідентифікатор може бути встановлена шляхом передачі його в якості параметра hMenu CreateWindowEx функції. Це може бути також встановити і отримати за номером SetWindowLong і GetWindowLong функції з nIndex параметр для GWL_ID.

QuickInfo

nbsp; Windows &NT: вимагає 3.1 або пізнішої версії.
Windows:Вимагає Windows 95 або пізнішої версії.
Windows CE:Потрібна Версія 1.0 або пізнішу версію.
Заголовка:Оголошена в winuser.h.
Імпортувати бібліотеки:Використання user32.lib.

Дивіться також

Діалогове вікно огляд коробки, діалоговому вікні функції, CreateWindow, CreateWindowEx, GetDlgItem

Index