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

Статья
08/27/2023

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

Чтобы получить дескриптор указанного предка, используйте функцию GetAncestor .

Синтаксис

HWND GetParent(
  [in] HWND hWnd
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор для окна, родительский дескриптор окна которого требуется извлечь.

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

Тип: HWND

Если окно является дочерним, возвращаемое значение является дескриптором родительского окна. Если окно является окном верхнего уровня со стилем WS_POPUP , возвращаемое значение является дескриптором для окна-владельца.

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

Обычно эта функция завершается сбоем по одной из следующих причин:

Это окно верхнего уровня, которое не является хозяйкой или не имеет стиля WS_POPUP .
Окно владельца имеет WS_POPUP стиле.

Чтобы получить окно владельца окна, вместо использования GetParent используйте GetWindow с флагом GW_OWNER . Чтобы получить родительское окно, а не владельца, вместо использования GetParent используйте GetAncestor с флагом GA_PARENT .

Примеры

Пример см. в разделе Инициализация диалогового окна.

Требования

Требование	Значение
Минимальная версия клиента	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)