DashStyle.Dashes Propiedad

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

Obtiene o establece la colección de guiones y espacios de este objeto 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 propiedad

DoubleCollection

Colección de guiones y espacios. El valor predeterminado es un DoubleCollection vacío

Ejemplos

En el ejemplo siguiente se muestra cómo usar la DashStyle propiedad de para Pen crear una línea discontinua en 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>

Comentarios

En esta colección se describe la longitud de guiones y espacios alternados. Los valores de la colección se encuentran en términos de múltiplos de Thickness de .Pen Por ejemplo, una matriz de 1,2 especifica un guión de longitud (1 * Thickness) seguido de un intervalo de longitud (2 * Thickness).

Nota

La longitud real del guión dibujado depende del estilo de DashCap que se agregue a cada extremo del guión. El valor predeterminado DashCap de es Pen Square. Esto hace que un extremo que sea la mitad del grosor de la línea se agregue a cada extremo del trazo del lápiz. (Vea PenLineCap un ejemplo). Por lo tanto, si especifica una matriz de 0, 2 y un cuadrado DashCap, la longitud del guión real será (Thickness * 0) + (2 * DashCap).

Si hay un número impar de valores en la colección, los valores se interpretan como si se hubieran repetido una vez para generar un número par de valores. Por ejemplo, una colección que contiene 2,5``3 se interpreta igual que una colección que contiene 2,3``5 ,2 , , .5``3

Los valores negativos de la matriz se interpretan como su valor absoluto.

Información sobre propiedades de dependencia

Campo identificador	DashesProperty
Propiedades de metadatos establecidas en true	Ninguno