Blend Classe

Definição

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

Blend.cs

Define um padrão de mesclagem para um objeto LinearGradientBrush. Essa classe não pode ser herdada.

public ref class Blend sealed

public sealed class Blend

type Blend = class

Public NotInheritable Class Blend

Herança

Object

Blend

Exemplos

O exemplo a seguir destina-se a ser usado em um ambiente Windows Forms. Ele demonstra como usar a Blend classe em conjunto com a LinearGradientBrush classe para desenhar uma elipse na tela que tenha suas cores combinadas. A elipse é azul à esquerda, mistura-se ao vermelho no centro, e se mistura de volta ao azul à direita. Isso é feito por meio das configurações nas myFactors matrizes e myPositions usadas nas Factors propriedades e Positions . Observe que a Blend propriedade do LinearGradientBrush objeto chamado lgBrush2 deve ser igual ao Blend objeto myBlend.

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

Comentários

Gradientes são comumente usados para sombrear suavemente os interiores das formas. Um padrão de combinação é definido por duas matrizes (Factors e Positions) que contêm cada uma o mesmo número de elementos. Cada elemento da Positions matriz representa uma proporção da distância ao longo da linha de gradiente. Cada elemento da Factors matriz representa a proporção das cores inicial e final na mistura de gradiente na posição ao longo da linha de gradiente representada pelo elemento correspondente na Positions matriz.

Por exemplo, se os Positions elementos correspondentes das matrizes e Factors forem 0,2 e 0,3, respectivamente, para um gradiente linear de azul a vermelho ao longo de uma linha de 100 pixels, a cor 20 pixels ao longo dessa linha (20% da distância) consiste em 30% azul e 70% vermelho.

Construtores

Blend()	Inicializa uma nova instância da classe Blend.
Blend(Int32)	Inicializa uma nova instância da classe Blend com o número especificado de fatores e posições.

Propriedades

Factors	Obtém ou define uma matriz de fatores de mesclagem para o gradiente.
Positions	Obtém ou define uma matriz de posições de mesclagem para o gradiente.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)