Pen.DashStyle Property

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Gets or sets a value that describes the pattern of dashes generated by this Pen.

C#

public System.Windows.Media.DashStyle DashStyle { get; set; }

Property Value

DashStyle

A value that describes the pattern of dashes generated by this Pen. The default is Solid, which indicates that there should be no dashes.

Examples

The following example shows how to use the DashStyle property of a Pen to create a dashed line under text.

XAML

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

Remarks

The DashStyles class provides a set of predefined dash patterns.

Dependency Property Information

Item	Value
Identifier field	DashStyleProperty
Metadata properties set to true	None

Applies to

See also

• DashStyles