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

Artículo
08/24/2023

El método PathGradientBrush::SetSurroundColors establece los colores envolventes de este pincel de degradado de ruta de acceso. Los colores envolventes son colores especificados para puntos discretos en la ruta de límite del pincel.

Sintaxis

Status SetSurroundColors(
  [in]      const Color *colors,
  [in, out] INT         *count
);

Parámetros

[in] colors

Tipo: color const *

Puntero a una matriz de objetos Color que especifican los colores envolventes.

[in, out] count

Tipo: INT*

Puntero a un entero que, en la entrada, especifica el número de objetos Color de la matriz colors . Si el método se ejecuta correctamente, este parámetro, en la salida, recibe el número de colores envolventes establecidos. Si se produce un error en el método, este parámetro no recibe un valor.

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 tiene un trazado de límite y un punto central. El punto central se establece en un solo color, pero puede especificar colores diferentes para varios puntos en el límite. Por ejemplo, supongamos que especifica rojo para el color central y especifica azul, verde y amarillo para puntos distintos en el límite. A medida que se mueve a lo largo del límite, el color cambiará gradualmente de azul a verde a amarillo y de vuelta a azul. A medida que se mueve a lo largo de una línea recta desde cualquier punto del límite al punto central, el color cambiará del color de ese punto de límite a rojo.

Ejemplos

En el ejemplo siguiente se crea un objeto PathGradientBrush basado en una matriz de tres puntos que define una ruta triangular. El código también inicializa una matriz de tres objetos Color . La llamada al método PathGradientBrush::SetSurroundColors asocia cada color de la matriz de colores con el punto correspondiente (mismo índice) de la matriz de puntos. Después de establecer los colores envolventes del pincel de degradado de trazado, el método Graphics::FillRectangle usa el pincel degradado de trazado para pintar un rectángulo que incluya el trazado triangular.

Un borde del triángulo representado cambia gradualmente de rojo a verde. El siguiente borde cambia gradualmente de verde a negro y el tercer borde cambia gradualmente de negro a rojo. El código no establece el color central, por lo que el color central tiene el valor predeterminado de negro. A medida que se mueve a lo largo de una línea recta desde cualquier punto de la ruta de acceso del límite (triángulo) al punto central, el color cambia gradualmente de ese punto de límite a negro.

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

   Point pts[] = {
      Point(20, 20), 
      Point(100, 20), 
      Point(100, 100)};

   Color cols[] = {
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 255, 0),  // green
      Color(255, 0, 0, 0)};   // black

   INT count = 3;
   PathGradientBrush pthGrBrush(pts, 3);
   pthGrBrush.SetSurroundColors(cols, &count);
   
   graphics.FillRectangle(&pthGrBrush, 0, 0, 200, 200);
}

Requisitos


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