Win32 API. Функции окна - Функция GetWindow

Written on . Posted in Win32

ОГЛАВЛЕНИЕ

Страница 36 из 69

Функция GetWindow

(ПолучитьОкно)

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

Синтаксис 

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

Параметры

hWnd
Идентифицирует окно. Отыскивает дескриптор окна, относящийся к этому окну, основанному на значении параметра uCmd.

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

  • GW_CHILD - Найденный дескриптор идентифицирует дочернее окно наверху Z - последовательности, если определяемое окно - родительское окно; иначе, найденный дескриптор значение ПУСТО (NULL).Функция проверяет только дочерние окна заданного окна. Она не проверяет окна - потомки.
  • GW_HWNDFIRST - Найденный дескриптор идентифицирует окно того же самого типа, которое является самым высоким в Z - последовательности. Если определяемое окно - самое верхнее окно, дескриптор идентифицирует самое верхнее окно, которое является самым высоким в Z - последовательности. Если определяемое окно - окно верхнего уровня, дескриптор идентифицирует окно верхнего уровня, которое является самым высоким в Z - последовательности. Если определенное окно - дочернее окно, дескриптор идентифицирует сестринское окно, которое является самым высоким в Z - последовательности.
  • GW_HWNDLAST - Найденный дескриптор идентифицирует окно того же самого типа, который является самым низким в Z - последовательности. Если определяемое окно - самое верхнее окно, дескриптор идентифицирует самое верхнее окно, которое является самым низким в Z - последовательности. Если определяемое окно - окно верхнего уровня, дескриптор идентифицирует окно верхнего уровня, которое является самым низким в Z - последовательности. Если определяемое окно - дочернее окно, дескриптор идентифицирует сестринское окно, которое является самым низким в Z - последовательности.
  • GW_HWNDNEXT - Найденный дескриптор идентифицирует окно ниже определяемого окна в Z - последовательности. Если определяемое окно - самое верхнее окно, дескриптор идентифицирует самое верхнее окно ниже определяемого окна. Если определяемое окно - окно верхнего уровня, дескриптор идентифицирует окно верхнего уровня ниже определяемого окна. Если определяемое окно - дочернее окно, дескриптор идентифицирует сестринское окно ниже определяемого окна.
  • GW_HWNDNEXT - Найденный дескриптор идентифицирует окно ниже определяемого окна в Z - последовательности. Если определяемое окно - самое верхнее окно, дескриптор идентифицирует самое верхнее окно ниже определяемого окна. Если определяемое окно - окно верхнего уровня, дескриптор идентифицирует окно верхнего уровня ниже определяемого окна. Если определяемое окно - дочернее окно, дескриптор идентифицирует сестринское окно ниже определяемого окна.
  • GW_OWNER - Найденный дескриптор идентифицирует окно владельца определяемого окна, если таковой имеется.

Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - дескриптор окна. Если окно с заданным отношением к определяемому окну не существует, возвращаемое значение - ПУСТО (NULL). Чтобы получать расширенные данные об ошибках, вызовите GetLastError.

Смотри также
GetActiveWindow, GetNextWindow, GetTopWindow

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

Windows NT			Да
Win95				Да
Win32s				Да
Импортируемая библиотека		user32.lib
Заголовочный файл			winuser.h
Unicode				Нет
Замечания по платформе		Не имеется

c++ форум