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

Artigo
08/23/2023

O método LinearGradientBrush::GetInterpolationColors obtém as cores atualmente definidas para serem interpoladas para esse pincel de gradiente linear e suas posições de combinação correspondentes.

Sintaxe

Status GetInterpolationColors(
  [out] Color *presetColors,
  [out] REAL  *blendPositions,
  [in]  INT   count
);

Parâmetros

[out] presetColors

Tipo: Cor*

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

[out] blendPositions

Tipo: REAL*

Ponteiro para uma matriz que recebe as posições de mesclagem. Cada número na matriz indica 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. Uma posição de mesclagem entre 0,0 e 1,0 indica uma 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 . Antes de chamar o método LinearGradientBrush::GetInterpolationColors de um objeto LinearGradientBrush , chame o método LinearGradientBrush::GetInterpolationColorCount do mesmo objeto LinearGradientBrush para determinar o número atual de cores. O número de posições de mesclagem recuperadas é o mesmo que o número de cores recuperadas.

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 .

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