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

Коллекция штрихов и пробелов. Значение по умолчанию — пустой объект 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 Нет

Применяется к