Metodo LinearGradientBrush::LinearGradientBrush(constPointF&,constPointF&,constColor&,constColor&) (gdiplusbrush.h)

Crea un oggetto LinearGradientBrush::LinearGradientBrush da un set di punti limite e colori limite.

Sintassi

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

Parametri

[in, ref] point1

Tipo: const PointF

Riferimento a un oggetto Point che specifica il punto iniziale della sfumatura. La linea limite iniziale passa attraverso il punto iniziale.

[in, ref] point2

Tipo: const PointF

Riferimento a un oggetto Point che specifica il punto finale della sfumatura. La linea di limite finale passa attraverso il punto finale.

[in, ref] color1

Tipo: colore const

Riferimento a un oggetto Color che specifica il colore alla linea limite iniziale di questo pennello sfumatura lineare.

[in, ref] color2

Tipo: colore const

Riferimento a un oggetto Color che specifica il colore alla linea limite finale di questo pennello sfumatura lineare.

Valore restituito

nessuno

Osservazioni

La "linea direzionale", una linea retta immaginaria, è definita dal punto di partenza, dal punto1 e dal punto finale, punto2. Il limite iniziale della sfumatura è una linea retta che è perpendicolare alla linea direzionale e che passa attraverso il punto iniziale. Il limite finale della sfumatura è una linea retta parallela alla linea limite iniziale e che passa attraverso il punto finale. Il colore sfumatura è costante lungo linee parallele alle linee di limite. La sfumatura cambia gradualmente dal colore iniziale al colore finale lungo la linea direzionale.

Esempio

Nell'esempio seguente viene creato un pennello sfumatura lineare da un set di punti di limite e colori di limite. Il codice usa quindi il pennello per disegnare l'interno di un rettangolo.

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); 
}

Requisiti

Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusbrush.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll

Vedi anche

Colore

LinearGradientBrush

Rect