Функция SetBoundsRect

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

Синтаксис

UINT SetBoundsRect(
  HDC hdc,                 // дескриптор DC
  CONST RECT *lprcBounds,  // ограничивающий прямоугольник
  UINT flags               // комбинации опций прямоугольника
);

Параметры

hdc

[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 Нет
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
В оглавление справки
Переведено 28.01.2011 17:09 ©Copyright V. Sokovikov
Hosted by uCoz