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

Artigo
02/26/2024

O método PathGradientBrush::SetInterpolationColors define as cores predefinidas e as posições de mesclagem desse pincel de gradiente de caminho.

Sintaxe

Status SetInterpolationColors(
  [in] const Color *presetColors,
  [in] const REAL  *blendPositions,
  [in] INT         count
);

Parâmetros

[in] presetColors

Tipo: const Color*

Ponteiro para uma matriz de objetos Color que especifica as cores de interpolação para o gradiente. Uma cor de um determinado índice na matriz presetColors corresponde à posição de mesclagem desse mesmo índice na matriz blendPositions .

[in] blendPositions

Tipo: REAL*

Ponteiro para uma matriz que especifica as posições de combinação. Cada posição de combinação é um número de 0 a 1, em que 0 indica o limite do gradiente e 1 indica o ponto central. Uma posição de combinação entre 0 e 1 especifica o conjunto de todos os pontos que são uma determinada fração da distância do limite até o ponto central. Por exemplo, uma posição de combinação de 0,7 especifica o conjunto de todos os pontos que são 70% do caminho do limite para o ponto central.

[in] count

Tipo: INT

Inteiro que especifica o número de objetos Color na matriz presetColors . Isso é o mesmo que o número de elementos na matriz blendPositions .

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

Um pincel de gradiente de caminho simples tem duas cores: uma cor de limite e uma cor central. Quando você pinta com esse pincel, a cor muda gradualmente da cor do limite para a cor central à medida que você passa do caminho de limite para o ponto central. Você pode criar um gradiente mais complexo especificando uma matriz de cores predefinidas e uma matriz de posições de combinação.

Exemplos

O exemplo a seguir cria um objeto PathGradientBrush baseado em um caminho triangular. O método PathGradientBrush::SetInterpolationColors define as cores predefinidas do pincel como vermelho, azul e aqua e define as posições de combinação como 0, 0, 4 e 1. O método Graphics::FillRectangle usa o pincel de gradiente de caminho para pintar um retângulo que contém o caminho triangular.

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

   Point points[] = {Point(100, 0), Point(200, 200), Point(0, 200)};
   PathGradientBrush pthGrBrush(points, 3);

   Color col[] = {
      Color(255, 255, 0, 0),     // red
      Color(255, 0, 0, 255),     // blue
      Color(255, 0, 255, 255)};  // aqua

   REAL pos[] = {
      0.0f,    // red at the boundary
      0.4f,    // blue 40 percent of the way from the boundary to the center
      1.0f};   // aqua at the center

   pthGrBrush.SetInterpolationColors(col, pos, 3);
   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