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

Artigo
02/29/2024

O método PathGradientBrush::SetBlendTriangularShape define a forma de mesclagem desse pincel de gradiente de caminho.

Sintaxe

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

Parâmetros

[in] focus

Tipo: REAL

Número real que especifica onde a cor central estará em sua intensidade mais alta. Esse número deve estar no intervalo de 0 a 1.

[in, optional] scale

Tipo: REAL

Opcional. Número real que especifica a intensidade máxima da cor central que é combinada com a cor do limite. Esse número deve estar no intervalo de 0 a 1. O valor padrão é 1.

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

Por padrão, à medida que você passa do limite de um gradiente de caminho para o ponto central, a cor muda gradualmente da cor do limite para a cor central. Você pode personalizar o posicionamento e a mesclagem das cores de limite e centro chamando o método PathGradientBrush::SetBlendTriangularShape .

Exemplos

O exemplo a seguir cria um objeto PathGradientBrush com base em uma elipse. O código chama o método PathGradientBrush::SetBlendTriangularShape do objeto PathGradientBrush , passando um foco de 0,2 e uma escala de 0,7. Em seguida, o código usa o pincel de gradiente de caminho para pintar um retângulo que contém a 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	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	gdipluspath.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll