LinearGradientBrush::LinearGradientBrush(constRectF&,constColor&,constColor&,REAL,BOOL) (gdiplusbrush.h)

Artículo
08/23/2023

Crea un objeto LinearGradientBrush::LinearGradientBrush a partir de un rectángulo y un ángulo de dirección.

Sintaxis

void LinearGradientBrush(
  [in, ref] const RectF & rect,
  [in, ref] const Color & color1,
  [in, ref] const Color & color2,
  [in]      REAL          angle,
  [in]      BOOL          isAngleScalable
);

Parámetros

[in, ref] rect

Tipo: const Rect

Referencia a un rectángulo que especifica los puntos inicial y final del degradado. La esquina superior izquierda del rectángulo es el punto inicial. La esquina inferior derecha es el punto final.

[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] angle

Tipo: REAL

Número real que, si isAngleScalable es TRUE, especifica el ángulo base desde el que se calcula el ángulo de la línea direccional o que, si isAngleScalable es FALSE, especifica el ángulo de la línea direccional. El ángulo se mide desde la parte superior del rectángulo especificado por rect y debe estar en grados. El degradado sigue la línea direccional.

[in] isAngleScalable

Tipo: BOOL

Valor BOOL que especifica si el ángulo es escalable. Si isAngleScalable es TRUE, el ángulo de la línea direccional es escalable; de lo contrario, el ángulo no es escalable.

Valor devuelto

None

Observaciones

La "línea direccional", una línea recta imaginaria, se define mediante el punto inicial (esquina superior izquierda del rectángulo rectángulo) y el ángulo angular. El límite inicial del degradado es una línea recta que es perpendicular a la línea direccional y que pasa por el punto inicial. 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 (esquina inferior derecha del rectángulo). 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.

Si isAngleScalable es TRUE, el ángulo base se escala para generar el ángulo de la línea direccional:

ß = arctan( (width / height) tan(ø) )

donde ß es el nuevo ángulo de la línea direccional; width y height son las dimensiones del rectángulo rect; y ø es el ángulo de ángulo base. Esta relación solo es válida si el ángulo es inferior a 90 grados.

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

Consulte también

LinearGradientBrush

Share via