Metodo PathGradientBrush::GetBlend (gdipluspath.h)
Il metodo PathGradientBrush::GetBlend ottiene i fattori di blend e le posizioni di blend corrispondenti attualmente impostate per questo pennello sfumatura di percorso.
Sintassi
Status GetBlend(
[out] REAL *blendFactors,
[out] REAL *blendPositions,
[in] INT count
);
Parametri
[out] blendFactors
Tipo: REAL*
Puntatore a una matrice che riceve i fattori di blend.
[out] blendPositions
Tipo: REAL*
Puntatore a una matrice che riceve le posizioni di blend.
[in] count
Tipo: INT
Intero che specifica il numero di fattori di blend da recuperare. Prima di chiamare il metodo PathGradientBrush::GetBlend di un oggetto PathGradientBrush , chiamare il metodo PathGradientBrush::GetBlendCount dello stesso oggetto PathGradientBrush per determinare il numero corrente di fattori di blend. Il numero di posizioni di blend recuperate è uguale al numero di fattori di blend 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 .
Commenti
Un oggetto PathGradientBrush ha un percorso limite e un punto centrale. Quando si riempie un'area con un pennello sfumatura percorso, il colore viene modificato gradualmente mentre si passa dal percorso limite al punto centrale. Per impostazione predefinita, il colore è correlato in modo lineare alla distanza, ma è possibile personalizzare la relazione tra colore e distanza chiamando il metodo PathGradientBrush::SetBlend .
Esempio
Nell'esempio seguente vengono illustrati diversi metodi della classe PathGradientBrush , tra cui PathGradientBrush::SetBlend, PathGradientBrush::GetBlendCount e PathGradientBrush::GetBlend. Il codice crea un oggetto PathGradientBrush e chiama il metodo PathGradientBrush::SetBlend per stabilire un set di fattori di blend e combinare posizioni per il pennello. Il codice chiama quindi il metodo PathGradientBrush::GetBlendCount per recuperare il numero di fattori di blend. Dopo aver recuperato il numero di fattori di blend, il codice alloca due buffer: uno per ricevere la matrice di fattori di blend e uno per ricevere la matrice di posizioni di blend. Il codice chiama quindi il metodo PathGradientBrush::GetBlend per recuperare i fattori di blend e le posizioni di blend.
VOID Example_GetBlend(HDC hdc)
{
Graphics graphics(hdc);
// Create a path that consists of a single ellipse.
GraphicsPath path;
path.AddEllipse(0, 0, 200, 100);
// Use the path to construct a brush.
PathGradientBrush pthGrBrush(&path);
// Set the color at the center of the path to blue.
pthGrBrush.SetCenterColor(Color(255, 0, 0, 255));
// Set the color along the entire boundary of the path to aqua.
Color colors[] = {Color(255, 0, 255, 255)};
INT count = 1;
pthGrBrush.SetSurroundColors(colors, &count);
// Set blend factors and positions for the path gradient brush.
REAL fac[] = {
0.0f,
0.4f, // 40 percent of the way from aqua to blue
0.8f, // 80 percent of the way from aqua to blue
1.0f};
REAL pos[] = {
0.0f,
0.3f, // 30 percent of the way from the boundary to the center
0.7f, // 70 percent of the way from the boundary to the center
1.0f};
pthGrBrush.SetBlend(fac, pos, 4);
// Fill the ellipse with the path gradient brush.
graphics.FillEllipse(&pthGrBrush, 0, 0, 200, 100);
// Obtain information about the path gradient brush.
INT blendCount = pthGrBrush.GetBlendCount();
REAL* factors = new REAL[blendCount];
REAL* positions = new REAL[blendCount];
pthGrBrush.GetBlend(factors, positions, blendCount);
for(INT j = 0; j < blendCount; ++j)
{
// Inspect or use the value in factors[j].
// Inspect or use the value in positions[j].
}
delete [] factors;
delete [] positions;
}
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 | gdipluspath.h (include Gdiplus.h) |
Libreria | Gdiplus.lib |
DLL | Gdiplus.dll |
Vedi anche
Creazione di una sfumatura di percorso
Riempimento di una forma con sfumatura di colore
PathGradientBrush::GetBlendCount
PathGradientBrush::SetCenterColor
Metodi PathGradientBrush::SetCenterPoint