Shape.StrokeDashArray プロパティ

定義

名前空間:

Microsoft.UI.Xaml.Shapes

図形の輪郭を描くために使用されるダッシュとギャップのパターンを示す Double 値のコレクションを取得または設定します。

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

プロパティ値

DoubleCollection

ダッシュとギャップのパターンを指定する Double 値のコレクション。

例

次の例は、Lines と Ellipse に適用されるさまざまな StrokeDashArray 値の効果を示しています。

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

注釈

StrokeDashArray プロパティの有効な strokeDashString は、ストロークとギャップの繰り返しパターンを表します。 コレクション内の各 Double は、ペンの太さに対するダッシュまたはギャップの長さを指定します。 たとえば、1 の値を指定すると、ペンの太さ (正方形) と同じ長さのダッシュまたはギャップが作成されます。 区切り記号として、スペース、コンマ、または両方の組み合わせを使用できます。

パターンが繰り返されるため、 StrokeDashArray="1" の結果は と StrokeDashArray="1 1"同じです。 コレクションに奇数の値がある場合、パターンは、例に示すように、ストロークで始まるか、ギャップから始まるかの間で交互に行われます。

通常、整数の数値を使用する必要があります。 整数以外の値を指定すると、サブピクセルレンダリングが発生し、ストロークの見かけの色が変わる可能性があります。