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

Artículo
03/14/2023

El método PathGradientBrush::SetInterpolationColors establece los colores preestablecidos y las posiciones de combinación de este pincel degradado de ruta.

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 especifica los colores de interpolación para el degradado. 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: REAL*

Puntero a una matriz que especifica las posiciones de mezcla. Cada posición de mezcla es un número comprendido entre 0 y 1, donde 0 indica el límite del degradado y 1 indica el punto central. Una posición de mezcla entre 0 y 1 especifica el conjunto de todos los puntos que son una fracción determinada de la distancia desde el límite hasta el punto central. Por ejemplo, una posición de combinación de 0,7 especifica el conjunto de todos los puntos que son el 70 por ciento del camino desde el límite hasta el punto central.

[in] count

Tipo: INT

Entero que especifica el número de objetos Color de la matriz presetColors . Es igual que el número de elementos de la matriz blendPositions .

Valor devuelto

Tipo: Estado

Si el método se realiza 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 .

Comentarios

Un pincel de degradado de trazado simple tiene dos colores: un color de límite y un color central. Al pintar con un pincel de este tipo, el color cambia gradualmente del color del límite al color central a medida que se mueve desde la ruta de acceso del límite al punto central. Puede crear un degradado más complejo especificando una matriz de colores preestablecidos y una matriz de posiciones de mezcla.

Ejemplos

En el ejemplo siguiente se crea un objeto PathGradientBrush basado en una ruta triangular. El método PathGradientBrush::SetInterpolationColors establece los colores preestablecidos del pincel en rojo, azul y aqua y establece las posiciones de mezcla en 0, 0, 4 y 1. El método Graphics::FillRectangle usa el pincel degradado de trazado para pintar un rectángulo que contiene la ruta 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	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	gdipluspath.h (incluya Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll