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

Извлекает дескриптор в окно с указанным отношением (Z-Order или owner) к указанному окну.

Синтаксис

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