Metodo LinearGradientBrush::GetInterpolationColors (gdiplusbrush.h)

Articolo
08/23/2023

Il metodo LinearGradientBrush::GetInterpolationColors ottiene i colori attualmente impostati per essere interpolati per questo pennello sfumatura lineare e le relative posizioni di blend corrispondenti.

Sintassi

Status GetInterpolationColors(
  [out] Color *presetColors,
  [out] REAL  *blendPositions,
  [in]  INT   count
);

Parametri

[out] presetColors

Tipo: colore*

Puntatore a una matrice che riceve i colori. Un colore di un determinato indice nella matrice presetColors corrisponde alla posizione di blend dello stesso indice nella matrice blendPositions .

[out] blendPositions

Tipo: REAL*

Puntatore a una matrice che riceve le posizioni di blend. Ogni numero nella matrice indica una percentuale della distanza tra il limite iniziale e il limite finale e si trova nell'intervallo compreso tra 0,0 e 1,0, dove 0,0 indica il limite iniziale della sfumatura e 1,0 indica il limite finale. Una posizione di fusione compresa tra 0,0 e 1.0 indica una linea, parallela alle linee di limite, ovvero una determinata frazione della distanza dal limite iniziale al limite finale. Ad esempio, una posizione di blend pari a 0,7 indica la linea che corrisponde al 70% della distanza dal limite iniziale al limite finale. Il colore è costante su linee parallele alle linee di limite.

[in] count

Tipo: INT

Intero che specifica il numero di elementi nella matrice presetColors . Si tratta dello stesso numero di elementi nella matrice blendPositions . Prima di chiamare il metodo LinearGradientBrush::GetInterpolationColors di un oggetto LinearGradientBrush, chiamare il metodo LinearGradientBrush::GetInterpolationColorCount dello stesso oggetto LinearGradientBrush per determinare il numero corrente di colori. Il numero di posizioni di blend recuperate è uguale al numero di colori recuperati.

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 .

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