ChartArea Classe

Definizione

Spazio dei nomi:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Rappresenta un'area del grafico nell'immagine del grafico.

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

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

type ChartArea = class
    inherit ChartNamedElement

Public Class ChartArea
Inherits ChartNamedElement

Ereditarietà

Object

ChartElement

ChartNamedElement

ChartArea

Commenti

All'interno di un determinato grafico, la posizione del tracciato interno è l'area rettangolare, all'interno delle linee dell'asse x e y, in cui vengono disegnati i punti dati. La posizione del tracciato è l'area rettangolare che comprende la posizione del tracciato interno, i segni di graduazione e le etichette dell'asse. L'area del grafico è l'area rettangolare che comprende la posizione del tracciato, i segni di graduazione, le etichette dell'asse e i titoli degli assi nel grafico.

Un'area del grafico è rappresentata da una ChartArea classe. ChartArea Gli oggetti vengono archiviati nella ChartAreaCollection classe .

Il numero di serie di grafici che è possibile tracciare in un'area del grafico è illimitato.

Oggetto ChartArea :

• Usa un'area di tracciato interna distinta.

• Viene utilizzato per tracciare una o più serie di grafici.

• Dispone di assi x e y primari e secondari, ad eccezione dei tipi di grafico a torta e ad anello.

Quando si usano tipi di grafico Shape, che includono grafici a torta, ad anello, a imbuto, a piramide, polare e radar, la posizione di tracciato interna definisce le dimensioni della forma del tipo di grafico. Ad esempio, quando si aumenta il valore della InnerPlotPosition proprietà in un grafico a torta, si aumenta il raggio della forma a torta.

Per tutti gli altri tipi di grafico, ogni area del grafico ha due set di assi X e Y, primari e secondari. Per accedere alle proprietà correlate a questi assi, usare le AxisXproprietà , AxisYAxisX2e AxisY2 . Se è necessario impostare una proprietà che influisce su tutti gli assi del grafico, utilizzare la Axes proprietà .

Una o più serie sono associate a un'area del grafico. La serie ha una ChartArea proprietà che determina l'area del grafico a cui appartiene ogni serie. Per impostazione predefinita, la serie è connessa all'area del grafico predefinita. Per disabilitare la visualizzazione di una serie, impostare la ChartArea proprietà di tale serie su una stringa di lunghezza zero.

Se al grafico viene aggiunta un'altra area del grafico, è possibile associare qualsiasi serie alla nuova area del grafico. In tutti i tipi di grafico Shape, nonché i tipi di grafico a barre e barre in pila, ogni serie deve essere tracciata in un'area del grafico separata. In tutti gli altri tipi di grafico, più serie possono essere combinate nella stessa area del grafico.

Un grafico 3D viene visualizzato in base all'area del grafico in base all'area del grafico. È possibile usare la Area3DStyle proprietà per abilitare e personalizzare il grafico in 3D.

L'area del grafico minima e massima non verrà ricalcolata automaticamente se si aggiungono nuovi dati, pertanto il grafico non modificherà automaticamente le dimensioni dell'asse. È possibile richiedere all'area del grafico di ricalcolare questi valori usando il RecalculateAxesScale metodo .

Per allineare verticalmente più aree del grafico, impostare la AlignmentOrientation proprietà . Per allineare più aree del grafico orizzontalmente, è prima necessario posizionare le aree del grafico usando la Position proprietà e quindi impostare la AlignmentOrientation proprietà su Horizontal.

Per eliminare la visualizzazione di una serie, impostare la Series proprietà di tale serie su una stringa di lunghezza zero.

Costruttori

Nome	Descrizione
ChartArea()	Inizializza una nuova istanza della classe ChartArea.
ChartArea(String)	Inizializza una nuova istanza della ChartArea classe con il nome dell'area del grafico specificato.

Proprietà

Nome	Descrizione
AlignmentOrientation	Ottiene o imposta l'orientamento dell'allineamento di un'area del grafico.
AlignmentStyle	Ottiene o imposta lo stile di allineamento dell'oggetto ChartArea.
AlignWithChartArea	Ottiene o imposta il nome dell'oggetto a cui deve essere allineata l'area ChartArea del grafico.
Area3DStyle	Ottiene o imposta un ChartArea3DStyle oggetto , utilizzato per implementare una serie tridimensionale (3D) per tutte le serie in un'area del grafico.
Axes	Ottiene o imposta una matrice che rappresenta tutti gli assi per un'area del grafico.
AxisX	Ottiene o imposta un Axis oggetto che rappresenta l'asse X primario.
AxisX2	Ottiene o imposta un Axis oggetto che rappresenta l'asse X secondario.
AxisY	Ottiene o imposta un Axis oggetto che rappresenta l'asse Y primario.
AxisY2	Ottiene o imposta un Axis oggetto che rappresenta l'asse Y secondario.
BackColor	Ottiene o imposta il colore di sfondo di un ChartArea oggetto .
BackGradientStyle	Ottiene o imposta l'orientamento per la sfumatura di sfondo di un'area del grafico e determina anche se viene utilizzata o meno una sfumatura.
BackHatchStyle	Ottiene o imposta lo stile di tratteggio di un ChartArea oggetto .
BackImage	Ottiene o imposta l'immagine di sfondo di un ChartArea oggetto .
BackImageAlignment	Ottiene o imposta l'allineamento di un'immagine ChartArea di sfondo.
BackImageTransparentColor	Ottiene o imposta il colore di un'immagine ChartArea di sfondo dell'oggetto che verrà disegnata come trasparente.
BackImageWrapMode	Ottiene o imposta la modalità di disegno per l'immagine di sfondo di un ChartArea oggetto .
BackSecondaryColor	Ottiene o imposta il colore secondario per lo sfondo di un ChartArea oggetto .
BorderColor	Ottiene o imposta il colore del bordo di un ChartArea oggetto .
BorderDashStyle	Ottiene o imposta lo stile del bordo di un ChartArea oggetto .
BorderWidth	Ottiene o imposta la larghezza del bordo di un ChartArea oggetto .
CursorX	Ottiene o imposta un Cursor oggetto utilizzato per i cursori e gli intervalli selezionati lungo l'asse X.
CursorY	Ottiene o imposta un Cursor oggetto utilizzato per i cursori e gli intervalli selezionati lungo l'asse Y.
InnerPlotPosition	Ottiene o imposta un ElementPosition oggetto che definisce la posizione interna del tracciato di un oggetto area del grafico.
IsSameFontSizeForAllAxes	Ottiene o imposta un flag che determina se le etichette degli assi dell'area del grafico pertinenti sono di dimensioni uguali.
Name	Ottiene o imposta il nome univoco di un ChartArea oggetto .
Position	Ottiene o imposta un ElementPosition oggetto che definisce la posizione di un ChartArea oggetto all'interno di Chart.
ShadowColor	Ottiene o imposta il colore dell'ombreggiatura di un ChartArea oggetto .
ShadowOffset	Ottiene o imposta l'offset dell'ombreggiatura, in pixel, di un ChartArea oggetto .
Tag	Ottiene o imposta un oggetto associato a questo elemento del grafico. (Ereditato da ChartElement)
Visible	Ottiene o imposta un flag che determina se un'area del grafico è visibile.

Metodi

Nome	Descrizione
Dispose()	Rilascia le risorse usate da ChartElement. (Ereditato da ChartElement)
Dispose(Boolean)	Rilascia risorse gestite e, facoltativamente, non 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)
GetSeriesDepth(Series)	Restituisce la profondità di un Series oggetto in un'area del grafico.
GetSeriesZPosition(Series)	Restituisce la posizione Z di una serie, utile per il disegno personalizzato.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
RecalculateAxesScale()	Ricalcola le proprietà dell'area del grafico dopo che sono state apportate modifiche al grafico nell'evento Customize .
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente Object. (Ereditato da ChartElement)
TransformPoints(Point3D[])	Applica trasformazioni 3D a una matrice di punti 3D, che deve essere eseguita prima che i metodi di disegno GDI+ possano essere chiamati.