Shape.StrokeDashArray Свойство

Определение

Пространство имен:

Windows.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 , задающая шаблон дефисов и пробелов.

Примеры

В этих примерах показаны эффекты различных значений 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>

Комментарии

Допустимый strokeDashString для свойства StrokeDashArray описывает повторяющийся шаблон штрихов и пробелов. Каждый параметр Double в коллекции указывает длину дефиса или зазора относительно толщины пера. Например, при значении 1 создается дефис или зазор, длина которого совпадает с толщиной пера (квадрат). В качестве разделителя можно использовать пробел, запятую или сочетание обоих элементов.

Так как шаблон повторяется, имеет тот же результат, StrokeDashArray="1" что и StrokeDashArray="1 1". Если коллекция содержит нечетное число значений, шаблон чередуется между началом росчерка и зазором, как показано в примерах.

Обычно следует использовать целочисленные значения. Нецельные значения могут привести к отрисовке субпикселя и изменить видимый цвет штриха.