Condividi tramite


Legend Classe

Definizione

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à

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)

Si applica a