Sintassi di markup del percorso

I percorsi vengono discussi nella Panoramica di Forme e Disegno di base in WPF e nella Panoramica della Geometria. Tuttavia, questo argomento descrive in dettaglio il potente e complesso mini-linguaggio che è possibile utilizzare per specificare le geometrie dei percorsi in modo più compatto usando XAML (Extensible Application Markup Language).

Prerequisiti

Per comprendere questo argomento, è necessario avere familiarità con le funzionalità di base degli Geometry oggetti. Per altre informazioni, vedere Cenni preliminari sulla geometria .

Mini-Languages StreamGeometry e PathFigureCollection

WPF offre due classi che forniscono mini-linguaggi per la descrizione dei percorsi geometrici: StreamGeometry e PathFigureCollection.

• Si utilizza il mini-linguaggio StreamGeometry quando si imposta una proprietà di tipo Geometry, ad esempio la proprietà Clip di un oggetto UIElement o la proprietà Data di un elemento Path. Nell'esempio seguente viene utilizzata la sintassi degli attributi per creare un oggetto StreamGeometry.

  <Path Stroke="Black" Fill="Gray"
        Data="M 10,100 C 10,300 300,-200 300,100" />
  

• Si usa il PathFigureCollection mini-linguaggio quando si imposta la proprietà Figures di un PathGeometry. Nell'esempio seguente viene utilizzata una sintassi di attributo per creare un PathFigureCollection oggetto per un oggetto PathGeometry.

  <Path Stroke="Black" Fill="Gray">
    <Path.Data>
      <PathGeometry Figures="M 10,100 C 10,300 300,-200 300,100" />
    </Path.Data>
  </Path>
  

Come si può vedere negli esempi precedenti, le due mini-lingue sono molto simili. È sempre possibile usare un PathGeometry oggetto in qualsiasi situazione in cui è possibile usare un StreamGeometryoggetto , quindi quale usare? Usare un oggetto StreamGeometry quando non è necessario modificare il percorso dopo averlo creato; usare un oggetto PathGeometry se è necessario modificare il percorso.

Per altre informazioni sulle differenze tra PathGeometry oggetti e StreamGeometry , vedere Cenni preliminari sulla geometria.

Nota sugli spazi vuoti

Per brevità, viene mostrato un singolo spazio nelle sezioni della sintassi che seguono, ma anche più spazi sono accettabili ovunque venga visualizzato un singolo spazio.

Due numeri non devono effettivamente essere separati da una virgola o da uno spazio vuoto, ma questa operazione può essere eseguita solo quando la stringa risultante non è ambigua. Ad esempio, 2..3 è in realtà due numeri: "2". E ".3". Analogamente, 2-3 è "2" e "-3". Gli spazi non sono necessari prima o dopo i comandi.

Sintassi

La sintassi di utilizzo degli attributi XAML (Extensible Application Markup Language) per un StreamGeometry oggetto è costituita da un valore facoltativo FillRule e da una o più descrizioni di figura.

La sintassi di utilizzo degli attributi XAML (Extensible Application Markup Language) per un PathFigureCollection oggetto è costituita da una o più descrizioni di figura.

Comando Sposta

Specifica il punto iniziale di una nuova figura.

Un carattere maiuscolo M indica che startPoint è un valore assoluto; un carattere minuscolo m indica che startPoint è un offset al punto precedente o (0,0) se non esiste alcun valore. Se si elencano più punti dopo il comando di spostamento, una riga viene disegnata in questi punti anche se è stato specificato il comando della riga.

Comandi di disegno

Un comando di disegno può essere costituito da diversi comandi di forma. Sono disponibili i comandi di forma seguenti: linea, linea orizzontale, linea verticale, curva di Bézier cubica, curva di Bézier quadratica, curva di Bézier cubica liscia, curva quadratica di Bézier uniforme e arco ellittico.

È possibile immettere ogni comando usando una lettera maiuscola o minuscola: le lettere maiuscole indicano valori assoluti e lettere minuscole indicano valori relativi: i punti di controllo per tale segmento sono relativi al punto finale dell'esempio precedente.

Comando da riga

Crea una linea retta tra il punto corrente e il punto finale specificato. l 20 30 e L 20,30 sono esempi di comandi da riga validi.

Un carattere maiuscolo L indica che endPoint è un valore assoluto; un carattere minuscolo l indica che endPoint è un offset al punto precedente o (0,0) se non esiste alcun valore.

Comando riga orizzontale

Crea una linea orizzontale tra il punto corrente e la coordinata x specificata. H 90 è un esempio di un comando della riga orizzontale valido.

Un carattere maiuscolo H indica che x è un valore assoluto; un carattere minuscolo h indica che x è un offset al punto precedente o (0,0) se non esiste alcun valore.

Comando riga verticale

Crea una linea verticale tra il punto corrente e la coordinata y specificata. v 90 è un esempio di comando da riga verticale valido.

Un carattere maiuscolo V indica che y è un valore assoluto; un carattere minuscolo v indica che y è un offset al punto precedente o (0,0) se non esiste alcun valore.

Comando della curva di Bézier cubica

Crea una curva di Bézier cubica tra il punto corrente e il punto finale specificato utilizzando i due punti di controllo specificati (controlPoint1 e controlPoint2). C 100,200 200,400 300,200 è un esempio di comando di curva valido.

Comando Curva di Bézier quadratico

Crea una curva quadratica di Bézier tra il punto corrente e il punto finale specificato usando il punto di controllo specificato (controlPoint). q 100,200 300,200 è un esempio di un comando di curva di Bézier quadratico valido.

Comando curva di Bézier cubica uniforme

Crea una curva di Bézier cubica tra il punto corrente e il punto finale specificato. Si assume che il primo punto di controllo sia la riflessione del secondo punto di controllo del comando precedente rispetto al punto corrente. Se non è presente alcun comando precedente o se il comando precedente non era un comando di curva di Bézier cubica o un comando di curva di Bézier cubica uniforme, si supponga che il primo punto di controllo sia coincidente con il punto corrente. Il secondo punto di controllo, il punto di controllo per la fine della curva, viene specificato da controlPoint2. Ad esempio, S 100,200 200,300 è un valido comando di curva Bézier cubica.

Comando curva di Bézier quadratica uniforme

Crea una curva di Bézier quadratica tra il punto corrente e il punto finale specificato. Si presuppone che il punto di controllo sia la riflessione del punto di controllo del comando precedente in relazione al punto attuale. Se non è presente alcun comando precedente o se il comando precedente non era un comando di curva di Bézier quadratico o un comando di curva di Bézier quadratico uniforme, il punto di controllo coincide con il punto corrente.

Comando Arc ellittico

Crea un arco ellittico tra il punto corrente e il punto finale specificato.

Comando Close

Termina la figura corrente e crea una linea che collega il punto corrente al punto iniziale della figura. Questo comando crea una giunzione linea (angolo) tra l'ultimo segmento e il primo segmento della figura.

Sintassi del punto

Descrive le coordinate x e y di un punto in cui (0,0) è l'angolo superiore sinistro.

Valori speciali

Anziché un valore numerico standard, è anche possibile usare i valori speciali seguenti. Questi valori fanno distinzione tra maiuscole e minuscole.

Infinito rappresenta Double.PositiveInfinity.

-Infinity rappresenta Double.NegativeInfinity.

NaN rappresenta Double.NaN.

È anche possibile usare la notazione scientifica. Ad esempio, +1.e17 è un valore valido.

Vedere anche

• Path
• StreamGeometry
• PathGeometry
• PathFigureCollection
• Forme e Disegno di Base in WPF - Panoramica
• Panoramica della Geometria
• Argomenti pratici