DashStyle.Dashes Eigenschaft

Definition

Dient zum Abrufen oder Festlegen der Auflistung von Strichen und Lücken in diesem 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

Eigenschaftswert

Die Sammlung von Bindestrichen und Lücken. Der Standardwert ist eine leere DoubleCollection.

Beispiele

Im folgenden Beispiel wird gezeigt, wie sie die DashStyle Eigenschaft einer Pen gestrichelten Linie unter Text 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 von abwechselnden Strichen und Lücken. Die Werte in der Auflistung beziehen sich auf Vielfache des Thickness .Pen Ein Array von 1, z. B. gibt einen Strich der Länge (21 * ) gefolgt von einer Lücke der Länge () anThickness2 * .Thickness

Note

Die tatsächliche Länge des Strichs, der gezeichnet wird, hängt von der Formatvorlage DashCap ab, die jedem Ende des Gedankenstrichs hinzugefügt wird. Der Standardwert DashCap für eine Pen ist Square. Dies führt zu einer Endkappe, die eine Hälfte der Stärke der Linie an jedem Ende des Stiftstrichs hinzufügt. (Ein Beispiel finden Sie PenLineCap unter.) Wenn Sie daher ein Array von 0und ein Quadrat 2angeben, lautet die tatsächliche Strichlänge (DashCap0 * ) + (Thickness2 * ). DashCap

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

Negative Werte im Array werden als absoluter Wert interpretiert.

Informationen zur Abhängigkeitseigenschaft

Element Wert
Bezeichnerfeld DashesProperty
Auf Metadateneigenschaften festgelegt true Nichts

Gilt für: