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

Artículo
08/24/2023

El método PathGradientBrush::SetBlendTriangularShape establece la forma de combinación de este pincel de degradado de trazado.

Sintaxis

Status SetBlendTriangularShape(
  [in]           REAL focus,
  [in, optional] REAL scale
);

Parámetros

[in] focus

Tipo: REAL

Número real que especifica dónde estará el color central en su intensidad más alta. Este número debe estar comprendido entre 0 y 1.

[in, optional] scale

Tipo: REAL

Opcional. Número real que especifica la intensidad máxima del color central que se mezcla con el color de límite. Este número debe estar comprendido entre 0 y 1. El valor predeterminado es 1.

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

De forma predeterminada, a medida que se mueve del límite de un degradado de trazado al punto central, el color cambia gradualmente del color del límite al color central. Puedes personalizar el posicionamiento y la combinación de los colores de límite y centro llamando al método PathGradientBrush::SetBlendTriangularShape .

Ejemplos

En el ejemplo siguiente se crea un objeto PathGradientBrush basado en una elipse. El código llama al método PathGradientBrush::SetBlendTriangularShape del objeto PathGradientBrush , pasando un foco de 0,2 y una escala de 0,7. A continuación, el código usa el pincel de degradado de ruta para pintar un rectángulo que contiene la elipse.

VOID Example_SetBlendShape(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 red.
   pthGrBrush.SetCenterColor(Color(255, 255, 0, 0));

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

   pthGrBrush.SetBlendTriangularShape(0.2f, 0.7f);

   // The color is blue on the boundary and at the center.
   // At points that are 20 percent of the way from the boundary to the
   // center, the color is 70 percent red and 30 percent blue.

   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