Metodo PathGradientBrush::SetInterpolationColors (gdipluspath.h)

Articolo
08/24/2023

Il metodo PathGradientBrush::SetInterpolationColors imposta i colori predefiniti e le posizioni di blend di questo pennello sfumatura del percorso.

Sintassi

Status SetInterpolationColors(
  [in] const Color *presetColors,
  [in] const REAL  *blendPositions,
  [in] INT         count
);

Parametri

[in] presetColors

Tipo: colore* const

Puntatore a una matrice di oggetti Color che specifica i colori di interpolazione per la sfumatura. Un colore di un determinato indice nella matrice presetColors corrisponde alla posizione di blend dello stesso indice nella matrice blendPositions .

[in] blendPositions

Tipo: REAL*

Puntatore a una matrice che specifica le posizioni di blend. Ogni posizione di fusione è un numero compreso tra 0 e 1, dove 0 indica il limite della sfumatura e 1 indica il punto centrale. Una posizione di fusione compresa tra 0 e 1 specifica il set di tutti i punti che sono una determinata frazione della distanza dal limite al punto centrale. Ad esempio, una posizione di blend di 0,7 specifica il set di tutti i punti che sono il 70% del modo dal limite al punto centrale.

[in] count

Tipo: INT

Intero che specifica il numero di oggetti Color nella matrice presetColors . Si tratta dello stesso numero di elementi nella matrice blendPositions .

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Un pennello sfumatura percorso semplice ha due colori: un colore limite e un colore centrale. Quando si dipinge con tale pennello, il colore cambia gradualmente dal colore del limite al colore centrale mentre si sposta dal percorso limite al punto centrale. È possibile creare una sfumatura più complessa specificando una matrice di colori predefiniti e una matrice di posizioni di blend.

Esempio

Nell'esempio seguente viene creato un oggetto PathGradientBrush basato su un percorso triangolare. Il metodo PathGradientBrush::SetInterpolationColors imposta i colori predefiniti del pennello su rosso, blu e aqua e imposta le posizioni di blend su 0, 0, 4 e 1. Il metodo Graphics::FillRectangle usa il pennello sfumatura del percorso per disegnare un rettangolo contenente il percorso triangolare.

VOID Example_SetInterpColors(HDC hdc)
{
   Graphics graphics(hdc);

   Point points[] = {Point(100, 0), Point(200, 200), Point(0, 200)};
   PathGradientBrush pthGrBrush(points, 3);

   Color col[] = {
      Color(255, 255, 0, 0),     // red
      Color(255, 0, 0, 255),     // blue
      Color(255, 0, 255, 255)};  // aqua

   REAL pos[] = {
      0.0f,    // red at the boundary
      0.4f,    // blue 40 percent of the way from the boundary to the center
      1.0f};   // aqua at the center

   pthGrBrush.SetInterpolationColors(col, pos, 3);
   graphics.FillRectangle(&pthGrBrush, 0, 0, 300, 300);  
}

Requisiti

Requisito	Valore
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	gdipluspath.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll