Legend Classe

Definizione

Spazio dei nomi:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Rappresenta la legenda per l'immagine del grafico.

public ref class Legend : System::Windows::Forms::DataVisualization::Charting::ChartNamedElement

public class Legend : System.Windows.Forms.DataVisualization.Charting.ChartNamedElement

type Legend = class
    inherit ChartNamedElement

Public Class Legend
Inherits ChartNamedElement

Ereditarietà

Object

ChartElement

ChartNamedElement

Legend

Commenti

La Legend classe incapsula tutte le funzionalità della Chart legenda del controllo ed è esposta utilizzando la Legends proprietà collection dell'oggetto radice Chart .

È possibile specificare un numero qualsiasi di legende per un'immagine del grafico.

Le legende possono:

• Essere ancorato e allineato.

• Essere visualizzato all'interno o all'esterno delle aree grafico tracciate.

• Adatta automaticamente il contenuto.

• Usare uno stile predefinito, ad esempio riga, colonna o tabella.

• Usa tratteggio, colori sfumati e immagini di sfondo.

• Ridimensionare e posizionare ovunque all'interno dell'immagine del grafico.

Gli elementi della legenda sono rappresentati dall'oggetto LegendItem e sono elementi predefiniti o personalizzati. Gli elementi personalizzati non sono associati ai dati e possono essere aggiunti, eliminati e modificati usando la CustomItems proprietà .

Gli elementi predefiniti vengono aggiunti automaticamente alla legenda e sono i nomi dei punti dati tracciati per i grafici ad anello e a torta.

Per tutti gli altri tipi di grafico, gli elementi predefiniti sono i nomi della serie di dati tracciati. Ogni serie ha una Legend proprietà che definisce il nome della legenda che verrà utilizzata. Un elemento della legenda non verrà creato per una serie se la IsVisibleInLegend proprietà è impostata su false. Il testo di questi elementi predefiniti può essere modificato usando la LegendText proprietà . Questa proprietà consente di specificare parole chiave predefinite che verranno sostituite dai valori appropriati in fase di esecuzione.

Se si dispone di un grafico a torta e si imposta la Label proprietà , verrà anche impostato il testo della legenda sul valore impostato per le etichette. Se si desidera impostare il testo su un valore diverso, è possibile impostare la LegendText proprietà . Nella maggior parte dei casi, è consigliabile impostare la LegendText proprietà su "#AXISLABEL" o "#VALX".

I simboli della serie di legende sono rettangoli, punti o linee. Il tipo di simbolo viene impostato automaticamente dal grafico e dipende dal tipo di grafico tracciato.

Per impostazione predefinita, il testo della legenda viene ridimensionato automaticamente. È possibile disabilitare il ridimensionamento automatico del testo della legenda disabilitando la IsTextAutoFit proprietà . Quando questa proprietà è impostata su false, le dimensioni del testo della legenda sono determinate dalla proprietà Size della legenda Font. Se la IsTextAutoFit proprietà è abilitata, la AutoFitMinFontSize proprietà determina le dimensioni minime del carattere che un elemento della legenda può avere durante il ridimensionamento.

La TextWrapThreshold proprietà definisce un limite per il numero di caratteri che è possibile visualizzare su una riga prima che il testo venga sottoposto a wrapping in un'altra riga. Se non si desidera eseguire il wrapping del testo nella legenda, impostare il valore della TextWrapThreshold proprietà su zero. Per impostazione predefinita, quando l'intero testo della legenda non rientra nella legenda, il testo verrà troncato. È possibile impostare sulla TextWrapThreshold legenda per ottenere il testo da incapsulare invece di essere troncato.

Se il contenuto della legenda non può rientrare nello spazio specificato, le voci della legenda vengono troncate. Vengono visualizzati puntini di sospensione per indicare che sono presenti più voci rispetto alla legenda per cui la legenda ha spazio. Per impedire che gli elementi della legenda vengano troncati, impostare la posizione e le dimensioni della legenda usando la Position proprietà . Quando si imposta la posizione o le dimensioni della legenda, il grafico non può più posizionare automaticamente gli elementi nel grafico. In alcuni casi, è necessario posizionare manualmente altri elementi del grafico per ottenere l'aspetto desiderato.

Un'altra opzione consiste nel definire colonne di cella personalizzate anziché usare le impostazioni predefinite della legenda.

L'oggetto Legend dispone di un insieme CellColumn. Ogni oggetto CellColumn rappresenta una colonna nella legenda. Una colonna di cella ha MaximumWidth proprietà e MinimumWidth che possono essere utilizzate per regolare le dimensioni delle colonne.

Quando la legenda contiene molte voci, InterlacedRows può essere usata per migliorare la leggibilità. Quando questa proprietà è impostata su True, verrà visualizzato un colore posteriore che è possibile impostare usando la InterlacedRowsColor proprietà .

Per impostazione predefinita, la legenda viene posizionata nell'angolo superiore destro del grafico. Questa posizione può essere modificata utilizzando le Docking proprietà e Alignment della legenda. La legenda può anche essere associata a un'area del grafico tramite la DockedToChartArea proprietà . Questa proprietà specifica il nome dell'area del grafico per cui deve essere ancorata la legenda. Inoltre, la IsDockedInsideChartArea proprietà può essere usata per visualizzare la legenda all'interno di un'area del grafico.

Se IsDockedInsideChartArea è impostata su False, la MaximumAutoSize proprietà definisce la dimensione massima, in percentuale, della legenda all'interno del grafico disponibile quando la legenda viene posizionata automaticamente. Questa proprietà deve essere impostata se si desidera regolare la larghezza o l'altezza della legenda dopo l'impostazione delle proprietà di ancoraggio.

La legenda può essere modificata usando l'evento CustomizeLegend .

Costruttori

Legend()	Inizializza una nuova istanza della classe Legend.
Legend(String)	Inizializza una nuova istanza della classe Legend con il nome della legenda specificato.

Proprietà

