Método LinearGradientBrush::SetBlendTriangularShape (gdiplusbrush.h)

Artigo
08/23/2023

O método LinearGradientBrush::SetBlendTriangularShape define a forma de mesclagem deste pincel de gradiente linear para criar uma mistura personalizada baseada em uma forma triangular.

Sintaxe

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

Parâmetros

[in] focus

Tipo: REAL

Número real que especifica a posição da cor final. Esse número é um percentual da distância entre as linhas de limite e deve estar no intervalo de 0,0 a 1,0.

[in] scale

Tipo: REAL

Opcional. Número real que especifica a porcentagem da cor final do gradiente que é combinada, na posição de foco, com a cor inicial do gradiente. Esse número deve estar no intervalo de 0,0 a 1,0. O valor padrão é 1,0, que especifica que a cor final está em intensidade total.

Valor retornado

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, a cor muda gradualmente da cor inicial (cor no limite inicial do pincel de gradiente linear) para a cor final (cor no limite final do pincel de gradiente linear) à medida que você passa do limite inicial para o limite final. Você pode personalizar o posicionamento e a mesclagem das cores inicial e final usando o método LinearGradientBrush::SetBlendTriangularShape .

O método LinearGradientBrush::SetBlendTriangularShape personaliza a mistura para que ela siga uma forma triangular com os extremos da base do triângulo nos limites do gradiente. A cor inicial, que, em uma mistura padrão, está no limite inicial de um pincel de gradiente linear, aparece nos limites inicial e final do pincel de gradiente linear quando uma mistura em forma de triangular é aplicada. A posição da cor final, que, em uma combinação padrão, está no limite final, está em algum lugar entre os limites e é determinada pelo valor do foco. Em outras palavras, o foco especifica a posição do pico do triângulo. Por exemplo, um valor de foco de 0,5 coloca o pico no meio do caminho entre os limites inicial e final. A cor final aparece neste pico.

A cor final em uma mistura em forma triangular é uma porcentagem da gama entre a cor inicial de combinação padrão do gradiente e a cor final de combinação padrão. Por exemplo, suponha que um pincel de gradiente linear seja construído com vermelho como a cor inicial e azul como a cor final. Se LinearGradientBrush::SetBlendTriangularShape for chamado com um valor de escala de 0,3, a cor final na mistura em forma triangular será uma tonalidade de 30% entre vermelho e azul (70% vermelho, 30% azul). Um valor de escala de 1,0 produz uma cor final 100% azul.

Exemplos

O exemplo a seguir cria um pincel de gradiente linear, define uma mistura em forma de triangular e usa o pincel para preencher um retângulo. Mais duas vezes, o código define uma mistura em forma de triangular com valores diferentes e, cada vez, usa o pincel para preencher um retângulo.

VOID Example_SetBlendTri(HDC hdc)
{
   Graphics myGraphics(hdc);

   LinearGradientBrush linGrBrush(
      Point(0, 0),
      Point(500, 0),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255));  // blue

   linGrBrush.SetBlendTriangularShape(0.5f, 0.6f);
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 500, 50);

   linGrBrush.SetBlendTriangularShape(0.5f, 0.8f); 
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 500, 50);

   linGrBrush.SetBlendTriangularShape(0.5f, 1.0f); 
   myGraphics.FillRectangle(&linGrBrush, 0, 150, 500, 50);
}

Requisitos


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	gdiplusbrush.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll