Metodo PathGradientBrush::SetBlendTriangularShape (gdipluspath.h)

Articolo
02/26/2024

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

Sintassi

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

Parametri

[in] focus

Tipo: REAL

Numero reale che specifica dove il colore centrale avrà la massima intensità. Questo numero deve essere compreso nell'intervallo compreso tra 0 e 1.

[in, optional] scale

Tipo: REAL

facoltativo. Numero reale che specifica l'intensità massima del colore centrale che viene combinata con il colore limite. Questo numero deve essere compreso nell'intervallo compreso tra 0 e 1. Il valore predefinito è 1.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è 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 una sfumatura di percorso al punto centrale, il colore cambia gradualmente dal colore limite al colore centrale. È possibile personalizzare il posizionamento e la fusione dei colori del limite e del centro chiamando il metodo PathGradientBrush::SetBlendTriangularShape .

Esempio

Nell'esempio seguente viene creato un oggetto PathGradientBrush basato su un'ellisse. Il codice chiama il metodo PathGradientBrush::SetBlendTriangularShape dell'oggetto PathGradientBrush , passando lo stato attivo 0,2 e una scala pari a 0,7. Il codice usa quindi il pennello sfumatura di percorso per disegnare un rettangolo che contiene l'ellisse.

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.SetBlendTriangularShape(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