Método Graphics::FillRegion (gdiplusgraphics.h)

Artigo
02/29/2024

O método Graphics::FillRegion usa um pincel para preencher uma região especificada.

Sintaxe

Status FillRegion(
  [in] const Brush  *brush,
  [in] const Region *region
);

Parâmetros

[in] brush

Tipo: const Brush*

Ponteiro para um pincel que é usado para pintar a região.

[in] region

Tipo: const Region*

Ponteiro para uma região a ser preenchida.

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

Como uma região descreve um conjunto de pixels, um pixel é considerado totalmente interno ou totalmente fora da região. Consequentemente, Graphics::FillRegion não suaviza as bordas da região.

Exemplos

O exemplo a seguir cria uma região de um retângulo e preenche a região.

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

   // Create a SolidBrush object.
   SolidBrush blackBrush(Color(255, 0, 0, 0));

   // Create a Region object from a rectangle.
   Region ellipseRegion(Rect(0, 0, 200, 100));

   // Fill the region.
   graphics.FillRegion(&blackBrush, &ellipseRegion);
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusgraphics.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll