Метод Graphics::SetClip(HRGN,CombineMode) (gdiplusgraphics.h)
Метод Graphics::SetClip обновляет область обрезки этого графического объекта на область, которая является сочетанием самого себя и области интерфейса графического устройства Windows (GDI).
Синтаксис
Status SetClip(
[in] HRGN hRgn,
[in] CombineMode combineMode
);
Параметры
[in] hRgn
Тип: HRGN
Дескриптор области GDI для объединения с областью обрезки этого графического объекта. Это предоставляется для устаревшего кода. Новые приложения должны передавать объект Region в качестве первого параметра.
[in] combineMode
Тип: CombineMode
Необязательный элемент. Элемент перечисления CombineMode , указывающий способ объединения области GDI с областью обрезки этого графического объекта. Значение по умолчанию — CombineModeReplace.
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .
Комментарии
Этот метод предполагает, что регион GDI, заданный hRgn , уже находится в единицах устройства, поэтому он не преобразует координаты области GDI.
Примеры
В следующем примере для обновления области обрезки используется регион GDI.
VOID Example_SetClip2(HDC hdc)
{
Graphics graphics(hdc);
// Create a Region object, and get its handle.
Region region(Rect(0, 0, 100, 100));
HRGN hRegion = region.GetHRGN(&graphics);
// Set the clipping region with hRegion.
graphics.SetClip(hRegion);
// Fill a rectangle to demonstrate the clipping region.
graphics.FillRectangle(&SolidBrush(Color(255, 0, 0, 0)), 0, 0, 500, 500);
}
Требования
| Минимальная версия клиента | Windows XP, Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | gdiplusgraphics.h (включая Gdiplus.h) |
| Библиотека | Gdiplus.lib |
| DLL | Gdiplus.dll |