Функция GetWindow

Функция GetWindow извлекает дескриптор окна, который имеет определенное отношение (Z - последовательность или владелец) к заданному окну.

[in] Дескриптор окна. Извлекает дескриптор окна, относящийся к этому окну, основываясь на значении параметра uCmd.

Значение	Предназначение
GW_CHILD	Извлеченный дескриптор идентифицирует дочернее окно наверху Z - последовательности, если заданное окно - родительское окно; иначе, найденный дескриптор получит значение ПУСТО (NULL). Функция проверяет только дочерние окна заданного окна. Она не проверяет окна - потомки.
GW_ENABLEDPOPUP	Windows 2000/XP: возвращенный дескриптор идентифицирует включенное выскакивающее окно, принадлежащее заданному окну (поиск использует первый такое окно, найденное, которое использует флажок 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, чтобы выполнить эту задачу, рискует попасть в бесконечный цикл или получить ссылку на дескриптор окна, которое было разрушено.

Размещение и совместимость GetWindow
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да
Windows Me	Да
Windows 98	Да
Windows 95	Да
Используемая библиотека	User32.lib
Заголовочный файл
- объявлено в	Winuser.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется