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 .
Per un'immagine del grafico può essere presente un numero qualsiasi di legende.
Le legende possono:
Essere ancorati e allineati.
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 sfumature e immagini di sfondo.
Essere ridimensionato e posizionato 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à .
Per impostazione predefinita, 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 per questi elementi predefiniti può essere modificato usando la LegendText proprietà . Questa proprietà consentirà 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à , il testo della legenda verrà impostato anche 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 al numero di caratteri che possono essere visualizzati su una riga prima che il testo venga racchiuso 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. Viene visualizzato un puntino di sospensione per indicare che sono presenti più voci rispetto alla legenda con spazio. Per evitare che gli elementi della legenda vengano troncati, impostare la posizione e le dimensioni della legenda utilizzando 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 ha 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 utilizzando 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 utilizzata 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
| Nome | Descrizione |
|---|---|
| Legend() |
Inizializza una nuova istanza della classe Legend. |
| Legend(String) |
Inizializza una nuova istanza della classe con il nome della Legend legenda specificato. |
Proprietà
| Nome | Descrizione |
|---|---|
| Alignment |
Ottiene o imposta l'allineamento della legenda. |
| AutoFitMinFontSize |
Ottiene o imposta la dimensione minima del carattere che può essere utilizzata dall'algoritmo di correzione automatica per il testo della legenda. |
| BackColor |
Ottiene o imposta il colore di sfondo di una 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 di 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 Unscaled modalità di disegno. |
| BackImageTransparentColor |
Ottiene o imposta un colore che verrà sostituito con un colore trasparente quando viene 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 di uno sfondo della legenda. |
| BorderColor |
Ottiene o imposta il colore del bordo di una legenda. |
| BorderDashStyle |
Ottiene o imposta lo stile del bordo di una legenda. |
| BorderWidth |
Ottiene o imposta la larghezza del bordo di una legenda. |
| CellColumns |
Ottiene l'oggetto contenente l'insieme LegendCellColumnCollection di colonne di cella per una legenda. |
| CustomItems |
Ottiene un LegendItemsCollection oggetto utilizzato per gli elementi della legenda personalizzati. |
| DockedToChartArea |
Ottiene o imposta il nome dell'oggetto ChartArea in cui verrà 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 Font oggetto utilizzato per impostare le proprietà del tipo di 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'area del grafico in cui viene disegnata la legenda. |
| InterlacedRows |
Ottiene o imposta un flag che indica se le righe della legenda verranno disegnate con 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 del grafico. |
| IsEquallySpacedItems |
Ottiene o imposta un flag che indica se tutti gli elementi della legenda sono ugualmente spaziati. |
| IsTextAutoFit |
Ottiene o imposta un flag 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 in cui vengono visualizzati gli elementi della legenda. Questa proprietà influisce solo sugli elementi della legenda aggiunti automaticamente per la serie di grafici; non ha alcun effetto sugli elementi della legenda personalizzati. |
| LegendStyle |
Ottiene o imposta lo stile della legenda. |
| MaximumAutoSize |
Ottiene o imposta la dimensione massima della legenda, misurata come percentuale dell'area del grafico. Questo valore viene usato dall'algoritmo di layout automatico. |
| Name |
Ottiene o imposta il nome della legenda. |
| Position |
Ottiene o imposta un ElementPosition oggetto 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, in pixel, della legenda. |
| TableStyle |
Ottiene o imposta lo stile della tabella della legenda. |
| Tag |
Ottiene o imposta un oggetto associato a questo elemento del grafico. (Ereditato da ChartElement) |
| TextWrapThreshold |
Ottiene o imposta il numero di caratteri che possono essere visualizzati in sequenza nella legenda prima del wrapping del testo. |
| 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
| Nome | Descrizione |
|---|---|
| Dispose() |
Rilascia le risorse usate da ChartElement. (Ereditato da ChartElement) |
| Dispose(Boolean) |
Rilascia le risorse non gestite usate da Legend e, facoltativamente, rilascia le risorse gestite. |
| Equals(Object) |
Determina se l'oggetto specificato Object è uguale all'oggetto corrente ChartElement. (Ereditato da ChartElement) |
| GetHashCode() |
Restituisce una funzione hash per un tipo specifico. (Ereditato da ChartElement) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente Object. (Ereditato da ChartElement) |
