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

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

  • Статья

Функция 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