Método Region::Exclude(constRect&) (gdiplusheaders.h)

Artigo
01/10/2024

O método Region::Exclude atualiza essa região para a parte de si mesma que não cruza o interior do retângulo especificado.

Sintaxe

Status Exclude(
  const Rect & rect
);

Parâmetros

rect

Referência a um retângulo a ser usado para atualizar esse objeto Region .

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Exemplos

O exemplo a seguir cria uma região de um caminho e, em seguida, usa um retângulo para atualizar a região.

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);
}