KnigaRead.com/
KnigaRead.com » Компьютеры и Интернет » Программирование » Тарас Сорока - Русский справочник по Win32 API

Тарас Сорока - Русский справочник по Win32 API

На нашем сайте KnigaRead.com Вы можете абсолютно бесплатно читать книгу онлайн Тарас Сорока, "Русский справочник по Win32 API" бесплатно, без регистрации.
Перейти на страницу:

Значение

Пояснение

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 // указатель на имя окна

);


Параметры


lpClassName - указывает на завершающуюся нулем строку, определяющую имя класса или атом, идентифицирующий строку имени класса. Если этот параметр является атомом, то он должен быть глобальным атомом, созданным предыдущим вызовом функции GlobalAddAtom . 16-ти битное значение атома должно быть размещено в младшем слове lpClassName , старшее слово должно быть равно нулю.

lpWindowName - указывает на завершающуюся нулем строку, определяющую имя окна (заголовок окна). Если значение этого параметра равно NULL, то со значением lpWindowName совпадают имена всех окон.


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


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


См . также


EnumWindows, FindWindowEx, GetClassName, GlobalAddAtom .


FindWindowEx


Функция FindWindowEx извлекает дескриптор окна, чье имя класса и имя окна совпадают с указанными строками. Функция также просматривает дочерние окна, начиная с того, дескриптор которого передан функции в качестве параметра hwndChildAfter .


HWND FindWindowEx (


HWND hwndParent , // дескриптор родительского окна

HWND hwndChildAfter , // дескриптор дочернего окна

LPCTSTR lpszClass , // указатель на имя класса

LPCTSTR lpszWindow // указатель на имя окна

);


Параметры


hwndParent - идентифицирует родительское окно, среди дочерних окон которого будет проводиться поиск.

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

hwndChildAfter - идентифицирует дочернее окно. Поиск начинается со следующего окна в Z- последовательности. Окно, указанное параметром hwndChildAfter , должно быть прямым дочерним окном указанного параметром hwndParent окна, а не порожденным окном.

Если значение параметра hwndChildAfter равно NULL, поиск начинается с первого дочернего окна.

Примечание: Если значения обоих параметров hwndParent и hwndChildAfter равны NULL, функция проводит поиск среди всех окон верхнего уровня.

lpszClass - указывает на завершающуюся нулем строку, определяющую имя класса или атом, идентифицирующий строку - имя класса. Если этот параметр является атомом, он должен быть глобальным атомом, созданным предыдущим вызовом функции GlobalAddAtom . Значение атома должно быть помещено в младшее слово lpszClass , старшее слово должно быть равно нулю.

lpszWindow - указывает на завершающуюся нулем строку, определяющую имя окна (заголовок окна). Если значение этого параметра равно NULL, то совпадающими со строкой считаются все имена окон.


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


В случае успеха возвращается дескриптор окна, которое имеет заданные имя класса и имя окна.

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


См. также


EnumWindows, FindWindow, GetClassName, GlobalAddAtom .


GetClientRect


Функция GetClientRect возвращает координаты клиентской области окна. Клиентские координаты определяют верхний левый и правый нижний углы клиентской области. Поскольку клиентские координаты относительны левого угла клиентской области окна, то координатой верхнего левого угла является (0, 0).


BOOL GetClientRect (


HWND hWnd // дескриптор окна

LPRECT lpRect // адрес структуры для клиентских координат

);


Параметры


hWnd - идентифицирует окно, клиентские координаты которого возвращаются.

lpRect - указывает на структуру, получающую клиентские координаты. Члены left и top равны нулю. Члены right и bottom содержат ширину и высоту окна.


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


В случае успеха возвращается ненулевое значение.

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


См . также


GetWindowRect, RECT.


SetWindowText


Функция SetWindowText изменяет текст заголовка (если заголовок существует) указанного окна. Если указанное окно является элементом управления, то изменяется текст этого элемента управления.


BOOL SetWindowText (


HWND hWnd , // дескриптор окна или элемента управления

Перейти на страницу:
Прокомментировать
Подтвердите что вы не робот:*