DashStyle.Dashes DashStyle.Dashes DashStyle.Dashes DashStyle.Dashes Property

Definition

Ruft die Auflistung der Striche und Lücken in diesem DashStyle ab oder legt diese fest.Gets or sets the collection of dashes and gaps in this 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 Auflistung der Striche und Lücken.The collection of dashes and gaps. Standard ist eine leere DoubleCollection.The default is an empty DoubleCollection.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die DashStyle -Eigenschaft Pen eines verwendet wird, um unter Text eine gestrichelte Linie zu erstellen.The following example shows how to use the DashStyle property of a Pen to create a dashed line under text.

<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 Auflistung beschreibt die Länge der abwechselnden Bindestriche und Lücken.This collection describes the length of alternating dashes and gaps. Die Werte in der Auflistung entsprechen den vielfachen Thickness der Penvon.The values in the collection are in terms of multiples of the Thickness of the Pen. Ein Array von 1``2 gibt z. b. einen Bindestrich (Thickness * 1) gefolgt von einer differenzlänge (2 * Thickness) an.For example, an array of 1,2 specifies a dash of length (1 * Thickness) followed by a gap of length (2 * Thickness).

Hinweis

Die tatsächliche Länge des Bindestrichs hängt von der Art von DashCap ab, die jedem Ende des Bindestrichs hinzugefügt wird.The actual length of the dash that is drawn depends on the style of DashCap that is added to each end of the dash. Der Standard DashCap Wert Pen für ist Square.The default DashCap value for a Pen is Square. Dies bewirkt, dass eine Ende-Obergrenze, die eine halbe Stärke der Linie ist, jedem Ende des Stift Strichs hinzugefügt wird.This causes an end cap that is one half the thickness of the line to be added onto each end of the pen stroke. (Ein Beispiel finden Sie unter PenLineCap.) Wenn Sie 0also ein Array von * DashCap0 DashCap 2 und ein Quadrat angeben, ist die tatsächliche Bindestrich Länge ( * Thickness) + (2).(See PenLineCap for an example.) Therefore, if you specify an array of 0, 2 and a square DashCap, the actual dash length will be (0 * Thickness) + (2 * DashCap).

Wenn eine ungerade Anzahl von Werten in der Auflistung vorhanden ist, werden die Werte so interpretiert, als ob Sie einmal wiederholt wurden, um eine gerade Anzahl von Werten zu liefern.If there are an odd number of values in the collection, the values are interpreted as if they had been repeated once to produce an even number of values. Beispielsweise wird eine Auflistung, 2die3,5 , enthält, genauso interpretiert wie eine Auflistung,3die5,2,3,5,, enthält 2.For example, a collection containing 2,3,5 is interpreted the same as a collection containing 2,3,5,2,3,5.

Negative Werte im Array werden als absoluter Wert interpretiert.Negative values in the array are interpreted as their absolute value.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field DashesProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für: