Функция SetBoundsRect контролирует накопление информации об ограничительных прямоугольниках для указанного контекста устройства. Windows может сохранять ограничительный прямоугольник для всех операций рисования. Приложение может проверить и установить этот прямоугольник. Ограничивание рисования полезно для аннулирования кэша растровых рисунков.
UINT SetBoundsRect(
HDC hdc, // дескриптор контекста устройства
CONST RECT *lprcBounds, // адрес координат прямоугольника
UINT flags // комбинация контролирующих флагов
);
Параметры:
| hdc | Определяет контектс устройства для которого накапливаются ограничительные прямоугольники. |
| lprcBounds | Адрес структуры RECT, используемой для установки ограничительного прямоугольника. Размеры прямоугольника исчисляются в логических координатах. Этот параметр может быть равен NULL. |
| flags | Определяет, как новый прямоугольник будет комбинироваться с накопленным прямоугольником. Этот параметр может быть комбинацией из следующих значений:
Значение: | Описание: |
| 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 взаимно исключимы. |
Замечания:
Значение DCB_SET является комбинацией значений битов DCB_ACCUMULATE и DCB_RESET. Приложение, которое проверяет бит DCB_RESET для определения того, что ограничительный прямоугольник пуст, должно также проверить бит DCB_ACCUMULATE. Ограничительный прямоугольник пуст, если бит DCB_RESET установлен в 1 и бит DCB_ACCUMULATE в 0.
Смотрите также:
GetBoundsRect,
RECT