DashStyle.Dashes Propriété

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Obtient ou définit la collection de tirets et d'espaces figurant 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é

DoubleCollection

Collection de tirets et d'espaces. La valeur par défaut correspond à une DoubleCollection vide.

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 intervalles alternés. Les valeurs de la collection sont en termes de multiples du Thickness Pen. Par exemple, un tableau de 1,2 spécifie un tiret de longueur (Thickness * 1) suivi d’un intervalle de longueur ().2 * Thickness

Notes

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’un plafond de fin d’une moitié de l’épaisseur de la ligne à chaque extrémité du trait de stylet. (Consultez PenLineCap un exemple.) Par conséquent, si vous spécifiez un tableau de tirets et un carré, la longueur réelle du 0tiret sera (Thickness * 0) + ().2DashCap * DashCap2

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``5``5``3``2

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

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

Champ d’identificateur	DashesProperty
Propriétés de métadonnées définies sur true	Aucun