DashStyle.Dashes Propiedad

Definición

Espacio de nombres:
System.Windows.Media
Ensamblado:
PresentationCore.dll

Obtiene o establece la colección de guiones y espacios en este 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 huecos. El valor predeterminado es un vacío DoubleCollection.

Ejemplos

En el ejemplo siguiente se muestra cómo usar la DashStyle propiedad de para Pen crear una línea discontinua bajo 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 huecos alternados. Los valores de la colección se encuentran en términos de múltiplos de de Thickness .Pen Por ejemplo, una matriz de 1,2 especifica un guión de longitud (1 * Thickness) seguido de un intervalo de longitud (2 * Thickness).

Note

La longitud real del guión dibujado depende del estilo de DashCap que se agrega a cada extremo del guión. El valor predeterminado DashCap de es PenSquare. 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. (Consulte PenLineCap un ejemplo). Por lo tanto, si especifica una matriz de 0, 2 y un cuadrado DashCap, la longitud del guión real será (0 * Thickness) + (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,3 se5 interpreta igual que una colección que contiene 2,3,5,2,,3.5

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

Información de la propiedad dependency

Elemento Value
Campo identificador DashesProperty
Propiedades de metadatos establecidas en true Ninguno

Se aplica a