Функция _WinAPI_GetAncestor

 ↑  ←  Описание функции


_WinAPI_GetAncestor

Возвращает дескриптор предка указанного окна

#include <WinAPI.au3>
_WinAPI_GetAncestor($hWnd [, $iFlags = 1])

Параметры

$hWnd Дескриптор окна, предок которого необходимо получить. Если это окно рабочего стола, то функция возвращает 0.
$iFlags [необязательный] Определяет предок для извлечения. Этот параметр может быть одним из следующих значений:
    $GA_PARENT - Возвращает родительское окно
    $GA_ROOT - Возвращает корневое окно, проходя по цепочке родительских окон
    $GA_ROOTOWNER - Возвращает находящееся в собственности корневое окно, проходя по цепочке родительских окон и окон владельцев, возвращенных функцией GetParent.

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

Успех:Возвращает дескриптор предка окна
Ошибка:Возвращает 0

Примечания

Для выше указанных констант необходим WindowsConstants.au3

См. также

_WinAPI_GetParent

См. также

Искать GetAncestor в библиотеке MSDN

Пример

#include <WinAPI.au3>
#include <WindowsConstants.au3>

_Main()

Func _Main()
    Local $hWnd, $hParent
    $hWnd = GUICreate("Тест")
    $hParent = _WinAPI_GetAncestor($hWnd, $GA_PARENT)
    MsgBox(4096, "GetAncestor", _
        'Parent,' & @TAB & @TAB & 'возвращает предка ' & $hWnd & ': ' & $hParent & @CRLF & _
        'Root,' & @TAB & @TAB & 'возвращает предка ' & $hParent & ': ' & _WinAPI_GetAncestor($hWnd, $GA_ROOT) & @CRLF & _
        'Root Owner,' & @TAB & 'возвращает предка ' & $hParent & ': ' & _WinAPI_GetAncestor($hWnd, $GA_ROOTOWNER))
EndFunc   ;==>_Main