PathGradientBrush.SetBlendTriangularShape Metodo

Definizione

Spazio dei nomi:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v9.0.0-rc.1.24451.1

Crea una sfumatura con un colore centrale e un falloff lineare su un colore circostante.

Overload

SetBlendTriangularShape(Single)	Crea una sfumatura con un colore centrale e un falloff lineare su un colore circostante.
SetBlendTriangularShape(Single, Single)	Crea una sfumatura con un colore centrale e un falloff lineare per ogni colore circostante.

SetBlendTriangularShape(Single)

Origine:

PathGradientBrush.cs

Crea una sfumatura con un colore centrale e un falloff lineare su un colore circostante.

public:
 void SetBlendTriangularShape(float focus);

public void SetBlendTriangularShape (float focus);

member this.SetBlendTriangularShape : single -> unit

Public Sub SetBlendTriangularShape (focus As Single)

Parametri

focus

Single

Valore compreso tra 0 e 1 che specifica dove, lungo qualsiasi radiale dal centro del percorso al limite del percorso, il colore centrale sarà alla massima intensità. Il valore 1 (impostazione predefinita) posiziona l'intensità più alta al centro del percorso.

Esempio

Per un esempio, vedere SetBlendTriangularShape.

Commenti

Se nella matrice SurroundColors sono presenti più colori, il primo colore della matrice viene usato per il colore finale. I colori specificati in questa matrice vengono usati per i punti discreti sul percorso limite del pennello.

SetBlendTriangularShape(Single, Single)

Origine:

PathGradientBrush.cs

Crea una sfumatura con un colore centrale e un falloff lineare per ogni colore circostante.

public:
 void SetBlendTriangularShape(float focus, float scale);

public void SetBlendTriangularShape (float focus, float scale);

member this.SetBlendTriangularShape : single * single -> unit

Public Sub SetBlendTriangularShape (focus As Single, scale As Single)

Parametri

focus

Single

Valore compreso tra 0 e 1 che specifica dove, lungo qualsiasi radiale dal centro del percorso al limite del percorso, il colore centrale sarà alla massima intensità. Il valore 1 (impostazione predefinita) posiziona l'intensità più alta al centro del percorso.

scale

Single

Valore compreso tra 0 e 1 che specifica l'intensità massima del colore centrale che viene miscelato con il colore limite. Un valore pari a 1 determina la massima intensità possibile del colore centrale ed è il valore predefinito.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, un oggetto evento OnPaint. Il codice esegue le azioni seguenti:

• Crea un percorso grafico e aggiunge un rettangolo.

• Crea un PathGradientBrush dai punti del percorso ,in questo esempio i punti formano un rettangolo, ma potrebbero essere la maggior parte di qualsiasi forma.

• Imposta il colore centrale sul rosso e sul colore circostante su blu.

• Disegna il PathGradientBrush sullo schermo prima di applicare la trasformazione di fusione.

• Applica la trasformazione blend al pennello usando il relativo metodo di SetBlendTriangularShape.

• Chiama il metodo TranslateTransform per spostare il rettangolo del pennello in modo che non sovrappone quello disegnato in precedenza allo schermo.

• Disegna il rettangolo di pennello trasformato viene disegnato sullo schermo.

Si noti che il colore centrale massimo (rosso) si trova a metà strada dal centro del percorso al limite del percorso.

public:
   void SetBlendTriangularShapeExample( PaintEventArgs^ e )
   {
      // Create a graphics path and add a rectangle.
      GraphicsPath^ myPath = gcnew GraphicsPath;
      Rectangle rect = Rectangle(100,20,100,50);
      myPath->AddRectangle( rect );

      // Get the path's array of points.
      array<PointF>^myPathPointArray = myPath->PathPoints;

      // Create a path gradient brush.
      PathGradientBrush^ myPGBrush = gcnew PathGradientBrush( myPathPointArray );

      // Set the color span.
      myPGBrush->CenterColor = Color::Red;
      array<Color>^ mySurroundColor = {Color::Blue};
      myPGBrush->SurroundColors = mySurroundColor;

      // Draw the brush to the screen prior to the blend.
      e->Graphics->FillRectangle( myPGBrush, 10, 10, 200, 200 );

      // Set the Blend factors.
      myPGBrush->SetBlendTriangularShape( 0.5f, 1.0f );

      // Move the brush down by 100 by Applying the translate
      // transform to the brush.
      myPGBrush->TranslateTransform( 0, 100, MatrixOrder::Append );

      // Draw the brush to the screen again after applying the
      // transforms.
      e->Graphics->FillRectangle( myPGBrush, 10, 10, 300, 300 );
   }

public void SetBlendTriangularShapeExample(PaintEventArgs e)
{
             
    // Create a graphics path and add a rectangle.
    GraphicsPath myPath = new GraphicsPath();
    Rectangle rect = new Rectangle(100, 20, 100, 50);
    myPath.AddRectangle(rect);
             
    // Get the path's array of points.
    PointF[] myPathPointArray = myPath.PathPoints;
             
    // Create a path gradient brush.
    PathGradientBrush myPGBrush = new
        PathGradientBrush(myPathPointArray);
             
    // Set the color span.
    myPGBrush.CenterColor = Color.Red;
    Color[] mySurroundColor = {Color.Blue};
    myPGBrush.SurroundColors = mySurroundColor;
             
    // Draw the brush to the screen prior to the blend.
    e.Graphics.FillRectangle(myPGBrush, 10, 10, 200, 200);
             
    // Set the Blend factors.
    myPGBrush.SetBlendTriangularShape(0.5f, 1.0f);
             
    // Move the brush down by 100 by Applying the translate
    // transform to the brush.
    myPGBrush.TranslateTransform(0, 100, MatrixOrder.Append);
             
    // Draw the brush to the screen again after applying the
    // transforms.
    e.Graphics.FillRectangle(myPGBrush, 10, 10, 300, 300);
}

Public Sub SetBlendTriangularShapeExample(ByVal e As PaintEventArgs)

    ' Create a graphics path and add a rectangle.
    Dim myPath As New GraphicsPath
    Dim rect As New Rectangle(100, 20, 100, 50)
    myPath.AddRectangle(rect)

    ' Get the path's array of points.
    Dim myPathPointArray As PointF() = myPath.PathPoints

    ' Create a path gradient brush.
    Dim myPGBrush As New PathGradientBrush(myPathPointArray)

    ' Set the color span.
    myPGBrush.CenterColor = Color.Red
    Dim mySurroundColor As Color() = {Color.Blue}
    myPGBrush.SurroundColors = mySurroundColor

    ' Draw the brush to the screen prior to blend.
    e.Graphics.FillRectangle(myPGBrush, 10, 10, 200, 200)

    ' Set the Blend factors.
    myPGBrush.SetBlendTriangularShape(0.5F, 1.0F)

    ' Move the brush down by 100 by Applying the translate
    ' transform to the brush.
    myPGBrush.TranslateTransform(0, 100, MatrixOrder.Append)

    ' Draw the brush to the screen again after applying the
    ' transforms.
    e.Graphics.FillRectangle(myPGBrush, 10, 10, 300, 300)
End Sub

Commenti

Se nella matrice SurroundColors sono presenti più colori, il primo colore della matrice viene usato per il colore finale. I colori specificati in questa matrice sono colori utilizzati per i punti discreti nel percorso limite del pennello.

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