Método PathGradientBrush::SetCenterColor (gdipluspath.h)

Artículo
02/29/2024

El método PathGradientBrush::SetCenterColor establece el color central de este pincel degradado de ruta de acceso. El color central es el color que aparece en el punto central del pincel.

Sintaxis

Status SetCenterColor(
  [in, ref] const Color & color
);

Parámetros

[in, ref] color

Tipo: color const

Referencia a un objeto Color que especifica el color central.

Valor devuelto

Tipo: Estado

Si el método se realiza 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

De forma predeterminada, el punto central es el centroide de la ruta de límite del pincel, pero puede establecer el punto central en cualquier ubicación dentro o fuera de la ruta de acceso.

Ejemplos

En el ejemplo siguiente se crea un objeto PathGradientBrush basado en una elipse. El código llama al método PathGradientBrush::SetCenterColor del objeto PathGradientBrush para establecer el color central en azul. El método PathGradientBrush::SetSurroundColors establece el color a lo largo de todo el límite en aqua. El método FillRectangle Methods usa el pincel degradado de ruta para pintar un rectángulo que contiene la elipse.

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

   // Create a path that consists of a single ellipse.
   GraphicsPath path;
   path.AddEllipse(0, 0, 200, 100);

   // Use the path to construct a brush.
   PathGradientBrush pthGrBrush(&path);

   // Set the color at the center of the path to blue.
   pthGrBrush.SetCenterColor(Color(255, 0, 0, 255));

   // Set the color along the entire boundary of the path to aqua.
   Color colors[] = {Color(255, 0, 255, 255)};
   INT count = 1;
   pthGrBrush.SetSurroundColors(colors, &count);

   graphics.FillRectangle(&pthGrBrush, 0, 0, 300, 300); 
}

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	gdipluspath.h (incluya Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll