На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GetUpdateRect



The GetUpdateRect function retrieves the coordinates of the smallest rectangle that completely encloses the update region of the specified window. If the window was created with the CS_OWNDC style and the mapping mode is not MM_TEXT, GetUpdateRect retrieves the rectangle in logical coordinates. Otherwise, it retrieves the rectangle in client coordinates. If there is no update region, GetUpdateRect retrieves an empty rectangle (sets all coordinates to zero).

BOOL GetUpdateRect(

HWND hWnd, // handle of window
LPRECT lpRect, // address of update rectangle coordinates
BOOL bErase // erase flag
);


Parameters

hWnd

Identifies the window with an update region that is to be retrieved.

lpRect

Points to the RECT structure that receives the coordinates of the enclosing rectangle.
An application can set this parameter to NULL to determine whether an update region exists for the window. If this parameter is NULL, GetUpdateRect returns nonzero if an update region exists, and zero if one does not. This provides a simple and efficient means of determining whether a WM_PAINT message resulted from an invalid area.

bErase

Specifies whether the background in the update region is to be erased. If this parameter is TRUE and the update region is not empty, GetUpdateRect sends a WM_ERASEBKGND message to the specified window to erase the background.



Return Values

If the update region is not empty, the return value is nonzero.
If there is no update region, the return value is zero.

Remarks

The update rectangle retrieved by the BeginPaint function is identical to that retrieved by GetUpdateRect.
BeginPaint automatically validates the update region, so any call to GetUpdateRect made immediately after the call to BeginPaint retrieves an empty update region.

See Also

BeginPaint, GetUpdateRgn, InvalidateRect, RECT, UpdateWindow, ValidateRect


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetUpdateRect



Функция GetUpdateRect извлекает координаты минимального прямоугольника, который полностью прилагает регион коррекции определенного окна. Если окно было создано стилем CS_OWNDC и отображающий способ - не MM_TEXT, GetUpdateRect извлекает прямоугольник в логические координаты. В противном случае, это извлекает прямоугольник в координаты клиента. Если нет региона коррекции, GetUpdateRect извлекает пустой прямоугольник (устанавливает все координаты в нуль).

BOOL GetUpdateRect(

HWND hWnd, // РУЧКА окна LPRECT lpRect, // адрес координат прямоугольника коррекции BOOL bErase // флаг стирания
);


Параметры

hWnd

Идентифицирует окно с регионом коррекции, который должен быть извлечен.

lpRect

Точки на структуру RECT, которые получают координаты объемлющего прямоугольника.
Приложение может установить этот параметр на НЕДЕЙСТВИТЕЛЬНЫЙ, чтобы определять существует регион коррекции для окна. Если этот параметр является НЕДЕЙСТВИТЕЛЬНЫМ, возвратом GetUpdateRect ненулевой если регион коррекции существует, и нуль если один нет. Это обеспечивает простое и эффективное средства определения происходило сообщение WM_PAINT из неправильной области.

bErase

Определяется независимо фон в регионе коррекции должно быть выстирано. Если этот параметр является ИСТИНОЙ и регион коррекции не пустой, GetUpdateRect посылает сообщение WM_ERASEBKGND в определенное окно, чтобы стирать фон.



Обратные Величины

Если регион коррекции не пустой, обратная величина ненулевая.
Если нет региона коррекции, обратная величина нулевая.

Замечания

Прямоугольник коррекции извлеченный функцией BeginPaint идентичен на который извлекался GetUpdateRect.
BeginPaint АВТОМАТИЧЕСКИ подтверждает регион коррекции, так что любой вызов на GetUpdateRect сделанным немедленно после вызова на BeginPaint извлекает пустой регион коррекции.

Смотри Также

BeginPaint, GetUpdateRgn, InvalidateRect, RECT, UpdateWindow, ValidateRect


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz