ChartArea Classe

Definizione

Spazio dei nomi:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Rappresenta un'area 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 qualsiasi grafico specificato, la posizione del tracciato interno è l'area rettangolare, all'interno delle linee x e asse y, dove vengono disegnati i punti dati. La posizione del tracciato è l'area rettangolare che comprende la posizione del tracciato interno, i segni di spunta e le etichette dell'asse. L'area del grafico è l'area rettangolare che comprende la posizione del tracciato, i segni di spunta, le etichette dell'asse e i titoli dell'asse nel grafico.

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

Il numero di serie di grafici che possono essere tracciati in un'area del grafico è illimitato.

Oggetto ChartArea :

• Usa un'area di tracciamento interno distinta.

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

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

Quando si usano tipi di grafico Shape, che includono torta, anello, imbuto, piramide, polare e grafici radar, la posizione di tracciato interno 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 aumenterà il raggio della forma a torta.

Per tutti gli altri tipi di grafico, ogni area del grafico include due set di assi X e Y, primario e secondario. 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, usare 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 un'altra area del grafico viene aggiunta al 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 è possibile combinare più serie nella stessa area del grafico.

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

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

Per allineare più aree del grafico in verticale, impostare la AlignmentOrientation proprietà. Per allineare più aree del grafico in orizzontale, è prima necessario posizionare le aree del grafico usando la Position proprietà e quindi impostare la AlignmentOrientation proprietà su Orizzontale.

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

Costruttori

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

Proprietà

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

Metodi

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