Pen.DashPattern Propiedad

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Source:

Pen.cs

Obtiene o establece una matriz de guiones y espacios personalizados.

C#

public float[] DashPattern { get; set; }

Valor de propiedad

Single[]

Una matriz de números reales que especifica las longitudes de los guiones y espacios alternos que forman las líneas discontinuas.

Excepciones

ArgumentException

El valor de la propiedad DashPattern se establece en un objeto Pen inmutable, como los devueltos por la clase Pens.

Ejemplos

En el ejemplo de código siguiente se muestran los efectos de establecer las DashCappropiedades , DashPatterny SmoothingMode .

Este ejemplo está diseñado para usarse con Windows Forms. Pegue el código en un formulario y llame al ShowPensAndSmoothingMode método al controlar el evento del Paint formulario, pasando e como PaintEventArgs.

C#

private void ShowPensAndSmoothingMode(PaintEventArgs e)
{

    // Set the SmoothingMode property to smooth the line.
    e.Graphics.SmoothingMode = 
        System.Drawing.Drawing2D.SmoothingMode.AntiAlias;

    // Create a new Pen object.
    Pen greenPen = new Pen(Color.Green);

    // Set the width to 6.
    greenPen.Width = 6.0F;

    // Set the DashCap to round.
    greenPen.DashCap = System.Drawing.Drawing2D.DashCap.Round;

    // Create a custom dash pattern.
    greenPen.DashPattern = new float[]{4.0F, 2.0F, 1.0F, 3.0F};

    // Draw a line.
    e.Graphics.DrawLine(greenPen, 20.0F, 20.0F, 100.0F, 240.0F);

    // Change the SmoothingMode to none.
    e.Graphics.SmoothingMode = 
        System.Drawing.Drawing2D.SmoothingMode.None;

    // Draw another line.
    e.Graphics.DrawLine(greenPen, 100.0F, 240.0F, 160.0F, 20.0F);

    // Dispose of the custom pen.
    greenPen.Dispose();
}

Comentarios

Al asignar un valor distinto null de a esta propiedad, se establecerá la DashStyle propiedad para esta CustomPen en .

Los elementos de la dashArray matriz establecen la longitud de cada guión y espacio en el patrón dash. El primer elemento establece la longitud de un guión, el segundo elemento establece la longitud de un espacio, el tercer elemento establece la longitud de un guión, etc. Por lo tanto, cada elemento debe ser un número positivo distinto de cero.

La longitud de cada guión y espacio en el patrón dash es el producto del valor de elemento de la matriz y el ancho de Pen.

Se aplica a