Функция SetBoundsRect управляет суммированием информации ограничивающего прямоугольника для контекста заданного устройства. Система может обслуживать ограничивающий прямоугольник для всех операций рисования. Приложение может проверить и установить этот прямоугольник. Границы рисования полезны для недействительных растровых кэшей.
UINT SetBoundsRect( HDC hdc, // дескриптор DC CONST RECT *lprcBounds, // ограничивающий прямоугольник UINT flags // комбинации опций прямоугольника ); |
[in] Дескриптор контекста устройства, для которого суммируются ограничивающие прямоугольники.
lprcBounds[in] Указатель на структуру RECT, которая используется для установки ограничивающего прямоугольника. Размеры прямоугольника находятся в логических координатах. Этот параметр может быть NULL.
flags[in] Устанавливает, как новый прямоугольник должен быть объединен с суммарным прямоугольником. Этот параметр может быть одним из нескольких нижеследующих значений.
Значение |
Описание |
|---|---|
| DCB_ACCUMULATE | Добавляет прямоугольник, определенный параметром lprcBounds для ограничивающего прямоугольника (используя операцию объединения прямоугольника). Используя флажки, и DCB_RESET, и DCB_ACCUMULATE устанавливают ограничивающий прямоугольник до прямоугольника, определенного параметром lprcBounds. |
| DCB_DISABLE | Выключает граничное суммирование. |
| DCB_ENABLE | Включает граничное суммирование, которое блокируется по умолчанию. |
| DCB_RESET | Очищает ограничивающий прямоугольник. |
Если функция завершается успешно, возвращаемое значение указывает предыдущее состояние ограничивающего прямоугольника. Это состояние может быть комбинацией нижеследующих значений.
Значение |
Предназначение |
|---|---|
| DCB_DISABLE | Граничное суммирование отключено. |
| DCB_ENABLE | Граничное суммирование включено. Флажки DCB_ENABLE и DCB_DISABLE являются взаимно исключающими. |
| DCB_RESET | Ограничивающий прямоугольник пуст. |
| DCB_SET | Ограничивающий прямоугольник не пуст. Флажки DCB_SET и DCB_RESET являются взаимно исключающими. |
Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Значение DCB_SET - комбинация битовых значений DCB_ACCUMULATE и DCB_RESET. Приложения, которые проверяют бит DCB_RESET, чтобы определить, пуст ли ограничивающий прямоугольник, должны также проверить бит DCB_ACCUMULATE. Ограничивающий прямоугольник пуст только тогда, если бит DCB_RESET установлен в 1, а бит DCB_ACCUMULATE - в 0.
Обзор Окрашивание и рисование, Функции окрашивания и рисования, GetBoundsRect, RECT
Размещение и совместимость SetBoundsRect |
||
| К | Windows Vista | Да |
| л | Windows XP | Да |
| и | Windows 2000 Professional | Да |
| е | Windows NT Workstation | Да версии 3.1 и выше |
| н | Windows Me | Да |
| т | Windows 98 | Да |
| Windows 95 | Да | |
| С | Windows Server 2008 | Да |
| е | Windows Server 2003 | Да |
| р | Windows 2000 Server | Да |
| в | Windows NT Server | Да версии 3.1 и выше |
| е | ||
| р | ||
| Используемая библиотека | Gdi32.lib | |
| Используемая DLL | - | |
| Заголовочный файл | ||
| - объявлено в | Wingdi.h | |
| - включено в | Windows.h | |
| Unicode | Нет | |
| Замечания по платформе | Не имеется | |