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

Artículo
08/23/2023

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

Sintaxis

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

Parámetros

[in, ref] rect

Tipo: const RectF

Referencia a un rectángulo que especifica los puntos iniciales y finales del degradado. La dirección del degradado, especificada 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 de 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 que es 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 degradado es constante a lo largo de las 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 rect. Las líneas de límite inicial y final son la parte superior e inferior, respectivamente, del rectángulo rect.
Modo horizontal Las líneas de límite son paralelas a la izquierda (y derecha) del rectángulo rect. Las líneas de límite inicial y final son la izquierda y la derecha, respectivamente, del rectángulo rect.
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 rect. 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). 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 rect. 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 a través del 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.

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	gdiplusbrush.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll