AxisScaleBreakStyle Classe

Définition

Espace de noms:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Représente un saut d’échelle sur l’axe Y du graphique.

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 saut d’échelle après l’ajout du Chart 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 sauts d’échelle sont des discontinuités intentionnelles sur l’axe Y qui sont les 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 élevées et faibles des données d’une série tracée. Les sauts d’échelle ne sont pas dessinés pour les différences entre les données de plusieurs séries.

Par défaut, les sauts d’échelle sont désactivés. Vous pouvez activer les sauts d’échelle sur l’axe Y en définissant la Enabled propriété truesur . Pour modifier la quantité d’espace vertical du saut d’échelle, vous pouvez spécifier une Spacing valeur. Cela est calculé en pourcentage de l’échelle de l’axe 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 saut 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 saut d’échelle mais qu’il n’apparaît pas, même s’il existe suffisamment de distance entre les plages de données, vous pouvez définir la CollapsibleSpaceThreshold propriété sur une valeur inférieure à 25.

Les graphiques prennent en charge jusqu’à cinq sauts d’échelle par graphique ; Toutefois, le graphique peut devenir illisible si vous affichez plusieurs sauts 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 sauts d’échelle qui peuvent être affichés sur le graphique.

Lorsqu’un saut d’échelle est utilisé, les étiquettes de l’axe Y peuvent devenir décalées. Pour désactiver le décalage d’étiquette, définissez la IsStaggered propriété sur false.

Les sauts d’échelle ne sont pas pris en charge dans l’une des conditions suivantes :

• Secteurs, anneau, entonnoir, pyramide, radial ou n’importe quel type de graphique empilé sont utilisés.

• Les intervalles personnalisés pour les étiquettes, les graduations ou les lignes de grille sont activés.

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

• Les étiquettes personnalisées sont utilisées.

• Un axe Y logarithmique est spécifié.

• Les vues d’axe sur l’axe Y, qui incluent le défilement et le zoom, sont utilisées.

• Les graphiques 3D sont utilisés.

Constructeurs

Nom	Description
AxisScaleBreakStyle()	Initialise une nouvelle instance de la classe AxisScaleBreakStyle.

Propriétés

Nom	Description
BreakLineStyle	Obtient ou définit le style de la ligne d’arrêt qui sera utilisée pour dessiner le saut d’échelle.
CollapsibleSpaceThreshold	Obtient ou définit le seuil d’espace sur le graphique auquel les sauts d’échelle sont dessinés.
Enabled	Obtient ou définit un indicateur qui indique si les sauts d’échelle sont activés.
LineColor	Obtient ou définit la couleur de la ligne de saut d’échelle.
LineDashStyle	Obtient ou définit le style de la ligne de saut d’échelle.
LineWidth	Obtient ou définit la largeur de la ligne de saut d’échelle.
MaxNumberOfBreaks	Obtient ou définit le nombre maximal de sauts d’échelle à afficher sur le graphique.
Spacing	Obtient ou définit l’espacement entre les lignes du saut d’échelle. L’espacement est représenté sous la forme d’un pourcentage de l’axe Y.
StartFromZero	Obtient ou définit une StartFromZero valeur d’énumération qui indique s’il faut démarrer le saut d’échelle de zéro.

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)