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

  • Artigo

O método LinearGradientBrush::SetInterpolationColors define as cores a serem interpoladas para esse pincel de gradiente linear e suas posições de combinação correspondentes.

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 especificam as cores a serem interpoladas para esse pincel de gradiente linear. Uma cor de um determinado índice na matriz presetColors corresponde à posição de mesclagem desse mesmo índice na matriz blendPositions .

[in] blendPositions

Tipo: const REAL*

Ponteiro para uma matriz de números reais que especificam as posições de mesclagem. Cada número na matriz especifica um percentual da distância entre o limite inicial e o limite final e está no intervalo de 0,0 a 1,0, em que 0,0 indica o limite inicial do gradiente e 1,0 indica o limite final. Deve haver pelo menos duas posições especificadas: a primeira posição, que é sempre 0,0f, e a última posição, que é sempre 1,0f. Caso contrário, o comportamento será indefinido. Uma posição de mesclagem entre 0,0 e 1,0 indica a linha, paralela às linhas de limite, que é uma determinada fração da distância do limite inicial até o limite final. Por exemplo, uma posição de mesclagem de 0,7 indica a linha que é 70% da distância do limite inicial até o limite final. A cor é constante em linhas paralelas às linhas de limite.

[in] count

Tipo: INT

Inteiro que especifica o número de elementos 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 .

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

Confira também

Pincéis e formas preenchidas

Cor

Criando um gradiente linear

Preenchendo uma forma com um gradiente de cor

LinearGradientBrush

LinearGradientBrush::GetInterpolationColors