Condividi tramite


DashStyle.Dashes Proprietà

Definizione

Ottiene o imposta l'insieme di trattini e spazi nell'oggetto DashStyle corrente.

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à

DoubleCollection

L'insieme di trattini e spazi. L'impostazione predefinita è un oggetto DoubleCollection vuoto.

Esempio

Nell'esempio seguente viene illustrato come usare la DashStyle proprietà di un Pen oggetto per creare una riga tratteggiata in 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 dei trattini alternati e delle lacune. I valori della raccolta sono in termini di più di Thickness Pen. Ad esempio, una matrice di 1,2 specifica un trattino di lunghezza () seguito da una distanza di lunghezza (2 * 1Thickness * Thickness).

Nota

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

Se nella raccolta sono presenti 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 ,,5 viene interpretata come una raccolta contenente 2``2,3,5,2,, .5``3``3

I valori negativi nella matrice vengono interpretati come valore assoluto.

Informazioni proprietà di dipendenza

Campo Identificatore DashesProperty
Proprietà dei metadati impostate su true Nessuno

Si applica a