DashStyle.Dashes Proprietà

Definizione

Ottiene o imposta la raccolta di trattini e spazi vuoti in questo DashStyleoggetto .

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

Valore della proprietà

Raccolta di trattini e spazi vuoti. Il valore predefinito è un oggetto vuoto DoubleCollection.

Esempio

Nell'esempio seguente viene illustrato come utilizzare la DashStyle proprietà di un Pen oggetto per creare una linea tratteggiata sotto il testo.

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

Commenti

Questa raccolta descrive la lunghezza di trattini alternati e spazi vuoti. I valori nella raccolta sono in termini di multipli dell'oggetto ThicknessPendi . Ad esempio, una matrice di 1,2 specifica un trattino di lunghezza (1 * Thickness) seguito da una distanza di lunghezza (2 * Thickness).

Note

La lunghezza effettiva del trattino disegnato dipende dallo stile di DashCap che viene aggiunto a ogni estremità del trattino. Il valore predefinito DashCap per un Pen oggetto è Square. In questo modo, un estremità finale pari a metà dello spessore della linea da aggiungere a ogni estremità del tratto della penna. Vedere PenLineCap per un esempio. Pertanto, se si specifica una matrice di 0e un quadrato 2, la lunghezza effettiva del trattino sarà (DashCap0 * ) + (Thickness2 * ). DashCap

Se nella raccolta è presente un numero dispari di valori, i valori vengono interpretati come se fossero stati ripetuti una volta per produrre un numero pari di valori. Ad esempio, una raccolta contenente 2,35 viene interpretata come una raccolta contenente 2,35,,2,,3 .5

I valori negativi nella matrice vengono interpretati come valore assoluto.

Informazioni sulle proprietà di dipendenza

Item Value
Campo Identificatore DashesProperty
Proprietà dei metadati impostate su true Nessuno

Si applica a