DashStyle.Dashes Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает коллекцию штрихов и пробелов в этом объекте DashStyle.
public:
property System::Windows::Media::DoubleCollection ^ Dashes { System::Windows::Media::DoubleCollection ^ get(); void set(System::Windows::Media::DoubleCollection ^ value); };
public System.Windows.Media.DoubleCollection Dashes { get; set; }
member this.Dashes : System.Windows.Media.DoubleCollection with get, set
Public Property Dashes As DoubleCollection
Значение свойства
Коллекция штрихов и пробелов. Значение по умолчанию — пустой объект DoubleCollection.
Примеры
В следующем примере показано, как использовать DashStyle свойство a Pen для создания пунктирной строки под текстом.
<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" >
<StackPanel Margin="20">
<TextBlock FontSize="36">
the lazy brown dog.
<TextBlock.TextDecorations>
<TextDecoration Location="Underline"
PenThicknessUnit="FontRecommended">
<TextDecoration.Pen>
<Pen Thickness="1.5" Brush="Red" >
<!-- For the underline, create a dashed line with each
dash twice the thickness of the Pen and each gap 8 times
the thickness of the Pen. -->
<Pen.DashStyle>
<DashStyle Dashes="2,8"/>
</Pen.DashStyle>
</Pen>
</TextDecoration.Pen>
</TextDecoration>
</TextBlock.TextDecorations>
</TextBlock>
</StackPanel>
</Page>
Комментарии
В этой коллекции описывается длина чередующихся дефисов и пробелов. Значения в коллекции имеют несколько кратных Thickness значений Pen. Например, массив 1
,2
указывает тире длины (Thickness * 1
), за которым следует пробел длины (2
* Thickness).
Примечание
Фактическая длина рисуемого тире зависит от стиля DashCap , добавляемого в каждый конец тире. Значением по умолчанию DashCap для a Pen является Square. Это приводит к тому, что конец крышки составляет одну половину толщины линии, добавляемой на каждый конец росчерка пера. (СмPenLineCap. пример.) Таким образом, если указать массив 0``2
и квадратDashCap, то фактическая длина тире будет ( * Thickness0
) + (2
* DashCap).
Если в коллекции есть нечетное число значений, значения интерпретируются так, как если бы они повторялись один раз для получения четного числа значений. Например, коллекция, содержащая 2
,, интерпретируется так же,5
как и коллекция, содержащая 2
,3
,5``2
,3
.5``3
Отрицательные значения в массиве интерпретируются как их абсолютное значение.
Сведения о свойстве зависимостей
Поле идентификатора | DashesProperty |
Для свойств метаданных задано значение true |
Нет |