DashStyle.Dashes Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Pobiera lub ustawia kolekcję łączników i przerw w tym DashStyleobiekcie .

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

Wartość właściwości

DoubleCollection

Kolekcja kresek i przerw. Wartość domyślna to pusta DoubleCollectionwartość .

Przykłady

W poniższym przykładzie pokazano, jak za pomocą DashStyle właściwości obiektu Pen utworzyć linię przerywaną pod tekstem.

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

Uwagi

W tej kolekcji opisano długość przemiennej kreski i przerw. Wartości w kolekcji są pod względem wielokrotności Thickness elementu Pen. Na przykład tablica typu 1``2 określa kreskę długości ( * 1Thickness), po której następuje odstęp długości (2 * Thickness).

Uwaga

Rzeczywista długość kreski, która jest rysowana, zależy od stylu DashCap , który jest dodawany do każdego końca kreski. Wartość domyślna DashCap elementu Pen to Square. Powoduje to dodanie pokrywy końcowej o połowę grubości linii na każdym końcu pociągnięcia pióra. (Zobacz PenLineCap przykład). W związku z tym, jeśli określisz tablicę , i kwadrat DashCap, rzeczywista długość kreski będzie (Thickness * 0) + (DashCap * 2). 2 0

Jeśli w kolekcji istnieje nieparzysta liczba wartości, wartości są interpretowane tak, jakby były powtarzane raz, aby wygenerować parzystą liczbę wartości. Na przykład kolekcja zawierająca ,,5 jest interpretowana tak samo jak kolekcja zawierająca 2,3,5,2,,3``5.2``3

Wartości ujemne w tablicy są interpretowane jako ich wartość bezwzględna.

Informacje dotyczące właściwości zależności

Pole identyfikatora	DashesProperty
Właściwości metadanych ustawione na true	Brak