Blend Klasse

Definition

public ref class Blend sealed

public sealed class Blend

type Blend = class

Public NotInheritable Class Blend

Vererbung

Object

Blend

Beispiele

Das folgende Beispiel soll in einer Windows Forms-Umgebung verwendet werden. Es veranschaulicht, wie die Blend Klasse in Verbindung mit der LinearGradientBrush Klasse verwendet wird, um eine Ellipse auf den Bildschirm zu zeichnen, die ihre Farben gemischt haben. Die Auslassungspunkte sind blau auf der linken Seite, blendet sich in der Mitte in Rot und blendet auf der rechten Seite wieder in Blau ein. Dies erfolgt über die Einstellungen in den in den myFactorsmyPositions und FactorsPositions den Eigenschaften verwendeten Arrays. Beachten Sie, dass die Blend Eigenschaft des LinearGradientBrush benannten lgBrush2 Objekts gleich dem Blend Objekt myBlendgemacht werden muss.

public:
   void BlendConstExample( PaintEventArgs^ e )
   {
      //Draw ellipse using Blend.
      Point startPoint2 = Point(20,110);
      Point endPoint2 = Point(140,110);
      array<Single>^myFactors = {.2f,.4f,.8f,.8f,.4f,.2f};
      array<Single>^myPositions = {0.0f,.2f,.4f,.6f,.8f,1.0f};
      Blend^ myBlend = gcnew Blend;
      myBlend->Factors = myFactors;
      myBlend->Positions = myPositions;
      LinearGradientBrush^ lgBrush2 =
            gcnew LinearGradientBrush( startPoint2,endPoint2,Color::Blue,Color::Red );
      lgBrush2->Blend = myBlend;
      Rectangle ellipseRect2 = Rectangle(20,110,120,80);
      e->Graphics->FillEllipse( lgBrush2, ellipseRect2 );

      // End example.
   }

public void BlendConstExample(PaintEventArgs e)
{
             
    //Draw ellipse using Blend.
    Point startPoint2 = new Point(20, 110);
    Point endPoint2 = new Point(140, 110);
    float[] myFactors = {.2f,.4f,.8f,.8f,.4f,.2f};
    float[] myPositions = {0.0f,.2f,.4f,.6f,.8f,1.0f};
    Blend myBlend = new Blend();
    myBlend.Factors = myFactors;
    myBlend.Positions = myPositions;
    LinearGradientBrush lgBrush2 = new LinearGradientBrush(
        startPoint2,
        endPoint2,
        Color.Blue,
        Color.Red);
    lgBrush2.Blend = myBlend;
    Rectangle ellipseRect2 = new Rectangle(20, 110, 120, 80);
    e.Graphics.FillEllipse(lgBrush2, ellipseRect2);
             
    // End example.
}

Public Sub BlendConstExample(ByVal e As PaintEventArgs)

    ' Draw ellipse using Blend.
    Dim startPoint2 As New Point(20, 110)
    Dim endPoint2 As New Point(140, 110)
    Dim myFactors As Single() = {0.2F, 0.4F, 0.8F, 0.8F, 0.4F, 0.2F}
    Dim myPositions As Single() = {0.0F, 0.2F, 0.4F, 0.6F, 0.8F, 1.0F}
    Dim myBlend As New Blend
    myBlend.Factors = myFactors
    myBlend.Positions = myPositions
    Dim lgBrush2 As New LinearGradientBrush(startPoint2, endPoint2, _
    Color.Blue, Color.Red)
    lgBrush2.Blend = myBlend
    Dim ellipseRect2 As New Rectangle(20, 110, 120, 80)
    e.Graphics.FillEllipse(lgBrush2, ellipseRect2)
End Sub

Hinweise

Farbverläufe werden häufig verwendet, um die Innenräume von Formen gleichmäßig zu schattieren. Ein Blendmuster wird durch zwei Arrays (Factors und Positions) definiert, die jeweils dieselbe Anzahl von Elementen enthalten. Jedes Element des Positions Arrays stellt einen Anteil des Abstands entlang der Farbverlaufslinie dar. Jedes Element des Factors Arrays stellt den Anteil der Anfangs- und Endfarben in der Farbverlaufsmischung an der Position entlang der Farbverlaufslinie dar, die durch das entsprechende Element im Positions Array dargestellt wird.

Wenn z. B. entsprechende Elemente der Positions Und Factors Arrays 0,2 bzw. 0,3 für einen linearen Farbverlauf von Blau zu Rot entlang einer 100-Pixel-Linie sind, besteht die Farbe 20 Pixel entlang dieser Linie (20 Prozent des Abstands) aus 30 Prozent Blau und 70 Prozent Rot.