Функция GetWindow (winuser.h)

  • Статья

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

Синтаксис

HWND GetWindow(
  [in] HWND hWnd,
  [in] UINT uCmd
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор окна. Полученный дескриптор окна находится относительно этого окна на основе значения параметра uCmd .

[in] uCmd

Тип: UINT

Связь между указанным окном и окном, дескриптор которого требуется извлечь. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
GW_CHILD
5
 Полученный дескриптор идентифицирует дочернее окно в верхней части порядка Z, если указанное окно является родительским окном; В противном случае полученный дескриптор имеет значение NULL. Функция проверяет только дочерние окна указанного окна. Он не проверяет окна потомков.
GW_ENABLEDPOPUP
6
 Полученный дескриптор идентифицирует включенное всплывающее окно, принадлежащее указанному окну (поиск использует первое такое окно, найденное с помощью GW_HWNDNEXT); В противном случае, если нет включенных всплывающих окон, полученный дескриптор — это дескриптор указанного окна.
GW_HWNDFIRST
0
 Полученный дескриптор идентифицирует окно того же типа, которое находится на самом высоком уровне в порядке Z.

Если указанное окно является самым верхним, дескриптор идентифицирует самое верхнее окно. Если указанное окно является окном верхнего уровня, дескриптор идентифицирует окно верхнего уровня. Если указанное окно является дочерним, дескриптор идентифицирует одноуровневое окно.
GW_HWNDLAST
1
 Полученный дескриптор идентифицирует окно того же типа, которое находится на самом низком уровне в Z-порядке.

Если указанное окно является самым верхним, дескриптор идентифицирует самое верхнее окно. Если указанное окно является окном верхнего уровня, дескриптор идентифицирует окно верхнего уровня. Если указанное окно является дочерним, дескриптор идентифицирует одноуровневое окно.
GW_HWNDNEXT
2
 Полученный дескриптор идентифицирует окно под указанным окном в порядке Z.

Если указанное окно является самым верхним, дескриптор идентифицирует самое верхнее окно. Если указанное окно является окном верхнего уровня, дескриптор идентифицирует окно верхнего уровня. Если указанное окно является дочерним, дескриптор идентифицирует одноуровневое окно.
GW_HWNDPREV
3
 Полученный дескриптор идентифицирует окно над указанным окном в порядке Z.

Если указанное окно является самым верхним, дескриптор идентифицирует самое верхнее окно. Если указанное окно является окном верхнего уровня, дескриптор идентифицирует окно верхнего уровня. Если указанное окно является дочерним, дескриптор идентифицирует одноуровневое окно.
GW_OWNER
4
 Полученный дескриптор идентифицирует окно владельца указанного окна, если оно есть. Дополнительные сведения см. в разделе Принадлежащие Windows.

Возвращаемое значение

Тип: HWND

Если функция выполняется успешно, возвращаемое значение является дескриптором окна. Если окно с указанной связью с указанным окном не существует, возвращаемое значение равно NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Функция EnumChildWindows более надежна, чем вызов GetWindow в цикле. Приложение, которое вызывает GetWindow для выполнения этой задачи, рискует попасть в бесконечный цикл или ссылаться на дескриптор на окно, которое было уничтожено.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-window-l1-1-0 (представлено в Windows 8)

См. также раздел

Основные понятия

EnumChildWindows

Справочные материалы

Windows