DashStyle.Dashes Propriedade

Definição

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Obtém ou define a coleção de traços e lacunas neste 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

Valor da propriedade

DoubleCollection

A coleção de traços e lacunas. O padrão é um DoubleCollection vazio.

Exemplos

O exemplo a seguir mostra como usar a DashStyle propriedade de um Pen para criar uma linha tracejada em texto.

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

Comentários

Esta coleção descreve o comprimento de traços e lacunas alternados. Os valores na coleção são em termos de múltiplos do Thickness Pen. Por exemplo, uma matriz de 1,2 especifica um traço de comprimento (Thickness * 1) seguido por uma lacuna de comprimento ().2 * Thickness

Observação

O comprimento real do traço desenhado depende do estilo do DashCap qual é adicionado a cada extremidade do traço. O valor padrão DashCap de a Pen é Square. Isso faz com que uma tampa final que é metade da espessura da linha seja adicionada a cada extremidade do traço da caneta. (Consulte PenLineCap um exemplo.) Portanto, se você especificar uma matriz de 0, 2 e um quadrado DashCap, o comprimento real do traço será (0 * Thickness) + (2 * DashCap).

Se houver um número ímpar de valores na coleção, os valores serão interpretados como se tivessem sido repetidos uma vez para produzir um número par de valores. Por exemplo, uma coleção que 2contém ,3,5 é interpretada da mesma forma que uma coleção que contém 2,3,5,2,3,5.

Os valores negativos na matriz são interpretados como seu valor absoluto.

Informações da propriedade de dependência

Campo Identificador	DashesProperty
Propriedades de metadados definidas como true	Nenhum