PathGradientBrush.SetSigmaBellShape 方法

定義

命名空間:

System.Drawing.Drawing2D

組件:

System.Drawing.Common.dll

根據鐘形曲線，建立中心色彩與第一個周圍色彩之間的漸層下降。

多載

SetSigmaBellShape(Single)	建立漸層筆刷，變更從路徑向外路徑中央到路徑界限的色彩。 從一種色彩轉換為另一種色彩的依據是鐘形曲線。
SetSigmaBellShape(Single, Single)	建立漸層筆刷，變更從路徑向外路徑中央到路徑界限的色彩。 從一種色彩轉換為另一種色彩的依據是鐘形曲線。

SetSigmaBellShape(Single)

建立漸層筆刷，變更從路徑向外路徑中央到路徑界限的色彩。 從一種色彩轉換為另一種色彩的依據是鐘形曲線。

public:
 void SetSigmaBellShape(float focus);

public void SetSigmaBellShape (float focus);

member this.SetSigmaBellShape : single -> unit

Public Sub SetSigmaBellShape (focus As Single)

參數

focus

Single

從 0 到 1 的值，指定從路徑中央到路徑界限的任何星形，中心色彩會處於最高強度。 值為 1 （預設值） 會將最高強度放在路徑的中心。

範例

如需範例，請參閱 SetSigmaBellShape。

備註

如果 SurroundColors 陣列中有多個色彩，陣列中的第一個色彩會用於結束色彩。 此陣列中指定的色彩是筆刷界限路徑上離散點所使用的色彩。

根據預設，當您從路徑漸層的界限移至中心點時，色彩會逐漸從界限色彩變更為中心色彩。 您可以藉由呼叫此方法來自定義界限和中心色彩的定位和混合。

SetSigmaBellShape(Single, Single)

建立漸層筆刷，變更從路徑向外路徑中央到路徑界限的色彩。 從一種色彩轉換為另一種色彩的依據是鐘形曲線。

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)

參數

focus

Single

從 0 到 1 的值，指定從路徑中央到路徑界限的任何星形，中心色彩會處於最高強度。 值為 1 （預設值） 會將最高強度放在路徑的中心。

scale

Single

從 0 到 1 的值，指定與界限色彩混合的中央色彩最大強度。 值為 1 會導致中心色彩的可能強度最高，而它是預設值。

範例

下列程式代碼範例的設計目的是要與 Windows Forms 搭配使用，而且需要 PaintEventArgseOnPaint 事件物件。 程式代碼會執行下列動作：

• 建立圖形路徑，並將矩形加入其中。

• 從路徑點建立 PathGradientBrush（在此範例中，這些點會形成矩形，但可能是大部分的圖形）。

• 將中央色彩設定為紅色，並將周圍色彩設定為藍色。

• 在套用混合轉換之前，先將 PathGradientBrush 繪製到畫面。

• 使用其 SetSigmaBellShape 方法，將混合轉換套用至筆刷。

• 呼叫 TranslateTransform 方法來移動筆刷矩形，使其不會重疊先前繪製到螢幕的筆刷矩形。

• 將已轉換的筆刷矩形繪製到畫面。

請注意，中心色彩上限（紅色）位於路徑中央到路徑界限的一半處。

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

備註

如果 SurroundColors 陣列中有多個色彩，陣列中的第一個色彩會用於結束色彩。 此陣列中指定的色彩是筆刷界限路徑上離散點所使用的色彩。

根據預設，當您從路徑漸層的界限移至中心點時，色彩會逐漸從界限色彩變更為中心色彩。 您可以藉由呼叫此方法來自定義界限和中心色彩的定位和混合。