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

Cria um objeto LinearGradientBrush::LinearGradientBrush de um retângulo e ângulo de direção.

Sintaxe

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

Referência a um retângulo que especifica os pontos iniciais e finais do gradiente. O canto superior esquerdo do retângulo é o ponto de partida. O canto inferior direito é o ponto final.

[in, ref] color1

Tipo: const Color

Referência a um objeto Color que especifica a cor na linha de limite inicial desse pincel de gradiente linear.

[in, ref] color2

Tipo: const Color

Referência a um objeto Color que especifica a cor na linha de limite final desse pincel de gradiente linear.

[in] angle

Tipo: REAL

Número real que, se isAngleScalable for TRUE, especificará o ângulo base do qual o ângulo da linha direcional é calculado ou que, se isAngleScalable for FALSE, especificará o ângulo da linha direcional. O ângulo é medido a partir da parte superior do retângulo especificado por rect e deve estar em graus. O gradiente segue a linha direcional.

[in] isAngleScalable

Tipo: BOOL

Valor BOOL que especifica se o ângulo é escalonável. Se isAngleScalable for TRUE, o ângulo da linha direcional será escalonável; caso contrário, o ângulo não é escalonável.

Retornar valor

Nenhum

Comentários

A "linha direcional", uma linha reta imaginária, é definida pelo ponto inicial (canto superior esquerdo do retângulo retângulo) e pelo ângulo angular. O limite inicial do gradiente é uma linha reta que é perpendicular à linha direcional e que passa pelo ponto de partida. O limite final do gradiente é uma linha reta paralela à linha de limite inicial e que passa pelo ponto final (canto inferior direito do retângulo rect). A cor do gradiente é constante em linhas paralelas às linhas de limite. O gradiente muda gradualmente da cor inicial para a cor final ao longo da linha direcional.

Se isAngleScalable for TRUE, o ângulo base será dimensionado para produzir o ângulo da linha direcional:

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

em que ß é o novo ângulo da linha direcional; width e height são as dimensões do retângulo rect; e ø é o ângulo de ângulo base. Essa relação só será válida se o ângulo for inferior a 90 graus.

Requisitos

Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusbrush.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll

Confira também

LinearGradientBrush