Shape.StrokeDashArray Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Shapes

Ottiene o imposta un insieme di valori Double che indica il motivo di trattini e spazi vuoti utilizzati per strutturare le forme.

public:
 property DoubleCollection ^ StrokeDashArray { DoubleCollection ^ get(); void set(DoubleCollection ^ value); };

DoubleCollection StrokeDashArray();

void StrokeDashArray(DoubleCollection value);

public DoubleCollection StrokeDashArray { get; set; }

var doubleCollection = shape.strokeDashArray;
shape.strokeDashArray = doubleCollection;

Public Property StrokeDashArray As DoubleCollection

<object StrokeDashArray="strokeDashString"/>

Valore della proprietà

DoubleCollection

Raccolta di valori Double che specifica il modello di trattini e spazi vuoti.

Esempio

Questi esempi mostrano gli effetti di valori StrokeDashArray diversi applicati a Lines e a Ellipse.

<StackPanel>
    <StackPanel.Resources>
        <Style TargetType="Line">
            <Setter Property="X1" Value="0"/>
            <Setter Property="X2" Value="360"/>
            <Setter Property="Stroke" Value="Black"/>
            <Setter Property="StrokeThickness" Value="4"/>
            <Setter Property="Margin" Value="12"/>
        </Style>
    </StackPanel.Resources>
    <Line StrokeDashArray="1"/>
    <Line StrokeDashArray="1,1"/>
    <Line StrokeDashArray="1 6"/>
    <Line StrokeDashArray="6 1"/>
    <Line StrokeDashArray="0.25 1"/>
    <Line StrokeDashArray="4 1 1 1 1 1"/>
    <Line StrokeDashArray="5,5,1,5" StrokeThickness="8"/>
    <Line StrokeDashArray="1 2 4"/>
    <Line StrokeDashArray="4 2 4"/>
    <Line StrokeDashArray="4 2 4 1,1"/>

    <Ellipse Height="60" Width="360" Stroke="Black" StrokeThickness="4"
             StrokeDashArray="1" HorizontalAlignment="Left" Margin="12"/>
</StackPanel>

Commenti

Un strokeDashString valido per la proprietà StrokeDashArray descrive un modello ripetuto di tratti e gap. Ogni valore Double nell'insieme specifica la lunghezza di un trattino o di una distanza rispetto allo spessore della penna. Ad esempio, un valore pari a 1 crea un trattino o uno spazio con la stessa lunghezza dello spessore della penna (un quadrato). È possibile usare uno spazio, una virgola o una combinazione di entrambi come separatore.

Poiché il modello si ripete, StrokeDashArray="1" ha lo stesso risultato di StrokeDashArray="1 1". Se l'insieme ha un numero dispari di valori, il criterio si alterna tra l'inizio di un tratto e l'inizio con una distanza, come illustrato negli esempi.

In genere è consigliabile usare valori numerici integrali. I valori non integrali possono causare il rendering di subpixel e possono modificare il colore apparente del tratto.