AxisScaleBreakStyle Classe

Référence

Définition

Espace de noms:: System.Web.UI.DataVisualization.Charting

Assembly:: System.Web.DataVisualization.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente un changement 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 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

AxisScaleBreakStyle()

Initialise une nouvelle instance de la classe AxisScaleBreakStyle.

Propriétés

BreakLineStyle	Obtient ou définit le style de la ligne de changement qui sera utilisée pour dessiner le changement d'échelle.
CollapsibleSpaceThreshold	Obtient ou définit le seuil d'espace du graphique au niveau duquel les changements d'échelle sont dessinés.
Enabled	Obtient ou définit un indicateur qui détermine si les changements d'échelle sont activés.
LineColor	Obtient ou définit la couleur de la ligne de changement d'échelle.
LineDashStyle	Obtient ou définit le style de la ligne de changement d'échelle.
LineWidth	Obtient ou définit la largeur de la ligne de changement d'échelle.
MaxNumberOfBreaks	Obtient ou définit le nombre maximal de changements d'échelle à afficher sur le graphique.
Spacing	Obtient ou définit l'intervalle d'espacement entre les lignes du changement d'échelle. L'intervalle d'espacement est représenté sous la forme d'un pourcentage de l'axe Y.
StartFromZero	Obtient ou définit une valeur d'énumération StartFromZero qui indique si le changement d'échelle doit commencer à partir de zéro.

Méthodes

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

S’applique à