Langue

DashStyle.Dashes Propriété

Définition

Obtient ou définit la collection de tirets et d’écarts dans ce 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

Valeur de propriété

Collection de tirets et d’écarts. La valeur par défaut est vide DoubleCollection.

Exemples

L’exemple suivant montre comment utiliser la DashStyle propriété d’un Pen pour créer une ligne en pointillés sous le texte.

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

Remarques

Cette collection décrit la longueur des tirets et des lacunes alternés. Les valeurs de la collection sont en termes de multiples du ThicknessPen. Par exemple, un tableau de 1,2 spécifie un tiret de longueur (1 * Thickness) suivi d’un écart de longueur ().2 * Thickness

Note

La longueur réelle du tiret dessiné dépend du style de DashCap celui-ci ajouté à chaque extrémité du tiret. La valeur par défaut DashCap d’un Pen est Square. Cela entraîne l’ajout d’une moitié de l’épaisseur de la ligne à chaque extrémité du trait de stylet. (Voir PenLineCap pour obtenir un exemple.) Par conséquent, si vous spécifiez un tableau de points 0 et un carré2, la longueur réelle DashCapdu tiret sera (0 * Thickness) + (2 * DashCap).

S’il existe un nombre impair de valeurs dans la collection, les valeurs sont interprétées comme si elles avaient été répétées une fois pour produire un nombre pair de valeurs. Par exemple, une collection contenant ,, est interprétée comme une collection contenant 2,3,5,2,,3.5235

Les valeurs négatives du tableau sont interprétées comme leur valeur absolue.

Informations sur les propriétés de dépendance

Élément Valeur
Champ d’identificateur DashesProperty
Propriétés de métadonnées définies sur true None

S’applique à