Функция GetWindow

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

Синтаксис

HWND GetWindow(
HWND hWnd, // дескриптор первоначального окна
UINT uCmd  // флажок отношения
);

Параметры

hWnd

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

uCmd

[in] Определяет отношение между заданным окном и окном, дескриптор которого должен быть извлечен. Этот параметр может быть одним из следующих значений:

Значение

Предназначение

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, чтобы выполнить эту задачу, рискует попасть в бесконечный цикл или получить ссылку на дескриптор окна, которое было разрушено.

Смотри также

Краткий обзор Окна, GetActiveWindow, GetNextWindow, GetTopWindow, EnumChildWindows

Размещение и совместимость GetWindow

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz