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

Crea un oggetto LinearGradientBrush::LinearGradientBrush da un rettangolo e un angolo di direzione.

Sintassi

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

Parametri

[in, ref] rect

Tipo: const Rect

Riferimento a un rettangolo che specifica i punti iniziale e finale della sfumatura. L'angolo superiore sinistro del rettangolo è il punto iniziale. L'angolo inferiore destro è il punto finale.

[in, ref] color1

Tipo: colore const

Riferimento a un oggetto Color che specifica il colore nella linea del limite iniziale di questo pennello sfumato lineare.

[in, ref] color2

Tipo: colore const

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

[in] angle

Tipo: REAL

Numero reale che, se isAngleScalable è TRUE, specifica l'angolo di base da cui viene calcolato l'angolo della linea direzionale o che, se isAngleScalable è FALSE, specifica l'angolo della linea direzionale. L'angolo viene misurato dalla parte superiore del rettangolo specificato da rect e deve essere espresso in gradi. La sfumatura segue la linea direzionale.

[in] isAngleScalable

Tipo: BOOL

Valore BOOL che specifica se l'angolo è scalabile. Se isAngleScalable è TRUE, l'angolo della linea direzionale è scalabile; in caso contrario, l'angolo non è scalabile.

Valore restituito

nessuno

Osservazioni

La "linea direzionale", una linea retta immaginaria, è definita dal punto iniziale (angolo superiore sinistro del rettangolo) e dall'angolo dell'angolo. Il limite iniziale della sfumatura è una linea retta 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 (angolo inferiore destro del rettangolo). Il colore della sfumatura è costante lungo linee parallele alle linee limite. La sfumatura cambia gradualmente dal colore iniziale al colore finale lungo la linea direzionale.

Se isAngleScalable è TRUE, l'angolo di base viene ridimensionato per produrre l'angolo della linea direzionale:

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

dove ß è il nuovo angolo della linea direzionale; larghezza e altezza sono le dimensioni del rettangolo rect; e ø è l'angolo di base. Questa relazione è valida solo se l'angolo è inferiore a 90 gradi.

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

LinearGradientBrush