Возвращаемые значения
В случае успеха возвращается количество упорядоченных окон.
В случае неудачи возвращается нуль.
См. также
SMALL_RECT .
ChildWindowFromPoint
Функция ChildWindowFromPoint определяет, какое из дочерних окон, принадлежащих родительскому окну, содержит указанную точку (если таки дочерние окна существуют).
HWND ChildWindowFromPoint (
HWND hWndParent , // дескриптор родительского окна
POINT Point // структура с координатами точки
);
Параметры
hWndParent - идентифицирует родительское окно.
Point - определяет структуру типа POINT , которая содержит клиентские координаты проверяемой точки.
Возвращаемые значения
В случае успеха возвращается дескриптор дочернего окна, которое содержит точку, даже если это дочернее окно скрыто или не принимает фокус ввода ( disabled ). Если точка лежит вне родительского окна, возвращается NULL . Если точка находится внутри родительского окна, но не лежит ни в одном из дочерних окон, возвращается дескриптор родительского окна.
Комментарии
Windows ведет внутренний список, содержащий дескрипторы дочерних окон, связанных с родительским окном. Порядок дескрипторов в этом списке зависит от Z -последовательности дочерних окон. Если указанная точка содержится более чем в одном дочернем окне, Windows возвращает дескриптор первого окна в списке, содержащего точку.
См. также
ChildWindowFromPointEx, POINT, WindowFromPoint .
ChildWindowFromPointEx
Функция ChildWindowFromPointEx определяет, какое из дочерних окон, принадлежащих родительскому окну, содержит указанную точку (если таки дочерние окна существуют). Функция может игнорировать невидимые, не принимающие фокус ввода ( disabled ) и прозрачные дочерние окна.
HWND ChildWindowFromPointEx (
HWND hwndParent , // дескриптор родительского окна
POINT pt , // структура с координатами точки
UINT uFlags // флаги игнорирования
);
Параметры
hWndParent - идентифицирует родительское окно.
Point - определяет структуру типа POINT , которая содержит клиентские координаты проверяемой точки.
uFlags - определяет, какие дочерние окна будут игнорироваться. Параметр может быть комбинацией следующих значений:
|
Значение |
Пояснение |
|
CWP _ ALL |
Не игнорировать дочерние окна. |
|
CWP _ SKIPINVISIBLE |
Игнорировать невидимые дочерние окна. |
|
CWP _ SKIPDISABLED |
Игнорировать не принимающие фокус ввода дочерние окна. |
|
CWP _ SKIPTRANSPARENT |
Игнорировать прозрачные дочерние окна. |
Возвращаемые значения
В случае успеха возвращается дескриптор дочернего окна, которое содержит точку и удовлетворяет условию, определенному значением параметра uFlags . Если точка лежит вне родительского окна или вызов функции завершился неудачей, возвращается NULL . Если точка находится внутри родительского окна, но не лежит ни в одном из дочерних окон, удовлетворяющих условию, определенному значением параметра uFlags , возвращается дескриптор родительского окна.
Комментарии
Windows ведет внутренний список, содержащий дескрипторы дочерних окон, связанных с родительским окном. Порядок дескрипторов в этом списке зависит от Z -последовательности дочерних окон. Если указанная точка содержится более чем в одном дочернем окне, Windows возвращает дескриптор первого окна в списке, содержащего точку и удовлетворяющего условию, определенному значением параметра uFlags .
См. также
ChildWindowFromPoint, POINT, WindowFromPoint .
CloseWindow
Функция CloseWindow минимизирует (но не разрушает) определенное окно.
BOOL CloseWindow (
HWND hWnd // дескриптор минимизируемого окна
);
Параметры
hWnd - идентифицирует минимизируемое окно.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Окно минимизируется путем уменьшения его до размеров иконки и помещения его в область иконок над панелью задач. Windows отображает иконку окна и его заголовок вместо самого окна. Для разрушения окна приложение должно использовать функцию DestroyWindow .
См. также
ArrangeIconicWindows, DestroyWindow, IsIconic, OpenIcon .
EndDeferWindowPos
Функция EndDeferWindowPos одновременно обновляет положение и размер одного или более окон в одном цикле обновления экрана.
BOOL EndDeferWindowPos (
HDWP hWinPosInfo // дескриптор внутренней структуры
);
Параметры
hWinPosInfo - идентифицирует внутреннюю структуру, содержащую информацию о размере и положении для одного или более окон. Эта внутренняя структура возвращается функцией BeginDeferWindowPos или более ранним вызовом функции DeferWindowPos .
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Функция EndDeferWindowPos отправляет сообщения WM _ WINDOWPOSCHANGING и WM _ WINDOWPOSCHANGED каждому окну, идентифицируемому во внутренней структуре.
См. также
BeginDeferWindowPos, DeferWindowPos , WM_WINDOWPOSCHANGED, WM_WINDOWPOSCHANGING.
FindWindow
Функция FindWindow возвращает дескриптор окна верхнего уровня, чье имя класса и имя окна совпадают с заданными строками. Эта функция не ищет дочерние окна.
HWND FindWindow (
LPCTSTR lpClassName , // указатель на имя класса
LPCTSTR lpWindowName // указатель на имя окна