Region::Exclude(constRect&) メソッド (gdiplusheaders.h)

[アーティクル]
01/10/2024

Region::Exclude メソッドは、この領域を、指定した四角形の内部と交差しない部分に更新します。

構文

Status Exclude(
  const Rect & rect
);

パラメーター

rect

この Region オブジェクトを更新するために使用する四角形への参照。

戻り値

種類: 状態

メソッドが成功した場合は、 Status 列挙の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

解説

例

次の例では、パスから領域を作成し、四角形を使用して領域を更新します。

VOID Example_ExcludeRect(HDC hdc)
{
   Graphics graphics(hdc);

   Point points[] = {
      Point(110, 20),
      Point(120, 30),
      Point(100, 60),
      Point(120, 70),
      Point(150, 60),
      Point(140, 10)};

   Rect rect(65, 15, 70, 45);

   GraphicsPath path;
   SolidBrush solidBrush(Color(255, 255, 0, 0));

   path.AddClosedCurve(points, 6);

   // Create a region from a path.
   Region pathRegion(&path);

   // Exclude a rectangle from the path region.
   pathRegion.Exclude(rect);

   graphics.FillRegion(&solidBrush, &pathRegion);
}