Metodo PathGradientBrush::SetFocusScales (gdipluspath.h)

Articolo
08/24/2023

Il metodo PathGradientBrush::SetFocusScales imposta le scale dello stato attivo del pennello sfumatura del percorso.

Sintassi

Status SetFocusScales(
  [in] REAL xScale,
  [in] REAL yScale
);

Parametri

[in] xScale

Tipo: REAL

Numero reale che specifica la scala dello stato attivo x.

[in] yScale

Tipo: REAL

Numero reale che specifica la scala dello stato attivo y.

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, il colore centrale di una sfumatura del percorso è al punto centrale. Chiamando PathGradientBrush::SetFocusScales, è possibile specificare che il colore centrale deve essere visualizzato lungo un percorso che circonda il punto centrale. Questo percorso è il percorso limite ridimensionato da un fattore di xScale nella direzione x e da un fattore di yScale nella direzione y. L'area all'interno del percorso ridimensionato viene riempita con il colore centrale.

Esempio

Nell'esempio seguente viene creato un oggetto PathGradientBrush basato su un percorso triangolare. Il codice chiama il metodo PathGradientBrush::SetFocusScales dell'oggetto PathGradientBrush per impostare le scale dello stato attivo del pennello su (0.2, 0.2). Il codice usa quindi il pennello sfumatura del percorso per disegnare un rettangolo che include il percorso triangolare.

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

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

   // No GraphicsPath object is created. The PathGradientBrush
   // object is constructed directly from the array of points.
   PathGradientBrush pthGrBrush(points, 3);

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

   REAL relativePositions[] = {
      0.0f,    // red at the boundary of the outer triangle
      1.0f};   // blue at the boundary of the inner triangle

   pthGrBrush.SetInterpolationColors(colors, relativePositions, 2);

   // The inner triangle is formed by scaling the outer triangle
   // about its centroid. The scaling factor is 0.2 in both
   // the x and y directions.
   pthGrBrush.SetFocusScales(0.2f, 0.2f);

   // Fill a rectangle that is larger than the triangle
   // specified in the Point array. The portion of the
   // rectangle outside the triangle will not be painted.
   graphics.FillRectangle(&pthGrBrush, 0, 0, 200, 200); 
}

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