Condividi tramite


Shape.StrokeDashArray Proprietà

Definizione

Ottiene o imposta una raccolta di valori Double che indica il modello di trattini e spazi vuoti usati 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à

Raccolta di valori Double che specifica il modello di trattini e lacune.

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>
Esempi di matrice trattino tratto

Commenti

Un trattoDashString valido per la proprietà StrokeDashArray descrive un modello ripetuto di tratti e lacune. Ogni double nella raccolta specifica la lunghezza di un trattino o di uno spazio relativo allo spessore della penna. Ad esempio, un valore pari a 1 crea un trattino o uno spazio che ha 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 la raccolta ha un numero di valori dispari, il modello si alterna tra l'inizio di un tratto e l'inizio di un intervallo, 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.

Si applica a