LinearGradientBrush::LinearGradientBrush(constRect&,constColor&,constColor&,LinearGradientMode) (gdiplusbrush.h)

Artículo
02/26/2024

Crea un objeto LinearGradientBrush::LinearGradientBrush basado en un rectángulo y modo de dirección.

Sintaxis

void LinearGradientBrush(
  [in, ref] const Rect &       rect,
  [in, ref] const Color &      color1,
  [in, ref] const Color &      color2,
  [in]      LinearGradientMode mode
);

Parámetros

[in, ref] rect

Tipo: const Rect

Referencia a un rectángulo que especifica los puntos inicial y final del degradado. La dirección del degradado, especificado por el modo, afecta a cómo se definen estos puntos. Las dimensiones del rectángulo afectan a la dirección del degradado para el modo diagonal hacia delante y hacia atrás.

[in, ref] color1

Tipo: color const

Referencia a un objeto Color que especifica el color en la línea de límite inicial de este pincel degradado lineal.

[in, ref] color2

Tipo: color const

Referencia a un objeto Color que especifica el color en la línea de límite final de este pincel de degradado lineal.

[in] mode

Tipo: LinearGradientMode

Elemento de la enumeración LinearGradientMode que especifica la dirección del degradado.

Valor devuelto

None

Observaciones

El límite inicial del degradado es una línea recta que pasa por el punto inicial o bordea el rectángulo rect. El límite final del degradado es una línea recta paralela a la línea de límite inicial y que pasa por el punto final o bordea el rectángulo. La "línea direccional", una línea recta imaginaria, es perpendicular a las líneas de límite. El color de degradado es constante a lo largo de líneas paralelas a las líneas de límite. El degradado cambia gradualmente del color inicial al color final a lo largo de la línea direccional.

El modo afecta a los límites del degradado:

Modo vertical Las líneas de límite son paralelas a la parte superior (e inferior) del rectángulo. Las líneas de límite inicial y final son la parte superior e inferior, respectivamente, del rectángulo.
Modo horizontal Las líneas de límite son paralelas a la izquierda (y a la derecha) del rectángulo. Las líneas de límite inicial y final son la izquierda y la derecha, respectivamente, del rectángulo.
Modo diagonal hacia delante Las líneas de límite son paralelas a la línea diagonal definida por la esquina superior derecha y la esquina inferior izquierda del rectángulo. La línea de límite inicial pasa por el punto inicial (esquina superior izquierda del rectángulo rect). La línea de límite final pasa por el punto final (esquina inferior derecha del rectángulo rect). Tenga en cuenta que los puntos iniciales y finales son opuestos a los puntos iniciales y finales para el modo diagonal hacia atrás.
Modo diagonal hacia atrás Las líneas de límite son paralelas a la línea diagonal definida por la esquina superior izquierda y la esquina inferior derecha del rectángulo. La línea de límite inicial pasa por el punto inicial (esquina superior derecha del rectángulo rect). La línea de límite final pasa por el punto final (esquina inferior izquierda del rectángulo rect). Tenga en cuenta que los puntos iniciales y finales son opuestos a los puntos iniciales y finales para el modo diagonal hacia delante.

Ejemplos

En el ejemplo siguiente se crea un pincel de degradado lineal mediante LinearGradientModeVertical para la configuración del modo .

VOID Example_Construct04(HDC hdc)
{
   Graphics myGraphics(hdc);

   LinearGradientBrush linGrBrush(
      Rect(20, 10, 200, 100),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255),   // blue
      LinearGradientModeVertical);
   myGraphics.FillRectangle(&linGrBrush, 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	gdiplusbrush.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll