Функция GetParent


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

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

Синтаксис

HWND GetParent(
    HWND hWnd
);

Параметры

hWnd

[in] Дескриптор окна, дескриптор родительского окна которого должен быть найден.

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

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

Замечания

Обратите внимание!, что, несмотря на свое имя, эта функция может возвращать окно владельца вместо родительского окна. Чтобы получить дескриптор родительского окна, а не окна владельца, используйте функцию GetAncestor с флажком GA_PARENT.

Пример

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

Смотри также

Краткий обзор Окна, GetAncestor, SetParent

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Нет

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz