Функция GetBoundsRect

Функция GetBoundsRect получает текущий суммарный ограничивающий прямоугольник для заданного контекста устройства.

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

Синтаксис

UINT GetBoundsRect(
  HDC hdc,            // дескриптор контекста устройства
  LPRECT lprcBounds,  // ограничивающий прямоугольник
  UINT flags          // опции функции
);

Параметры

hdc

[in] Дескриптор контекста устройства, ограничивающий прямоугольник которому функция возвращает.

lprcBounds

[out] Указатель на структуру RECT, которая получит текущий ограничивающий прямоугольник. Прямоугольник приложения возвращается в логических координатах, а ограничивающий прямоугольник возвращается в экранных координатах.

flags

[in] Определяет, как функция GetBoundsRect будет вести себя. Этот параметр может быть нижеследующим значением.

Значение

Предназначение

DCB_RESET Очищает ограничивающий прямоугольник после его возвращения. Если этот флажок не установлен, то ограничивающий прямоугольник не будет очищен.


Возвращаемые значения

Возвращаемое значение устанавливает состояние суммарного ограничивающего прямоугольника; это может быть одно из ниже перечисленных значений.

Значение

Предназначение

0 Произошла ошибка. Дескриптор контекста указанного устройства недопустим.
DCB_DISABLE Суммирование граничных прямоугольников отключено.
DCB_ENABLE Суммирование граничных прямоугольников включено.
DCB_RESET Ограничивающий прямоугольник пуст.
DCB_SET Ограничивающий прямоугольник не пуст.

Замечания

Значение DCB_SET - комбинация битовых значений DCB_ACCUMULATE и DCB_RESET. Приложения, которые проверяют бит DCB_RESET, чтобы определить пуст ли ограничивающий прямоугольник, должны также проверить бит DCB_ACCUMULATE. Ограничивающий прямоугольник пуст только тогда, если, бит DCB_RESET 1, а бит DCB_ACCUMULATE 0.

Смотри также

Обзор Окрашивание и рисование, Функции окрашивания и рисования, SetBoundsRect

Размещение и совместимость GetBoundsRect

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

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz