Blend Classe

Definição

Define um padrão de combinação para um LinearGradientBrush objeto. 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
Blend

Exemplos

O exemplo a seguir destina-se a ser usado em um ambiente do 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 misturadas. A elipse é azul à esquerda, mistura-se com vermelho no centro, e mistura-se de volta ao azul à direita. Isso é feito por meio das configurações nas myFactors matrizes e myPositions nas matrizes usadas nas propriedades e Factors nas Positions propriedades. Observe que a Blend propriedade do LinearGradientBrush objeto nomeado 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 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 são Factors 0,2 e 0,3, respectivamente, para um gradiente linear de azul para vermelho ao longo de uma linha de 100 pixels, a cor 20 pixels ao longo dessa linha (20% da distância) consiste em 30% de azul e 70% de vermelho.

Construtores

Nome Description
Blend()

Inicializa uma nova instância da classe Blend.

Blend(Int32)

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

Propriedades

Nome Description
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 combinação para o gradiente.

Métodos

Nome Description
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 Objectatual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a