Русский справочник по Win32 API
Шрифт:
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
Функция UpdateWindow обновляет клиентскую область указанного окна, отправляя ему сообщение WM _ PAINT, если область обновления ( update region ) окна не пуста. Функция отправляет сообщение WM _ PAINT напрямую оконной процедуре указанного окна, обходя очередь сообщений приложения. Если область обновления пуста, то сообщение не отправляется.
BOOL UpdateWindow (
HWND hWnd // дескриптор окна
);
Параметры
hWnd– идентифицирует обновляемое окно.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
См. также
ExcludeUpdateRgn, GetUpdateRect, GetUpdateRgn, InvalidateRect, InvalidateRgn , WM_PAINT.
Хуки
ForegroundIdleProc
Функция-ловушка ( hook procedure ) ForegroundIdleProc является определяемой
DWORD ForegroundIdleProc (
int code , // код хука
DWORD wParam , // не используется
LONG lParam // не используется
);
Параметры
code– определяет, должна ли функция-ловушка обработать сообщение. Если значение этого параметра HC_ACTION, то функция-ловушка должна обработать сообщение. Если значение этого параметра отрицательное, функция-ловушка должна передать сообщение функции CallNextHookEx без дальнейшей обработки и должна вернуть значение, возвращенное функцией CallNextHookEx .
wParam– не используется.
lParam– не используется.
Комментарии
Приложение устанавливает функцию-ловушку, указывая в качестве типа хука WH_FOREGROUNDIDLE и передавая указатель на функцию-ловушку в функцию SetWindowsHookEx .
ForegroundIdleProc является "заполнителем" для имени определяемой приложением функции.
См. также
CallNextHookEx, SetWindowsHookEx
UnhookWindowsHookEx
Функция UnhookWindowsHookEx удаляет процедуру хука, установленную в цепочку хуков функцией SetWindowsHookEx .
BOOL UnhookWindowsHookEx (
HHOOK hhk // дескриптор удаляемой процедуры хука
);
Параметры
hhk– идентифицирует хук, подлежащий удалению. Значение этого параметра является дескриптором хука, полученным предыдущим вызовом SetWindowsHookEx .
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
Комментарии
Процедура хука может быть в состоянии вызова другим потоком даже после завершения функции UnhookWindowsHookEx . Если процедура хука не вызывается одновременно другим потоком, то она удаляется непосредственно перед завершением функции UnhookWindowsHookEx .