AxisScaleBreakStyle Classe

Definizione

Spazio dei nomi:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Rappresenta un'interruzione di scala sull'asse Y del grafico.

public ref class AxisScaleBreakStyle

public class AxisScaleBreakStyle

type AxisScaleBreakStyle = class

Public Class AxisScaleBreakStyle

Ereditarietà

Object

AxisScaleBreakStyle

Esempio

Nell'esempio di codice seguente viene illustrato come abilitare e personalizzare un'interruzione di scala dopo l'aggiunta del Chart controllo all'area di progettazione.

Imports System.Web.UI.DataVisualization.Charting

Private Function AddChartData()

    chart1.Series("Default").Points.Add(New DataPoint(1, 2))
    chart1.Series("Default").Points.Add(New DataPoint(2, 4))
    chart1.Series("Default").Points.Add(New DataPoint(3, 400000))
    chart1.Series("Default").Points.Add(New DataPoint(4, 3))

End Sub

Private Function AddScaleBreaks()

   ' Enable scale breaks.
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.Enabled = True

   ' Show scale break if more than 25% of the chart is empty space.
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.CollapsibleSpaceThreshold = 25

   ' Set the line width of the scale break.
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.LineWidth = 2

   ' Set the color of the scale break.
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.LineColor = Color.Red

   ' If all data points are significantly far from zero, the chart will calculate the scale minimum value.
   chart1.ChartAreas("Default").AxisY.ScaleBreakStyle.StartFromZero = StartFromZero.Auto

   ' Set the spacing gap between the lines of the scale break (as a percentage of the Y-axis).
   chart1.ChartAreas["Default"].AxisY.ScaleBreakStyle.Spacing = 2;

End Function

using System.Web.UI.DataVisualization.Charting

private void AddChartData()
{
   chart1.Series["Series1"].Points.Add(new DataPoint(1, 2));
   chart1.Series["Series1"].Points.Add(new DataPoint(2, 4));
   chart1.Series["Series1"].Points.Add(new DataPoint(3, 400000));
   chart1.Series["Series1"].Points.Add(new DataPoint(4, 3));
}

private void AddScaleBreaks()
{
   // Enable scale breaks.
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.Enabled = true;

   // Show scale break if more than 25% of the chart is empty space.
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.CollapsibleSpaceThreshold = 25;

   // Set the line width of the scale break.
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.LineWidth = 2;

   // Set the color of the scale break.
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.LineColor = Color.Red;

   // If all data points are significantly far from zero, the chart will calculate the scale minimum value.
   chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.StartFromZero = StartFromZero.Auto;

   // Set the spacing gap between the lines of the scale break (as a percentage of the Y-axis).
    chart1.ChartAreas["ChartArea1"].AxisY.ScaleBreakStyle.Spacing = 2;
}

Commenti

Le interruzioni di scala sono interruzioni intenzionali sull'asse Y usate più spesso per ridistribuire i punti dati in una serie in un grafico. Questa funzionalità migliora la leggibilità quando sono presenti grandi differenze tra i valori alti e bassi dei dati in una serie da tracciare. Le interruzioni di scala non vengono disegnate per le differenze tra i dati in più serie.

Per impostazione predefinita, le interruzioni di scala sono disabilitate. È possibile abilitare le interruzioni di scala sull'asse Y impostando la Enabled proprietà su true. Per modificare la quantità di spazio verticale dell'interruzione di scala, è possibile specificare un Spacing valore. Questo valore viene calcolato come percentuale della scala dell'asse Y.

Per disegnare un'interruzione di scala, è necessario disporre di una separazione sufficiente tra intervalli di punti dati in una singola serie. Per impostazione predefinita, un cambio di scala può essere aggiunto solo se è presente una separazione tra gli intervalli di dati pari ad almeno il 25% del grafico. Se si abilita un'interruzione di scala ma non viene visualizzata, anche se esiste una distanza sufficiente tra gli intervalli di dati, è possibile impostare la CollapsibleSpaceThreshold proprietà su un valore minore di 25.

I grafici supportano fino a cinque interruzioni di scala per grafico; Tuttavia, il grafico può diventare illeggibile se si visualizzano più di un'interruzione di scala. Se si dispone di più di due intervalli di dati, usare un metodo diverso per la visualizzazione di tali dati. Utilizzare la MaxNumberOfBreaks proprietà per ridurre il numero di interruzioni di scala che possono essere visualizzate nel grafico.

Quando si usa un'interruzione di scala, le etichette dell'asse Y possono diventare offset. Per disabilitare l'offset dell'etichetta, impostare la IsStaggered proprietà su false.

Le interruzioni di scala non sono supportate in una delle condizioni seguenti:

• Vengono utilizzati torta, anello, imbuto, piramide, radiale o qualsiasi tipo di grafico in pila.

• Sono abilitati intervalli personalizzati per etichette, segni di graduazione o linee della griglia.

• Viene impostato il valore minimo o massimo per l'asse.

• Vengono usate etichette personalizzate.

• Viene specificato un asse Y logaritmico.

• Vengono utilizzate le visualizzazioni asse sull'asse Y, che includono lo scorrimento e lo zoom.

• Vengono usati grafici 3D.

Costruttori

Nome	Descrizione
AxisScaleBreakStyle()	Inizializza una nuova istanza della classe AxisScaleBreakStyle.

Proprietà

Nome	Descrizione
BreakLineStyle	Ottiene o imposta lo stile della linea di interruzione che verrà utilizzata per disegnare l'interruzione di scala.
CollapsibleSpaceThreshold	Ottiene o imposta la soglia di spazio nel grafico in corrispondenza del quale vengono disegnate le interruzioni di scala.
Enabled	Ottiene o imposta un flag che indica se le interruzioni di scala sono abilitate.
LineColor	Ottiene o imposta il colore della linea di interruzione di scala.
LineDashStyle	Ottiene o imposta lo stile della linea di interruzione di scala.
LineWidth	Ottiene o imposta la larghezza della linea di interruzione di scala.
MaxNumberOfBreaks	Ottiene o imposta il numero massimo di interruzioni di scala da visualizzare nel grafico.
Spacing	Ottiene o imposta la spaziatura tra le righe dell'interruzione di scala. La spaziatura è rappresentata come percentuale dell'asse Y.
StartFromZero	Ottiene o imposta un StartFromZero valore di enumerazione che indica se avviare l'interruzione di scala da zero.

Metodi

Nome	Descrizione
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
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. (Ereditato da Object)