Функция GetWindow (winuser.h)
Извлекает дескриптор в окно с указанным отношением (Z-Order или owner) к указанному окну.
Синтаксис
HWND GetWindow(
[in] HWND hWnd,
[in] UINT uCmd
);
Параметры
[in] hWnd
Тип: HWND
Дескриптор окна. Полученный дескриптор окна относится к этому окну на основе значения параметра uCmd .
[in] uCmd
Тип: UINT
Связь между указанным окном и окном, дескриптор которого требуется извлечь. Этот параметр может принимать одно из указанных ниже значений.
| Значение | Значение |
|---|---|
|
Полученный дескриптор определяет дочернее окно в верхней части порядка Z, если указанное окно является родительским окном; в противном случае полученный дескриптор имеет значение NULL. Функция проверяет только дочерние окна указанного окна. Он не проверяет окна потомков. |
|
Полученный дескриптор определяет включенное всплывающее окно, принадлежаемое указанному окну (поиск использует первое такое окно, найденное с помощью GW_HWNDNEXT); В противном случае, если всплывающих окон не включено, извлекаемый дескриптор является дескриптором указанного окна. |
|
Полученный дескриптор определяет окно того же типа, что и в порядке Z.
Если указанное окно является самым верхним окном, дескриптор определяет самое верхнее окно. Если указанное окно является окном верхнего уровня, дескриптор определяет окно верхнего уровня. Если указанное окно является дочерним окном, дескриптор определяет одноуровневое окно. |
|
Полученный дескриптор определяет окно того же типа, что и в порядке Z.
Если указанное окно является самым верхним окном, дескриптор определяет самое верхнее окно. Если указанное окно является окном верхнего уровня, дескриптор определяет окно верхнего уровня. Если указанное окно является дочерним окном, дескриптор определяет одноуровневое окно. |
|
Полученный дескриптор определяет окно под указанным окном в порядке Z.
Если указанное окно является самым верхним окном, дескриптор определяет самое верхнее окно. Если указанное окно является окном верхнего уровня, дескриптор определяет окно верхнего уровня. Если указанное окно является дочерним окном, дескриптор определяет одноуровневое окно. |
|
Полученный дескриптор определяет окно над указанным окном в порядке Z.
Если указанное окно является самым верхним окном, дескриптор определяет самое верхнее окно. Если указанное окно является окном верхнего уровня, дескриптор определяет окно верхнего уровня. Если указанное окно является дочерним окном, дескриптор определяет одноуровневое окно. |
|
Полученный дескриптор определяет окно владельца указанного окна, если таковое есть. Дополнительные сведения см. в разделе "Принадлежащие 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) |
См. также раздел
Основные понятия
Справочные материалы