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