AxisScaleBreakStyle Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.DataVisualization.Charting

Assembly:: System.Web.DataVisualization.dll

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 un cambio 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 controllo Chart 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 discontinuità intenzionali sull'asse Y usate più spesso per ridistribuire i punti dati in una serie in un grafico. Questa funzionalità migliora la leggibilità in caso di grandi differenze tra i valori alti e bassi dei dati in una serie tracciata. 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.

È necessario disporre di una separazione sufficiente tra intervalli di punti dati in una singola serie per disegnare un'interruzione di scala. 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 è presente una distanza sufficiente tra gli intervalli di dati, è possibile impostare la proprietà su un valore minore CollapsibleSpaceThreshold di 25.

I grafici supportano fino a cinque interruzioni di scala per ogni grafico. Tuttavia, il grafico può diventare illeggibile se si visualizzano più interruzioni di scala. Se si dispone di più di due intervalli di dati, usare un metodo diverso per la visualizzazione di tali dati. Usare la proprietà per ridurre il numero di interruzioni di scala che MaxNumberOfBreaks 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, IsStaggered impostare la proprietà su false .

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

Vengono usati tipi di grafico a torta, ad anello, a imbuto, a piramide, radiale o in pila.
Gli intervalli personalizzati per etichette, segni di graduazione o linee della griglia sono abilitati.
Il valore minimo o massimo per l'asse è impostato.
Vengono usate etichette personalizzate.
Viene specificato un asse Y logaritmico.
Vengono usate le viste asse sull'asse Y, che includono lo scorrimento e lo zoom.
Vengono usati grafici 3D.

Costruttori

AxisScaleBreakStyle()

Inizializza una nuova istanza della classe AxisScaleBreakStyle.

Proprietà

BreakLineStyle	Ottiene o imposta lo stile della linea di interruzione che verrà utilizzata per disegnare il cambio di scala.
CollapsibleSpaceThreshold	Ottiene o imposta la soglia di spazio sul grafico in cui vengono disegnati i cambi di scala.
Enabled	Ottiene o imposta un flag che indica se i cambi di scala sono abilitati.
LineColor	Ottiene o imposta il colore della linea di cambio di scala.
LineDashStyle	Ottiene o imposta lo stile della linea di cambio di scala.
LineWidth	Ottiene o imposta lo spessore della linea di cambio di scala.
MaxNumberOfBreaks	Ottiene o imposta il numero massimo di cambi di scala da visualizzare sul grafico.
Spacing	Ottiene o imposta la spaziatura tra le linee del cambio di scala. La spaziatura viene rappresentata come percentuale dell'asse Y.
StartFromZero	Ottiene o imposta un valore dell'enumerazione StartFromZero che indica se il cambio di scala deve iniziare da zero.

Metodi

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 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 corrente. (Ereditato da Object)

Si applica a