Legend Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta la legenda per l'immagine del grafico.
public ref class Legend : System::Windows::Forms::DataVisualization::Charting::ChartNamedElementpublic class Legend : System.Windows.Forms.DataVisualization.Charting.ChartNamedElementtype Legend = class
inherit ChartNamedElementPublic Class Legend
Inherits ChartNamedElement- Ereditarietà
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) |