Alignment	Ottiene o imposta l'allineamento della legenda.
AutoFitMinFontSize	Ottiene o imposta le dimensioni minime del carattere che possono essere utilizzate dall'algoritmo di adattamento automatico per il testo della legenda.
BackColor	Ottiene o imposta il colore di sfondo della legenda.
BackGradientStyle	Ottiene o imposta l'orientamento della sfumatura di sfondo di una legenda. Determina inoltre se viene utilizzata una sfumatura.
BackHatchStyle	Ottiene o imposta lo stile del tratteggio di una legenda.
BackImage	Ottiene o imposta l'immagine di sfondo di una legenda.
BackImageAlignment	Ottiene o imposta l'allineamento dell'immagine di sfondo utilizzato per la modalità di disegno Unscaled.
BackImageTransparentColor	Ottiene o imposta un colore che sarà sostituito con un colore trasparente quando verrà disegnata l'immagine di sfondo.
BackImageWrapMode	Ottiene o imposta la modalità di disegno dell'immagine di sfondo della legenda.
BackSecondaryColor	Ottiene o imposta il colore secondario dello sfondo di una legenda.
BorderColor	Ottiene o imposta il colore del bordo della legenda.
BorderDashStyle	Ottiene o imposta lo stile del bordo della legenda.
BorderWidth	Ottiene o imposta lo spessore del bordo della legenda.
CellColumns	Ottiene l'oggetto LegendCellColumnCollection che contiene la raccolta di colonne di celle per una legenda.
CustomItems	Ottiene un oggetto LegendItemsCollection usato per elementi legenda personalizzati.
DockedToChartArea	Ottiene o imposta il nome dell'oggetto ChartArea a cui sarà ancorata la legenda.
Docking	Ottiene o imposta un valore che determina se la legenda è ancorata.
Enabled	Ottiene o imposta un valore che indica se la legenda è abilitata.
Font	Ottiene o imposta un oggetto Font utilizzato per impostare le proprietà del carattere della legenda.
ForeColor	Ottiene o imposta il colore del testo della legenda.
HeaderSeparator	Ottiene o imposta il tipo di separatore visivo per l'intestazione della legenda.
HeaderSeparatorColor	Ottiene o imposta il colore del separatore per l'intestazione della legenda.
InsideChartArea	Ottiene o imposta il nome dell'ara del grafico in cui viene disegnata la legenda.
InterlacedRows	Ottiene o imposta un flag che indica se le righe della legenda saranno disegnate con un colore di sfondo interlacciato.
InterlacedRowsColor	Ottiene o imposta il colore di sfondo delle righe interlacciate della legenda.
IsDockedInsideChartArea	Ottiene o imposta un flag che indica se la legenda è ancorata all'interno o all'esterno dell'area grafico.
IsEquallySpacedItems	Ottiene o imposta un flag che indica se tutti gli elementi della legenda sono equidistanti.
IsTextAutoFit	Ottiene o imposta un contrassegno che indica se il testo della legenda viene ridimensionato automaticamente.
ItemColumnSeparator	Ottiene o imposta il tipo di separatore visivo per le colonne della tabella della legenda.
ItemColumnSeparatorColor	Ottiene o imposta il colore del separatore di colonna della tabella della legenda.
ItemColumnSpacing	Ottiene o imposta la spaziatura delle colonne della tabella della legenda.
LegendItemOrder	Ottiene o imposta un valore che specifica l'ordine di visualizzazione degli elementi della legenda. Questa proprietà ha effetto solo su elementi della legenda aggiunti automaticamente per la serie del grafico. Non ha effetto sugli elementi della legenda personalizzati.
LegendStyle	Ottiene o imposta lo stile della legenda.
MaximumAutoSize	Ottiene o imposta le dimensioni massime della legenda, espresse in percentuale rispetto all'area grafico. Questo valore viene utilizzato dall'algoritmo di layout automatico.
Name	Ottiene o imposta il nome della legenda.
Position	Ottiene o imposta un oggetto ElementPosition che può essere utilizzato per ottenere o impostare la posizione della legenda.
ShadowColor	Ottiene o imposta il colore dell'ombreggiatura della legenda.
ShadowOffset	Ottiene o imposta l'offset dell'ombreggiatura della legenda, espresso in pixel.
TableStyle	Ottiene o imposta lo stile della tabella della legenda.
Tag	Ottiene o imposta un oggetto associato all'elemento del grafico. (Ereditato da ChartElement)
TextWrapThreshold	Ottiene o imposta il numero di caratteri che è possibile visualizzare in sequenza nella legenda prima che il testo ritorni a capo.
Title	Ottiene o imposta il testo del titolo della legenda.
TitleAlignment	Ottiene o imposta l'allineamento del titolo della legenda.
TitleBackColor	Ottiene o imposta il colore di sfondo del titolo della legenda.
TitleFont	Ottiene o imposta il tipo di carattere per il titolo della legenda.
TitleForeColor	Ottiene o imposta il colore del testo del titolo della legenda.
TitleSeparator	Ottiene o imposta il tipo di separatore visivo per il titolo della legenda.
TitleSeparatorColor	Ottiene o imposta il colore del separatore del titolo della legenda.

Metodi

Dispose()	Rilascia le risorse usate da ChartElement. (Ereditato da ChartElement)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Legend e, facoltativamente, le risorse gestite.
Equals(Object)	Determina se l'oggetto Object specificato è uguale all'oggetto ChartElement corrente. (Ereditato da ChartElement)
GetHashCode()	Restituisce una funzione hash per un tipo specifico. (Ereditato da ChartElement)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto Object corrente. (Ereditato da ChartElement)