Blend Clase

Definición

Define un modelo de mezcla para un objeto LinearGradientBrush.Defines a blend pattern for a LinearGradientBrush object. Esta clase no puede heredarse.This class cannot be inherited.

public ref class Blend sealed
public sealed class Blend
type Blend = class
Public NotInheritable Class Blend
Herencia
Blend

Ejemplos

El ejemplo siguiente está pensado para usarse en un entorno de Windows Forms.The following example is intended to be used in a Windows Forms environment. Muestra cómo usar la Blend clase junto con la clase para dibujar una elipse en la pantalla en la que se combinan los LinearGradientBrush colores.It demonstrates how to use the Blend class in conjunction with the LinearGradientBrush class to draw an ellipse to screen that has its colors blended. La elipse es azul a la izquierda, se mezcla en rojo en el centro y se vuelve a combinar en azul a la derecha.The ellipse is blue on the left, blends to red in the center, and blends back to blue on the right. Esto se logra a través de la configuración myFactors de myPositions las matrices y utilizadas en Factors las Positions propiedades y.This is accomplished through the settings in the myFactors and myPositions arrays used in the Factors and Positions properties. Tenga en cuenta Blend que la propiedad LinearGradientBrush del objeto lgBrush2 denominado debe ser igual que el Blend objeto myBlend.Note that the Blend property of the LinearGradientBrush object named lgBrush2 must be made equal to the Blend object 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

Comentarios

Los degradados suelen usarse para sombrear suavemente el interior de las formas.Gradients are commonly used to smoothly shade the interiors of shapes. Un patrón de Blend se define mediante dos matrices (Factors y Positions) que contienen cada una el mismo número de elementos.A blend pattern is defined by two arrays (Factors and Positions) that each contain the same number of elements. Cada elemento de la Positions matriz representa una proporción de la distancia a lo largo de la línea del degradado.Each element of the Positions array represents a proportion of the distance along the gradient line. Cada elemento de la Factors matriz representa la proporción de los colores inicial y final de la mezcla de degradado en la posición a lo largo de la línea de degradado Positions representada por el elemento correspondiente de la matriz.Each element of the Factors array represents the proportion of the starting and ending colors in the gradient blend at the position along the gradient line represented by the corresponding element in the Positions array.

Por ejemplo, si los elementos correspondientes de Positions las Factors matrices y son 0,2 y 0,3, respectivamente, para un degradado lineal de azul a rojo a lo largo de una línea de 100 píxeles, el color de 20 píxeles de la línea (20 por ciento de la distancia) consta del 30 por ciento. azul y 70 por ciento rojo.For example, if corresponding elements of the Positions and Factors arrays are 0.2 and 0.3, respectively, for a linear gradient from blue to red along a 100-pixel line, the color 20 pixels along that line (20 percent of the distance) consists of 30 percent blue and 70 percent red.

Constructores

Blend()

Inicializa una nueva instancia de la clase Blend.Initializes a new instance of the Blend class.

Blend(Int32)

Inicializa una nueva instancia de la clase Blend con el número de factores y posiciones especificado.Initializes a new instance of the Blend class with the specified number of factors and positions.

Propiedades

Factors

Obtiene o establece una matriz de factores de mezcla para el degradado.Gets or sets an array of blend factors for the gradient.

Positions

Obtiene o establece una matriz de posiciones de mezcla para el degradado.Gets or sets an array of blend positions for the gradient.

Métodos

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a