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

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

  • Статья

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

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

Синтаксис

UINT GetBoundsRect(
  [in]  HDC    hdc,
  [out] LPRECT lprect,
  [in]  UINT   flags
);

Параметры

[in] hdc

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

[out] lprect

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

[in] flags

Указывает, как будет вести себя функция 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.

Требования

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

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

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

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

SetBoundsRect