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

Artículo
02/26/2024

El método Graphics::FillRegion usa un pincel para rellenar una región especificada.

Sintaxis

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

Parámetros

[in] brush

Tipo: pincel* const

Puntero a un pincel que se usa para pintar la región.

[in] region

Tipo: const Region*

Puntero a una región que se va a rellenar.

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Dado que una región describe un conjunto de píxeles, un píxel se considera completamente dentro o totalmente fuera de la región. Por lo tanto, Graphics::FillRegion no suaviza los bordes de la región.

Ejemplos

En el ejemplo siguiente se crea una región a partir de un rectángulo y, a continuación, se rellena la región.

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	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll