Функция SetBoundsRect (wingdi.h)

Статья
08/27/2023

Функция SetBoundsRect управляет накоплением сведений ограничивающего прямоугольника для указанного контекста устройства. Система может поддерживать ограничивающий прямоугольник для всех операций рисования. Приложение может проверить и задать этот прямоугольник. Границы рисунка полезны для того, чтобы сделать кэши растровых изображений недействительными.

Синтаксис

UINT SetBoundsRect(
  [in] HDC        hdc,
  [in] const RECT *lprect,
  [in] UINT       flags
);

Параметры

[in] hdc

Дескриптор контекста устройства, для которого накапливаются ограничивающие прямоугольники.

[in] lprect

Указатель на структуру RECT, используемую для задания ограничивающего прямоугольника. Размеры прямоугольника находятся в логических координатах. Этот параметр может принимать значение NULL.

[in] 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.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll

См. также раздел

GetBoundsRect

Функции рисования и рисования

Общие сведения о рисовании и рисовании

RECT

Поделиться через