Shape.StrokeDashArray Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Shapes

Ruft eine Auflistung von Double-Werten ab, die das Muster von Bindestrichen und Lücken angibt, die zum Konturieren von Formen verwendet werden, oder legt diese fest.

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"/>

Eigenschaftswert

DoubleCollection

Eine Auflistung von Double-Werten , die das Muster von Bindestrichen und Lücken angibt.

Beispiele

Diese Beispiele zeigen die Auswirkungen verschiedener StrokeDashArray-Werte, die auf Linien und eine Ellipse angewendet werden.

<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>

Hinweise

Ein gültiger strokeDashString für die StrokeDashArray-Eigenschaft beschreibt ein sich wiederholendes Muster von Strichen und Lücken. Jeder Double in der Auflistung gibt die Länge eines Bindestrichs oder Spalts relativ zur Stärke des Stifts an. Mit einem Wert von 1 wird beispielsweise ein Bindestrich oder eine Lücke erstellt, die die gleiche Länge wie die Dicke des Stifts (ein Quadrat) aufweist. Sie können ein Leerzeichen, ein Komma oder eine Mischung aus beidem als Trennzeichen verwenden.

Da sich das Muster wiederholt, StrokeDashArray="1" hat das gleiche Ergebnis wie StrokeDashArray="1 1". Wenn die Auflistung eine ungerade Anzahl von Werten aufweist, wechselt das Muster zwischen dem Beginn mit einem Strich und dem Beginn mit einer Lücke, wie in den Beispielen gezeigt.

Sie sollten in der Regel integrale numerische Werte verwenden. Nicht integrale Werte können Subpixelrendering verursachen und die scheinbare Farbe des Strichs ändern.