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

Координаты оконной области окна относительны верхнего левого угла окна, а не клиентской области окна.

Для установки оконной области окна используйте функцию SetWindowRgn.

См. также

SetWindowRgn.

Функция SetRectRgnпреобразует указанную область в прямоугольную область с указанными координатами.

BOOL SetRectRgn(

HRGN hrgn , // дескриптор области

int nLeftRect , // x -координата верхнего левого угла прямоугольника

int nTopRect , // y -координата верхнего левого угла прямоугольника

int nRightRect , // x -координата нижнего правого угла прямоугольника

int nBottomRect // y -координата нижнего правого угла прямоугольника

);

Параметры

hrgn - идентифицирует область.

nLeftRect - определяет x -координату верхнего левого угла прямоугольной области.

nTopRect - определяет y -координату верхнего левого угла прямоугольной области.

nRightRect - определяет x -координату нижнего правого угла прямоугольника.

nBottomRect - определяет y -координату нижнего правого угла прямоугольника.

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

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

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

Комментарии

Область не включает в себя нижнюю и правую границы прямоугольника.

См. также

CreateRectRgn.

Функция UpdateWindowобновляет клиентскую область указанного окна, отправляя ему сообщение WM _ PAINT, если область обновления ( update region ) окна не пуста. Функция отправляет сообщение WM _ PAINT напрямую оконной процедуре указанного окна, обходя очередь сообщений приложения. Если область обновления пуста, то сообщение не отправляется.

BOOL UpdateWindow(

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

);

Параметры

hWnd - идентифицирует обновляемое окно.

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

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

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

См. также

ExcludeUpdateRgn, GetUpdateRect, GetUpdateRgn, InvalidateRect, InvalidateRgn, WM_PAINT.

Функция-ловушка ( hook procedure ) ForegroundIdleProcявляется определяемой приложением функцией обратного вызова, которую вызывает система каждый раз, когда 32-битный поток переднего плана намеревается стать неактивным.

DWORD ForegroundIdleProc(

int code , // код хука

DWORD wParam , // не используется

LONG lParam // не используется

);

Параметры

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

wParam - не используется.

lParam - не используется.

Комментарии

Приложение устанавливает функцию-ловушку, указывая в качестве типа хука WH_FOREGROUNDIDLE и передавая указатель на функцию-ловушку в функцию SetWindowsHookEx.

ForegroundIdleProcявляется "заполнителем" для имени определяемой приложением функции.

См. также

CallNextHookEx, SetWindowsHookEx

Функция UnhookWindowsHookExудаляет процедуру хука, установленную в цепочку хуков функцией SetWindowsHookEx.

BOOL UnhookWindowsHookEx(

HHOOK hhk // дескриптор удаляемой процедуры хука

);

Параметры

hhk - идентифицирует хук, подлежащий удалению. Значение этого параметра является дескриптором хука, полученным предыдущим вызовом SetWindowsHookEx.

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

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

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

Комментарии

Процедура хука может быть в состоянии вызова другим потоком даже после завершения функции UnhookWindowsHookEx. Если процедура хука не вызывается одновременно другим потоком, то она удаляется непосредственно перед завершением функции UnhookWindowsHookEx.

См. также

SetWindowsHookEx, UnhookWindowsHook.

Функция HeapSizeвозвращает размер блока памяти, выделенного из кучи функциями HeapAllocили HeapReAlloc, в байтах.

DWORD HeapSize(

HANDLE hHeap , // дескориптор кучи

DWORD dwFlags , // контрольные флаги размера кучи

LPCVOID lpMem // указатель на память, чей размер возвращается

);

Параметры

hHeap - определяет кучу, в которой находится блок памяти. Этот дескриптор возвращается функциями HeapCreateили GetProcessHeap.

dwFlags - определяет некоторые контролируемые аспекты доступа к блоку памяти. В настоящее время определен только один флаг; тем не менее, все остальные значения флагов зарезервированы для будущего использования. Указание этого флага переопределит соответствующее значение флага, указанного в качестве значения параметра flOptions при создании кучи функцией HeapCreate.

lpMem - указывает на блок памяти, чей размер функция получает. Указатель возвращается функциями HeapAllocили HeapReAlloc.

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

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

В случае неудачи возвращается 0 xFFFFFFFF . Функция не вызывает SetLastError. Приложение не может вызвать GetLastErrorдля дополнительной информации об ошибке.

См. также

GetProcessHeap, HeapAlloc, HeapCreate, HeapDestroy, HeapFree, HeapReAlloc, SetLastError.

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

HCOLORSPACE CreateColorSpace(

LPLOGCOLORSPACE lpLogColorSpace

);

Параметры

lpLogColorSpace - указывает на структуру типа LOGCOLORSPACE.

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

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

В случае неудачи возвращается NULL

Комментарии

Когда у вас больше нет необходимости в цветовом пространстве, вызовите функцию DeleteObjectдля его удаления.

См. также

DeleteObject, LOGCOLORSPACE.