Метод Graphics::GetClipBounds(Rect*) (gdiplusgraphics.h)
Метод Graphics::GetClipBounds получает прямоугольник, который заключает область обрезки этого объекта Graphics .
Синтаксис
Status GetClipBounds(
[out] Rect *rect
);
Параметры
[out] rect
Тип: Rect*
Указатель на объект Rect , который получает прямоугольник, включающий область обрезки.
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .
Комментарии
Преобразование мира применяется к области обрезки, а затем вычисляется включающий прямоугольник.
Если область обрезки объекта Graphics не задана явным образом, область обрезки будет бесконечной. Если область обрезки бесконечна, Функция Graphics::GetClipBounds возвращает большой прямоугольник. Элементы данных X и Y этого прямоугольника являются большими отрицательными числами, а элементы данных Width и Height — большими положительными числами.
Примеры
В следующем примере задается отсеченная область, получает прямоугольник, который заключает область обрезки, а затем заполняет прямоугольник.
VOID Example_GetClipBounds(HDC hdc)
{
Graphics graphics(hdc);
Region myRegion(Rect(25, 25, 100, 50));
Rect rect(40, 60, 100, 50);
Region gRegion;
Rect enclosingRect;
SolidBrush blueBrush(Color(100, 0, 0, 255));
Pen greenPen(Color(255, 0, 255, 0), 1.5f);
// Modify the region by using a rectangle.
myRegion.Union(rect);
// Set the clipping region of the graphics object.
graphics.SetClip(&myRegion);
// Now, get the clipping region, and fill it.
graphics.GetClip(&gRegion);
graphics.FillRegion(&blueBrush, &gRegion);
// Get a rectangle that encloses the clipping region, and draw the enclosing
// rectangle.
graphics.GetClipBounds(&enclosingRect);
graphics.ResetClip();
graphics.DrawRectangle(&greenPen, enclosingRect);}
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP, Windows 2000 Профессиональная [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | gdiplusgraphics.h (включая Gdiplus.h) |
| Библиотека | Gdiplus.lib |
| DLL | Gdiplus.dll |