AxisScaleBreakStyle Klasse

Referenz

Definition

Namespace:: System.Web.UI.DataVisualization.Charting

Assembly:: System.Web.DataVisualization.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine Skalierungsunterbrechung auf der y-Achse des Diagramms dar.

public ref class AxisScaleBreakStyle

public class AxisScaleBreakStyle

type AxisScaleBreakStyle = class

Public Class AxisScaleBreakStyle

Vererbung: Object
AxisScaleBreakStyle

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie eine Skalierungsunterbrechung aktivieren und anpassen, nachdem das Chart Steuerelement der Entwurfsoberfläche hinzugefügt wurde.

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;  
}

Hinweise

Skalierungsunterbrechungen sind absichtliche Diskontinuitäten auf der Y-Achse, die am häufigsten verwendet werden, um die Datenpunkte in einer Reihe in einem Diagramm neu zu verteilen. Dieses Feature verbessert die Lesbarkeit, wenn es große Unterschiede zwischen den hohen und niedrigen Werten der Daten in einer gezeichneten Reihe gibt. Skalierungsunterbrechungen werden nicht für Unterschiede zwischen Daten in mehreren Reihen gezeichnet.

Skalierungsunterbrechungen sind standardmäßig deaktiviert. Sie können Skalierungsunterbrechungen auf der Y-Achse aktivieren, indem Sie die Enabled -Eigenschaft auf true festlegen. Um den vertikalen Abstand der Skalierungsunterbrechung zu ändern, können Sie einen Spacing Wert angeben. Dies wird als Prozentsatz der Y-Achsenskala berechnet.

Sie müssen über eine ausreichende Trennung zwischen Bereichen von Datenpunkten in einer einzelnen Reihe verfügen, um eine Skalierungsunterbrechung zu zeichnen. Standardmäßig kann eine Skalierungsunterbrechung nur hinzugefügt werden, wenn eine Trennung zwischen den Datenbereichen eines Diagramms mindestens 25 % ausmacht. Wenn Sie eine Skalierungsunterbrechung aktivieren, die jedoch nicht angezeigt wird, obwohl ausreichend Abstand zwischen den Datenbereichen besteht, können Sie die CollapsibleSpaceThreshold -Eigenschaft auf einen Wert kleiner als 25 festlegen.

Diagramme unterstützen bis zu fünf Skalierungsunterbrechungen pro Diagramm. Das Diagramm kann jedoch unlesbar werden, wenn Sie mehrere Skalierungsunterbrechungen anzeigen. Wenn Sie mehr als zwei Datenbereiche haben, sollten Sie erwägen, zum Anzeigen der Daten eine andere Methode zu verwenden. Verwenden Sie die MaxNumberOfBreaks -Eigenschaft, um die Anzahl der Skalierungsunterbrechungen zu reduzieren, die im Diagramm angezeigt werden können.

Wenn eine Skalierungsunterbrechung verwendet wird, werden die Bezeichnungen der Y-Achse möglicherweise versetzt. Um den Bezeichnungsoffset zu deaktivieren, legen Sie die IsStaggered -Eigenschaft auf false fest.

Skalierungsunterbrechungen werden unter keinen der folgenden Bedingungen unterstützt:

Es werden Kreis-, Ring-, Trichter-, Pyramiden-, radiale oder gestapelte Diagrammtypen verwendet.
Benutzerdefinierte Intervalle für Bezeichnungen, Teilstriche oder Rasterlinien sind aktiviert.
Der Mindest- oder Höchstwert für die Achse wird festgelegt.
Benutzerdefinierte Bezeichnungen werden verwendet.
Eine logarithmische Y-Achse wird angegeben.
Achsenansichten auf der Y-Achse, einschließlich Scrollen und Zoomen, werden verwendet.
Es werden 3D-Diagramme verwendet.

Konstruktoren

AxisScaleBreakStyle()

Initialisiert eine neue Instanz der AxisScaleBreakStyle-Klasse.

Eigenschaften

BreakLineStyle	Ruft den Stil der Unterbrechungslinie ab, mit der die Skalierungsunterbrechung gezeichnet wird, oder legt diesen fest.
CollapsibleSpaceThreshold	Ruft den Schwellenwert der Fläche im Diagramm ab, bei dem Skalierungsunterbrechungen gezeichnet werden, oder legt diesen fest.
Enabled	Ruft ein Flag ab, das angibt, ob Skalierungsunterbrechungen aktiviert sind, oder legt dieses fest.
LineColor	Ruft die Farbe der Skalierungsunterbrechungslinie ab oder legt diese fest.
LineDashStyle	Ruft den Stil der Skalierungsunterbrechungslinie ab oder legt diesen fest.
LineWidth	Ruft die Stärke der Skalierungsunterbrechungslinie ab oder legt diese fest.
MaxNumberOfBreaks	Ruft die maximale Anzahl von Skalierungsunterbrechungen ab, die im Diagramm angezeigt werden sollen, oder legt diese fest.
Spacing	Ruft den Abstand zwischen den Skalierungsunterbrechungslinien ab oder legt diesen fest. Der Abstand wird als Prozentsatz der y-Achse dargestellt.
StartFromZero	Ruft einen StartFromZero-Enumerationswert ab, der angibt, ob die Skalierungsunterbrechung bei 0 (null) begonnen werden soll, oder legt diesen fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für