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

  • Статья

Извлекает дескриптор предку указанного окна.

Синтаксис

HWND GetAncestor(
  [in] HWND hwnd,
  [in] UINT gaFlags
);

Параметры

[in] hwnd

Тип: HWND

Дескриптор для окна, предка которого требуется извлечь. Если этот параметр является окном рабочего стола, функция возвращает значение NULL.

[in] gaFlags

Тип: UINT

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

Значение Значение
GA_PARENT
1
 Извлекает родительское окно. Это не включает владельца, как это делается с функцией GetParent .
GA_ROOT
2
 Извлекает корневое окно путем прохода по цепочке родительских окон.
GA_ROOTOWNER
3
 Извлекает собственное корневое окно, проходя по цепочке родительских окон и окон-владельцев, возвращенных GetParent.

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

Тип: HWND

Возвращаемое значение — это дескриптор окна-предка.

Требования

   
Минимальная версия клиента 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-1 (появилось в Windows 8.1)

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

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

GetParent

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

Windows