Metodo PathGradientBrush::SetBlendBellShape (gdipluspath.h)

Articolo
02/29/2024

Il metodo PathGradientBrush::SetBlendBellShape imposta la forma di blend di questo pennello sfumatura del percorso.

Sintassi

Status SetBlendBellShape(
  [in]           REAL focus,
  [in, optional] REAL scale
);

Parametri

[in] focus

Tipo: REAL

Numero reale che specifica dove il colore centrale sarà al massimo intensità. Questo numero deve trovarsi nell'intervallo da 0 a 1.

[in, optional] scale

Tipo: REAL

facoltativo. Numero reale che specifica l'intensità massima del colore centrale che viene mescolata con il colore limite. Questo numero deve trovarsi nell'intervallo da 0 a 1. Il valore predefinito è 1.

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

Per impostazione predefinita, quando si passa dal limite di un percorso sfumatura al punto centrale, il colore cambia gradualmente dal colore limite al colore centrale. È possibile personalizzare la posizione e la fusione dei colori del limite e del centro chiamando il metodo PathGradientBrush::SetBlendBellShape .

Esempio

Nell'esempio seguente viene creato un oggetto PathGradientBrush basato su un'ellisse. Il codice chiama il metodo PathGradientBrush::SetBlendBellShape dell'oggetto PathGradientBrush , passando uno stato attivo pari a 0,2 e una scala pari a 0,7. Il codice usa quindi il pennello sfumatura del percorso per disegnare un rettangolo contenente i puntini di sospensione.

VOID Example_SetBlendShape(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 red.
   pthGrBrush.SetCenterColor(Color(255, 255, 0, 0));

   // Set the color along the entire boundary of the path to blue.
   Color colors[] = {Color(255, 0, 0, 255)};
   INT count = 1;
   pthGrBrush.SetSurroundColors(colors, &count);

   pthGrBrush.SetBlendBellShape(0.2f, 0.7f);

   // The color is blue on the boundary and at the center.
   // At points that are 20 percent of the way from the boundary to the
   // center, the color is 70 percent red and 30 percent blue.

   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