GetWindow

Функція GetWindow повертає дескриптор вікна, що має вказаний зв'язок (Z порядку або власника) до вказаного вікна.

(HWND GetWindow HWND  hWnd, / / ручка до початкового вікнаUINTuCmd / / відносини прапор);
 

Параметри

hWnd
Обробляти до вікна. Дескриптор вікна, отримані є по відношенню до цього вікна, на основі значення параметра uCmd.
uCmd
Визначає відносини між вказаний вікна та вікна, чиї дескриптор має будуть отримані. Цей параметр може бути одне з таких значень:
Значення Значення
GW_CHILD Процитовано ручкою ідентифікує дочірнього вікна у верхній частині z порядку, якщо вікно вказаного батьківського вікно; в іншому випадку, отримані дескриптор має значення NULL. Функція розглядає лише дочірні вікна вказаний вікна. Він не досліджував нащадком windows.
GW_ENABLEDPOPUP Windows NT 5.0 і більш пізніх: Процитовано ручкою ідентифікує включений спливаюче вікно, що належать вказаний вікна (пошук використовує перше таке вікно знайти за допомогою GW_HWNDNEXT); в іншому випадку, якщо немає доступних спливаючих вікон, отримані ручкою, що вказаний вікна.
GW_HWNDFIRST Процитовано ручкою ідентифікує вікно такого типу, що є найвищим в Z-послідовності. Якщо вікно вказаного верхнього вікна, ручка ідентифікує верхнього вікна, що є найвищим в Z-послідовності. Якщо вказаний вікно верхнього рівня вікна, ручка ідентифікує вікно верхнього рівня, що є найвищим в Z-послідовності. Якщо вікно вказаного дочірнього вікна, ручка ідентифікує вікні братом, що є найвищим в Z-послідовності.
GW_HWNDLAST Процитовано ручкою ідентифікує вікно такого типу, які є найнижчими в Z-послідовності. Якщо вікно вказаного верхнього вікна, ручка ідентифікує верхнього вікна, які є найнижчими в Z-послідовності. Якщо вказаний вікно верхнього рівня вікна, ручка ідентифікує вікно верхнього рівня, які є найнижчими в Z-послідовності. Якщо вікно вказаного дочірнього вікна, ручка ідентифікує брат вікна, які є найнижчими в Z-послідовності.
GW_HWNDNEXT Процитовано ручкою ідентифікує вікна нижче вказаний вікна в Z-послідовності. Якщо вікно вказаного верхнього вікна, ручка ідентифікує верхнього вікна нижче вказаний вікна. Якщо вказаний вікно верхнього рівня вікна, ручка ідентифікує вікно верхнього рівня нижче вказаний вікна. Якщо вікно вказаного дочірнього вікна, ручка ідентифікує брат вікна нижче вказаний вікна.
GW_HWNDPREV Процитовано ручкою ідентифікує вікна над вікно вказаного в Z-послідовності. Якщо вікно вказаного верхнього вікна, ручка ідентифікує верхнього вікна над вікно вказаного. Якщо вказаний вікно верхнього рівня вікна, ручка ідентифікує вікно верхнього рівня вище вказану вікна. Якщо вікно вказаного дочірнього вікна, ручка ідентифікує брат вікна над вказаний вікна.
GW_OWNER Процитовано ручкою ідентифікує вікно вказаного власник вікна, якщо будь-який.

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

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

Зауваження

EnumChildWindows функція є більш надійним, ніж виклик GetWindow у циклі. Застосунок, що дзвінки GetWindow для виконання цього завдання ризиків будучи пійманий до нескінченного циклу або посилання на дескриптор вікна, що був знищений.

Windows CE: У Windows CE Версія 1.0 GW_OWNER прапор значення параметра uCmd підтримується лише для діалогових вікон.

QuickInfo

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

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

Windows огляд, функції вікон, EnumChildWindows

Index