Método LinearGradientBrush::LinearGradientBrush(constPointF&,constPointF&,constColor&,constColor&) (gdiplusbrush.h)

Cria um objeto LinearGradientBrush::LinearGradientBrush de um conjunto de pontos de limite e cores de limite.

Sintaxe

void LinearGradientBrush(
  [in, ref] const PointF & point1,
  [in, ref] const PointF & point2,
  [in, ref] const Color &  color1,
  [in, ref] const Color &  color2
);

Parâmetros

[in, ref] point1

Tipo: const PointF

Referência a um objeto Point que especifica o ponto de partida do gradiente. A linha de limite inicial passa pelo ponto de partida.

[in, ref] point2

Tipo: const PointF

Referência a um objeto Point que especifica o ponto final do gradiente. A linha de limite final passa pelo 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.

Retornar valor

Nenhum

Comentários

A "linha direcional", uma linha reta imaginária, é definida pelo ponto inicial, ponto1 e o ponto final, ponto2. O limite inicial do gradiente é uma linha reta perpendicular à linha direcional e que passa pelo ponto inicial. O limite final do gradiente é uma linha reta paralela à linha de limite inicial e que passa pelo ponto final. A cor do gradiente é constante ao longo das linhas paralelas às linhas de limite. O gradiente muda gradualmente da cor inicial para a cor final ao longo da linha direcional.

Exemplos

O exemplo a seguir cria um pincel de gradiente linear de um conjunto de pontos de limite e cores de limite. Em seguida, o código usa o pincel para pintar o interior de um retângulo.

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

   LinearGradientBrush linGrBrush(
      PointF(0.8f, 1.6f),
      PointF(3.0f, 2.4f),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255));  // blue

   myGraphics.SetPageUnit(UnitInch);
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 4, 3); 
}

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

Cor

LinearGradientBrush

Rect