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

Artículo
02/26/2024

El método LinearGradientBrush::SetInterpolationColors establece los colores que se interpolan para este pincel de degradado lineal y sus posiciones de mezcla correspondientes.

Sintaxis

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

Parámetros

[in] presetColors

Tipo: color const *

Puntero a una matriz de objetos Color que especifican los colores que se van a interpolar para este pincel de degradado lineal. Un color de un índice determinado en la matriz presetColors corresponde a la posición de combinación de ese mismo índice en la matriz blendPositions .

[in] blendPositions

Tipo: const REAL*

Puntero a una matriz de números reales que especifican las posiciones de mezcla. Cada número de la matriz especifica un porcentaje de la distancia entre el límite inicial y el límite final y está en el intervalo comprendido entre 0,0 y 1,0, donde 0,0 indica el límite inicial del degradado y 1,0 indica el límite final. Debe haber al menos dos posiciones especificadas: la primera posición, que siempre es 0,0f y la última posición, que siempre es 1,0f. De lo contrario, el comportamiento no está definido. Una posición de combinación entre 0,0 y 1,0 indica la línea, paralela a las líneas de límite, que es una fracción determinada de la distancia desde el límite inicial hasta el límite final. Por ejemplo, una posición de combinación de 0,7 indica la línea que es el 70 por ciento de la distancia desde el límite inicial hasta el límite final. El color es constante en líneas paralelas a las líneas de límite.

[in] count

Tipo: INT

Entero que especifica el número de elementos de la matriz presetColors . Es el mismo que el número de elementos de la matriz blendPositions .

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusbrush.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll