Etichette

Nel controllo Chart, al fine di rendere più informativi i grafici in uso, è possibile utilizzare sia etichette per gli assi che etichette per i punti dati.

Utilizzo di etichette per gli assi

Il controllo Chart etichetta gli assi dell'area grafico nelle tre diverse modalità riportate di seguito, dalla minore alla maggiore priorità.

Assegnazione di etichette numeriche agli assi
Assegnazione di etichette agli assi utilizzando stringe di testo
Assegnazione di etichette agli assi utilizzando etichette personalizzate

Tali modalità differiscono principalmente nel modo in cui viene generato il testo dell'etichetta.È possibile utilizzare una diversa modalità per ciascun singolo asse.Ad esempio, utilizzare un set di etichette personalizzate per l'asse Y ed etichette testuali per l'asse X.

Assegnazione di etichette numeriche agli assi

Se l'asse non contiene etichette personalizzate e i dati tracciati non dispongono di etichette sugli assi, il controllo Chart visualizzerà automaticamente etichette di asse a un intervallo specificato dalla proprietà Axis.Interval.Per ulteriori informazioni sulla proprietà, vedere Asse.

Assegnazione di etichette agli assi utilizzando stringe di testo

È possibile assegnare etichette agli assi in base al particolare set di dati in uso, utilizzando la proprietà DataPoint.AxisLabel.Dopo aver impostato questa proprietà su una stringa di etichetta, il grafico visualizzerà tale stringa di etichetta nella posizione corrispondente al punto dati.

[!NOTA]

Se il controllo Chart contiene un ampio set di dati, è possibile visualizzare le etichette degli assi in modo selettivo.Per assicurarsi che le etichette degli assi siano visibili, impostare la proprietà Axis.Interval su 1.

Nel seguente esempio di codice viene illustrato come impostare due etichette su un asse per due punti dati.

Chart1.Series("Default").Points(0).AxisLabel = "First Point"
Chart1.Series("Default").Points(1).AxisLabel = "Second Point"

Chart1.Series["Default"].Points[0].AxisLabel = "First Point";
Chart1.Series["Default"].Points[1].AxisLabel = "Second Point";

Assegnazione di etichette agli assi utilizzando etichette personalizzate

Utilizzare etichette personalizzate per assegnare stringhe di testo personalizzate agli assi.Per implementare le etichette personalizzate utilizzare la proprietà di raccolta CustomLabels.Se si utilizzano etichette personalizzate, nell'area grafico non verranno visualizzate le etichette degli assi derivate dai punti dati.

Quando si utilizzano oggetti CustomLabel, è necessario impostare le proprietà ToPosition e FromPosition di ciascun oggetto CustomLabel sulla larghezza dell'area di testo dell'etichetta.Non assegnare lo stesso valore a entrambe le proprietà, in quanto rappresentano un intervallo.Per posizionare un'etichetta personalizzata direttamente sotto a un punto dati e al segno di graduazione associato, impostare la proprietà FromPosition sul valore dell'asse del punto dati meno la metà dell'intervallo del segno di graduazione, quindi impostare la proprietà ToPosition sul valore dell'asse del punto dati più la metà dell'intervallo del segno di graduazione.Ad esempio, se un asse ha un intervallo di 1 (1, 2, 3,…) e si desidera utilizzare un'etichetta personalizzata nella posizione X=2, impostare le proprietà ToPosition e FromPosition su 1,5 e 2,5, rispettivamente.

La proprietà RowIndex specifica la riga su cui verrà visualizzata l'etichetta personalizzata.Se un'etichetta personalizzata viene utilizzata nella prima riga di etichetta, nell'area grafico non verrà visualizzata alcuna etichetta della scala dell'asse.Le etichette personalizzate sono le uniche etichette consentite dalla seconda riga di etichette in avanti.

Stili e formati delle etichette degli assi

È possibile impostare lo stile delle etichette di un asse utilizzando la proprietà LabelStyle dell'oggetto Axis.Le proprietà di stile dell'etichetta impostate in questa proprietà, ad esempio LabelStyle.Font, si applicano alle etichette di un asse.Se le etichette dell'asse sono troppo ravvicinate tra loro, è possibile impostare la proprietà LabelStyle.LabelsAutoFit o la proprietà LabelStyle.Offset su True.

Se si assegnano etichette numeriche agli assi, è inoltre possibile impostare il formato dei numeri tramite la proprietà LabelStyle.Format.

Nel seguente esempio di codice viene illustrato come impostare su valuta il formato dell'asse Y primario.

Chart1.ChartAreas("Default").AxisY.LabelStyle.Format = "C"

Chart1.ChartAreas["Default"].AxisY.LabelStyle.Format = "C";

Nel seguente esempio di codice viene visualizzato il giorno della settimana sull'asse X primario.Per ulteriori informazioni sulla visualizzazione di valori di data e ora come etichette di asse, vedere Utilizzo di valori di data e ora.

Chart1.ChartAreas("Default").AxisX.LabelStyle.Format = "dddd"

Chart1.ChartAreas["Default"].AxisX.LabelStyle.Format = "dddd";

Assegnazione di etichette ai punti dati

Nell'area grafico, è possibile visualizzare etichette di punti dati.Per visualizzare il valore di un punto dati come un'etichetta, utilizzare la proprietà IsValueShownAsLabel dell'oggetto Series o DataPoint.Per visualizzare altre stringhe di testo come etichette dei punti dati, utilizzare la proprietà Series.Label.

Per utilizzare dati nelle etichette, utilizzare parole chiave nella proprietà Series.Label.In fase di esecuzione, nel grafico le parole chiave verranno sostituite con i valori appropriati.Nel seguente esempio di codice viene visualizzata un'etichetta su più righe per ciascun punto dati, in cui il valore Y compare sulla prima riga e il valore X compare sulla seconda riga.

Chart1.Series("Series1").Label = "Y = #VALY" + ControlChars.Lf + "X = #VALX"

Chart1.Series["Series1"].Label = "Y = #VALY\nX = #VALX";

Per ulteriori informazioni, vedere Parole chiave.

Utilizzo di Smart Label

A seconda del tipo di grafico, è possibile utilizzare la proprietà Series.SmartLabelStyle per impostare le etichette per i punti dati in modo da evitare sovrapposizioni.Questa funzionalità si rivela utile quando i punti dati sono raggruppati.

[!NOTA]

La proprietà Series.SmartLabelStyle non ha effetto sui tipi di grafico a barre, a barre con intervalli, a torta, ad anello, istogramma con intervalli, area in pila, area in pila 100%, a barre in pila e a barre in pila 100%.

Per abilitare le smart label utilizzare il codice riportato di seguito.

Chart1.Series("Series1").SmartLabelStyle.Enabled = true

Chart1.Series["Series1"].SmartLabelStyle.Enabled = true;

Quindi è possibile utilizzare le proprietà in SmartLabelStyle come ad esempio le proprietà CalloutStyle e CalloutLineColor per controllare l'aspetto delle smart label.