Blend Klasse

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Source:

Blend.cs

Definiert ein Übergangsschema für ein LinearGradientBrush-Objekt. Diese Klasse kann nicht vererbt werden.

public ref class Blend sealed

public sealed class Blend

type Blend = class

Public NotInheritable Class Blend

Vererbung

Object

Blend

Beispiele

Das folgende Beispiel ist für die Verwendung in einer Windows Forms-Umgebung vorgesehen. Es wird veranschaulicht, wie die Blend -Klasse in Verbindung mit der LinearGradientBrush -Klasse verwendet wird, um eine Ellipse auf den Bildschirm zu zeichnen, bei der die Farben gemischt sind. Die Ellipse ist links blau, verschmilzt in der Mitte rot und verschmilzt rechts wieder zu Blau. Dies wird durch die Einstellungen in den Arrays und myPositions erreicht, die myFactors in den Factors Eigenschaften und Positions verwendet werden. Beachten Sie, dass die Blend Eigenschaft des LinearGradientBrush Objekts mit dem Namen lgBrush2 gleich dem Blend -Objekt myBlendsein 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 das Innere von Formen gleichmäßig zu beschatten. Ein Mischungsmuster wird durch zwei Arrays (Factors und Positions) definiert, die jeweils die gleiche Anzahl von Elementen enthalten. Jedes Element des Positions Arrays stellt einen Anteil der Entfernung 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 beispielsweise entsprechende Elemente des Positions Arrays und Factors 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 der Entfernung) aus 30 Prozent Blau und 70 Prozent Rot.

Konstruktoren

Blend()	Initialisiert eine neue Instanz der Blend-Klasse.
Blend(Int32)	Initialisiert eine neue Instanz der Blend-Klasse mit der angegebenen Anzahl von Faktoren und Positionen.

Eigenschaften

Factors	Ruft ein Array von Übergangsfaktoren für den Farbverlauf ab, oder legt dieses fest.
Positions	Ruft ein Array von Übergangspositionen für den Farbverlauf ab, oder legt dieses fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)