DashStyle.Dashes Propriedade

Definição

Espaço de Nomes:
System.Windows.Media
Assemblagem:
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 de Propriedade

DoubleCollection

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

Exemplos

O exemplo seguinte mostra como usar a DashStyle propriedade de a Pen para criar uma linha tracejada por baixo do 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>

Observações

Esta coleção descreve o comprimento dos traços e espaços alternados. Os valores na coleção são em termos de múltiplos dos Thickness de .Pen Por exemplo, um array de 1, especifica um traço de comprimento (21 * ) seguido de um intervalo de comprimento (Thickness2 * ).Thickness

Note

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

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

Os valores negativos no array são interpretados como o seu valor absoluto.

Informação de Propriedade de Dependência

Iteme Value
Campo identificador DashesProperty
Propriedades dos metadados definidas como true None

Aplica-se a