DashStyle.Dashes Eigenschaft

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Ruft die Auflistung der Striche und Lücken in diesem DashStyle ab oder legt diese fest.

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

Eigenschaftswert

DoubleCollection

Die Auflistung der Striche und Lücken. Standard ist eine leere DoubleCollection.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie die DashStyle Eigenschaft eines Pen Objekts verwenden, um eine gestrichelte Zeile unter Text zu erstellen.

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

Hinweise

Diese Sammlung beschreibt die Länge der alternierenden Striche und Lücken. Die Werte in der Auflistung sind in Bezug auf Multiples der Thickness Pen. Beispielsweise gibt ein Array von , ein Strich der Länge () gefolgt von einer Lücke der 1Länge () an (1``2 * ThicknessThickness * ).2

Hinweis

Die tatsächliche Länge des Strichs, der gezeichnet wird, hängt von der Formatvorlage DashCap ab, die jedem Ende des Strichs hinzugefügt wird. Der Standardwert DashCap für eine Pen ist Square. Dies verursacht eine Endkappe, die eine Hälfte der Stärke der Linie ist, die an jedem Ende des Stiftstrichs hinzugefügt werden soll. (Siehe PenLineCap Beispiel.) Wenn Sie daher ein Array von 0, und ein Quadrat DashCapangeben, ist die tatsächliche Strichlänge () + () (Thickness0 * * 2DashCap). 2

Wenn in der Auflistung eine ungerade Anzahl von Werten vorhanden ist, werden die Werte so interpretiert, als ob sie einmal wiederholt wurden, um eine sogar anzahl von Werten zu erzeugen. Beispielsweise wird eine Auflistung, die ",3" enthält,5 genauso interpretiert wie eine Auflistung, die 2,,3,3``5``5``2 enthält2.

Negative Werte im Array werden als absoluter Wert interpretiert.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	DashesProperty
Metadateneigenschaften auf true festgelegt	Keine