PathGradientBrush.SetSigmaBellShape Méthode

Définition

Crée une atténuation du dégradé entre la couleur centrale et la première couleur environnante sur la base d'une courbe ayant la forme d'une cloche.

Surcharges

SetSigmaBellShape(Single)

Crée un pinceau dont le dégradé de couleurs change du centre vers le bord du tracé. La transition d'une couleur à une autre est basée sur une courbe ayant la forme d'une cloche.

SetSigmaBellShape(Single, Single)

Crée un pinceau dont le dégradé de couleurs change du centre vers le bord du tracé. La transition d'une couleur à une autre est basée sur une courbe ayant la forme d'une cloche.

SetSigmaBellShape(Single)

Source:
PathGradientBrush.cs
Source:
PathGradientBrush.cs
Source:
PathGradientBrush.cs

Crée un pinceau dont le dégradé de couleurs change du centre vers le bord du tracé. La transition d'une couleur à une autre est basée sur une courbe ayant la forme d'une cloche.

public:
 void SetSigmaBellShape(float focus);
public void SetSigmaBellShape (float focus);
member this.SetSigmaBellShape : single -> unit
Public Sub SetSigmaBellShape (focus As Single)

Paramètres

focus
Single

Valeur de 0 à 1 qui spécifie la position à laquelle la couleur centrale sera la plus intense, le long de n'importe quelle ligne radiale allant du centre vers le bord du tracé. La valeur 1 (valeur par défaut) définit l'intensité maximale au centre du tracé.

Exemples

Pour obtenir un exemple, consultez SetSigmaBellShape.

Remarques

S’il existe plusieurs couleurs dans le SurroundColors tableau, la première couleur du tableau est utilisée pour la couleur de fin. Les couleurs spécifiées dans ce tableau sont des couleurs utilisées pour les points discrets sur le chemin de limite du pinceau.

Par défaut, lorsque vous passez de la limite d’un dégradé de chemin au point central, la couleur passe progressivement de la couleur de limite à la couleur centrale. Vous pouvez personnaliser le positionnement et la fusion de la limite et des couleurs du centre en appelant cette méthode.

S’applique à

SetSigmaBellShape(Single, Single)

Source:
PathGradientBrush.cs
Source:
PathGradientBrush.cs
Source:
PathGradientBrush.cs

Crée un pinceau dont le dégradé de couleurs change du centre vers le bord du tracé. La transition d'une couleur à une autre est basée sur une courbe ayant la forme d'une cloche.

public:
 void SetSigmaBellShape(float focus, float scale);
public void SetSigmaBellShape (float focus, float scale);
member this.SetSigmaBellShape : single * single -> unit
Public Sub SetSigmaBellShape (focus As Single, scale As Single)

Paramètres

focus
Single

Valeur de 0 à 1 qui spécifie la position à laquelle la couleur centrale sera la plus intense, le long de n'importe quelle ligne radiale allant du centre vers le bord du tracé. La valeur 1 (valeur par défaut) définit l'intensité maximale au centre du tracé.

scale
Single

Valeur de 0 à 1 qui spécifie l'intensité maximale de la couleur centrale qui est mélangée avec la couleur du bord. Une valeur de 1 correspond à l'intensité maximale de la couleur centrale. Il s'agit de la valeur par défaut.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, un objet d’événementOnPaint. Le code effectue les actions suivantes :

  • Crée un chemin d’accès graphique et y ajoute un rectangle.

  • Crée un PathGradientBrush à partir des points de chemin d’accès (dans cet exemple, les points forment un rectangle, mais il peut s’agir de n’importe quelle forme).

  • Définit la couleur centrale sur le rouge et la couleur environnante sur le bleu.

  • Dessine le PathGradientBrush vers l’écran avant d’appliquer la transformation de fusion.

  • Applique la transformation de fusion au pinceau à l’aide de sa SetSigmaBellShape méthode.

  • Appelle la TranslateTransform méthode pour déplacer le rectangle de pinceau de manière à ne pas superposer celui dessiné à l’écran précédemment.

  • Dessine le rectangle de pinceau transformé vers l’écran.

Notez que la couleur centrale maximale (rouge) se trouve à mi-chemin du centre du chemin d’accès à la limite du chemin d’accès.

public:
   void SetSigmaBellShapeExample( 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 blend.
      e->Graphics->FillRectangle( myPGBrush, 10, 10, 200, 200 );

      // Set the Blend factors and transform the brush.
      myPGBrush->SetSigmaBellShape( 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 setting the
      // blend and applying the transform.
      e->Graphics->FillRectangle( myPGBrush, 10, 10, 300, 300 );
   }
public void SetSigmaBellShapeExample(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 blend.
    e.Graphics.FillRectangle(myPGBrush, 10, 10, 200, 200);
             
    // Set the Blend factors and transform the brush.
    myPGBrush.SetSigmaBellShape(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 setting the
    // blend and applying the transform.
    e.Graphics.FillRectangle(myPGBrush, 10, 10, 300, 300);
}
Public Sub SetSigmaBellShapeExample(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.SetSigmaBellShape(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 setting the
    ' blend and applying the transform.
    e.Graphics.FillRectangle(myPGBrush, 10, 10, 300, 300)
End Sub

Remarques

S’il existe plusieurs couleurs dans le SurroundColors tableau, la première couleur du tableau est utilisée pour la couleur de fin. Les couleurs spécifiées dans ce tableau sont des couleurs utilisées pour les points discrets sur le chemin de limite du pinceau.

Par défaut, lorsque vous passez de la limite d’un dégradé de chemin au point central, la couleur passe progressivement de la couleur de limite à la couleur centrale. Vous pouvez personnaliser le positionnement et la fusion de la limite et des couleurs du centre en appelant cette méthode.

S’applique à