Метод Graphics::SetClip(HRGN,CombineMode) (gdiplusgraphics.h)

Статья
08/24/2023

Метод 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 .

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