AxisScaleBreakStyle Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.DataVisualization.Charting

Ensamblado:: System.Web.DataVisualization.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un quiebre de escala en el eje Y del gráfico.

public ref class AxisScaleBreakStyle

public class AxisScaleBreakStyle

type AxisScaleBreakStyle = class

Public Class AxisScaleBreakStyle

Herencia: Object
AxisScaleBreakStyle

Ejemplos

En el ejemplo de código siguiente se muestra cómo habilitar y personalizar un salto de escala después de agregar el control a Chart la superficie de diseño.

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

Comentarios

Los saltos de escala son discontinuidades intencionadas en el eje Y que se usan con más frecuencia para redistribuir los puntos de datos de una serie en un gráfico. Esta característica mejora la legibilidad cuando hay grandes diferencias entre los valores altos y bajos de los datos de una serie que se está trazando. Los saltos de escala no se dibujan para las diferencias entre los datos de varias series.

De forma predeterminada, los saltos de escala están deshabilitados. Puede habilitar los saltos de escala en el eje Y estableciendo la Enabled propiedad en true . Para cambiar la cantidad de espacio vertical del salto de escala, puede especificar un Spacing valor. Esto se calcula como un porcentaje de la escala del eje Y.

Debe tener suficiente separación entre los intervalos de puntos de datos de una sola serie para dibujar un quiebre de escala. De forma predeterminada, solo se puede agregar un quiebre de escala si existe una separación entre los intervalos de datos de al menos el 25% del gráfico. Si habilita un salto de escala pero no aparece, aunque haya suficiente distancia entre los intervalos de datos, puede establecer la propiedad en un valor inferior CollapsibleSpaceThreshold a 25.

Los gráficos admiten hasta cinco saltos de escala por gráfico; sin embargo, el gráfico puede volverse ilegible si se muestra más de un quiebre de escala. Si tiene más de dos intervalos de datos, considere la posibilidad de usar un método diferente para mostrarlos. Use la MaxNumberOfBreaks propiedad para reducir el número de saltos de escala que se pueden mostrar en el gráfico.

Cuando se usa un quiebre de escala, las etiquetas del eje Y pueden convertirse en desplazamiento. Para deshabilitar el desplazamiento de etiqueta, establezca la IsStaggered propiedad en false .

Los saltos de escala no se admiten en ninguna de las condiciones siguientes:

Se usan circulares, anillos, embudo, piramidales, radiales o cualquier tipo de gráfico apilado.
Se habilitan intervalos personalizados para etiquetas, marcas de graduación o líneas de cuadrícula.
Se establece el valor mínimo o máximo del eje.
Se usan etiquetas personalizadas.
Se especifica un eje Y logarítmico.
Se usan vistas de eje en el eje Y, que incluyen desplazamiento y zoom.
Se usan gráficos 3D.

Constructores

AxisScaleBreakStyle()

Inicializa una nueva instancia de la clase AxisScaleBreakStyle.

Propiedades

BreakLineStyle	Obtiene o establece el estilo de la línea de quiebre que se va a usar para dibujar el quiebre de escala.
CollapsibleSpaceThreshold	Obtiene o establece el umbral de espacio en el gráfico en el que se dibujan los quiebres de escala.
Enabled	Obtiene o establece una marca que indica si los quiebres de escala están habilitados.
LineColor	Obtiene o establece el color de la línea de quiebre de escala.
LineDashStyle	Obtiene o establece el estilo de la línea de quiebre de escala.
LineWidth	Obtiene o establece el ancho de la línea de quiebre de escala.
MaxNumberOfBreaks	Obtiene o establece el número máximo de quiebres de escala que se van a mostrar en el gráfico.
Spacing	Obtiene o establece el espaciado entre las líneas del quiebre de escala. El espaciado se representa como un porcentaje del eje Y.
StartFromZero	Obtiene o establece un valor de enumeración StartFromZero que indica si el quiebre de escala va a empezar en cero.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Se aplica a

Compartir a través de