AxisScaleBreakStyle Classe

Définition

public ref class AxisScaleBreakStyle

public class AxisScaleBreakStyle

type AxisScaleBreakStyle = class

Public Class AxisScaleBreakStyle

Héritage

Object

AxisScaleBreakStyle

Exemples

L’exemple de code suivant montre comment activer et personnaliser un arrêt de l’échelle après l' Chart Ajout du contrôle à l’aire de conception.

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

Remarques

Les séparations d’échelle sont des discontinuités intentionnelles sur l’axe des Y qui sont le plus souvent utilisées pour redistribuer les points de données d’une série sur un graphique. Cette fonctionnalité améliore la lisibilité lorsqu’il existe de grandes différences entre les valeurs haute et basse des données dans une série en cours de traçage. Les séparations d’échelle ne sont pas dessinées pour les différences entre les données de plusieurs séries.

Par défaut, les séparations d’échelle sont désactivées. Vous pouvez activer les séparations d’échelle sur l’axe des Y en affectant à la propriété la valeur Enabled true . Pour modifier la quantité d’espace vertical de la séparation d’échelle, vous pouvez spécifier une Spacing valeur. Ce pourcentage est calculé sous la forme d’un pourcentage de l’échelle de l’axe des Y.

Vous devez disposer d’une séparation suffisante entre les plages de points de données d’une série unique pour dessiner un séparateur d’échelle. Par défaut, un séparateur d'échelle ne peut être ajouté que si la séparation entre les plages de données représente au moins 25 % du graphique. Si vous activez un séparateur d’échelle, mais qu’il n’apparaît pas, bien qu’il y ait suffisamment de distance entre les plages de données, vous pouvez affecter CollapsibleSpaceThreshold à la propriété une valeur inférieure à 25.

Les graphiques prennent en charge jusqu’à cinq séparateurs d’échelle par graphique ; Toutefois, le graphique peut devenir illisible si vous affichez plusieurs séparations d’échelle. Si vous disposez de plusieurs plages de données, envisagez d'utiliser une méthode différente pour afficher ces données. Utilisez la MaxNumberOfBreaks propriété pour réduire le nombre de séparateurs d’échelle qui peuvent être affichés sur le graphique.

Lorsqu’un séparateur d’échelle est utilisé, les étiquettes de l’axe des Y peuvent devenir décalées. Pour désactiver le décalage de l’étiquette, affectez à la propriété la valeur IsStaggered false .

Les séparations d’échelle ne sont pas prises en charge dans les conditions suivantes :

• Les graphiques à secteurs, en anneau, en entonnoir, en pyramide, radials ou tout graphique empilé sont utilisés.

• Les intervalles personnalisés pour les étiquettes, les graduations ou les quadrillages sont activés.

• La valeur minimale ou maximale de l’axe est définie.

• Les légendes personnalisées sont utilisées.

• Un axe Y logarithmique est spécifié.

• Les vues de l’axe sur l’axe des Y, notamment le défilement et le zoom, sont utilisées.

• les graphiques 3D sont utilisés.

Constructeurs

Propriétés

Méthodes

S’applique à