AxisScaleBreakStyle Classe

Definição

public ref class AxisScaleBreakStyle

public class AxisScaleBreakStyle

type AxisScaleBreakStyle = class

Public Class AxisScaleBreakStyle

Herança

Object

AxisScaleBreakStyle

Exemplos

O exemplo de código seguinte demonstra como ativar e personalizar uma quebra de escala depois de o Chart controlo ter sido adicionado à superfície de design.

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

Observações

Quebras de escala são descontinuidades intencionais no eixo Y que são mais frequentemente usadas para redistribuir os pontos de dados numa série num gráfico. Esta funcionalidade melhora a legibilidade quando existem grandes diferenças entre os valores altos e baixos dos dados numa série que está a ser representada. As quebras de escala não são desenhadas para diferenças entre dados em múltiplas séries.

Por defeito, as quebras de balança estão desativadas. Pode ativar quebras de escala no eixo Y definindo a Enabled propriedade para true. Para alterar a quantidade de espaço vertical da quebra de escala, pode especificar um Spacing valor. Isto é calculado como uma percentagem da escala do eixo Y.

Deve haver separação suficiente entre intervalos de pontos de dados numa única série para traçar uma quebra de escala. Por padrão, uma quebra de escala só pode ser adicionada se houver uma separação entre os intervalos de dados de pelo menos 25% do gráfico. Se ativar uma quebra de escala mas ela não aparecer, mesmo havendo distância suficiente entre os intervalos de dados, pode definir a CollapsibleSpaceThreshold propriedade para um valor inferior a 25.

Os gráficos suportam até cinco quebras de escala por gráfico; no entanto, o gráfico pode tornar-se ilegível se apresentar mais do que uma quebra de escala. Se você tiver mais de dois intervalos de dados, considere usar um método diferente para exibir esses dados. Use a MaxNumberOfBreaks propriedade para reduzir o número de quebras de escala que podem ser exibidas no gráfico.

Quando é usada uma quebra de escala, os rótulos do eixo Y podem ficar deslocados. Para desativar o deslocamento de etiquetas, defina a IsStaggered propriedade para false.

Quebras de escala não são suportadas em nenhuma das seguintes condições:

• São usados tipos de tarte, donut, funil, pirâmide, radial ou qualquer tipo de gráfico empilhado.

• Intervalos personalizados para etiquetas, marcas de assinalação ou linhas de grelha estão ativados.

• O valor mínimo ou máximo para o eixo é definido.

• São usadas etiquetas personalizadas.

• É especificado um eixo Y logarítmico.

• São usadas vistas de eixo no eixo Y, que incluem scroll e zoom.

• São usados gráficos 3D.