Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
L'uso di legende consente di distinguere fra le varie serie e punti dati nell'immagine del grafico. Le legende vengono memorizzate come oggetti Legend nella proprietà di raccolta Chart.Legends.
Per impostazione predefinita, una legenda non è ancorata a un'area grafico e viene visualizzata esternamente a qualsiasi area grafico. È possibile ancorare una legenda a un'area grafico utilizzando la proprietà DockedToChartArea dell'oggetto Legend. Utilizzando la proprietà Legend dell'oggetto Series, è possibile assegnare singolarmente ciascuna serie a una legenda.
Nella maggioranza dei tipi di grafico, ogni elemento legenda rappresenta una serie tracciata. Nei grafici di tipo a torta, ad anello, a imbuto e a piramide, ogni elemento legenda rappresenta un punto dati nella serie.
Per impostazione predefinita, il controllo Chart crea automaticamente due colonne in una legenda, una per indicare i colori dell'area tracciata e l'altra per visualizzare il testo della legenda. È possibile specificare il testo di una legenda utilizzando le proprietà Series.LegendText o DataPoint.LegendText.
Aggiunta di legende in fase di esecuzione
Per aggiungere una legenda a un grafico in fase di esecuzione, assicurarsi che sia ancorata alla corretta area grafico, assegnata a una serie di dati, e che la proprietà IsVisibleInLegend della serie di dati sia impostata su true. Questo concetto è illustrato nel codice riportato di seguito.
' Create a new legend called "Legend2".
Chart1.Legends.Add(New Legend("Legend2"))
' Set Docking chart of the legend to the Default chart area.
Chart1.Legends("Legend2").DockToChartArea = "Default"
' Assign the legend to Series1.
Chart1.Series("Series1").Legend = "Legend2"
Chart1.Series("Series1").IsVisibleInLegend = true
// Create a new legend called "Legend2".
Chart1.Legends.Add(new Legend("Legend2"));
// Set Docking of the Legend chart to the Default Chart Area.
chart1.Legends["Legend2"].DockToChartArea = "Default";
// Assign the legend to Series1.
Chart1.Series["Series1"].Legend = "Legend2";
Chart1.Series["Series1"].IsVisibleInLegend = true;
Utilizzare le proprietà dell'oggetto Legend per personalizzare l'aspetto di una legenda, come ad esempio Docking, Alignment, IsDockedInsideChartArea, Position, TableStyle, LegendStyle, MaximumAutoSize, Font e InterlacedRows.
Utilizzo di titoli, intestazioni e colonne
Nel diagramma riportato di seguito vengono presentate le varie funzioni di una legenda con le proprietà corrispondenti nell'oggetto Legend.
.gif "Immagine che mostra le caratteristiche della legenda")
Nota
Non è possibile impostare i singoli elementi e celle nella raccolta Chart.Legends. A questo scopo, utilizzare elementi della legenda personalizzati.
Se si utilizza la proprietà Legend.Title per specificare il titolo di una legenda, utilizzare \n per indicare una nuova riga. È possibile utilizzare parole chiave in modo che il testo venga modificato in base alla serie di dati. Per ulteriori informazioni, vedere Parole chiave.
Per personalizzare il numero di colonne nella legenda, utilizzare la proprietà di raccolta Legend.CellColumns. Le colonne definite in questa proprietà si applicano a ogni elemento della legenda generato automaticamente.
Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo della proprietà Legend.CellColumns e delle parole chiave. Nell'esempio vengono aggiunte tre colonne, una per i nomi delle serie, una per i simboli delle serie e una per la media dei dati in ciascuna serie.
Chart1.Legends["Legend2"].CellColumns.Add(New LegendCellColumn("Name", LegendCellColumnType.Text, "#LEGENDTEXT"))
Chart1.Legends["Legend2"].CellColumns.Add(New LegendCellColumn("Sym", LegendCellColumnType.SeriesSymbol, ""))
Chart1.Legends["Legend2"].CellColumns.Add(New LegendCellColumn("Avg", LegendCellColumnType.Text, "#AVG{N2}"))
Chart1.Legends["Legend2"].CellColumns.Add(new LegendCellColumn("Name", LegendCellColumnType.Text, "#LEGENDTEXT"));
Chart1.Legends["Legend2"].CellColumns.Add(new LegendCellColumn("Sym", LegendCellColumnType.SeriesSymbol,""));
Chart1.Legends["Legend2"].CellColumns.Add(new LegendCellColumn("Avg", LegendCellColumnType.Text, "#AVG{N2}"));
È possibile configurare l'aspetto di ciascuna colonna utilizzando le proprietà dell'oggetto LegendCellColumn, come ad esempio MinimumWidth, MaximumWidth, Alignmnent, Margins, HeaderText e ItemColumnsSeparator.