AxisScaleBreakStyle Classe

Definição

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Representa uma quebra de escala no eixo Y do gráfico.

public ref class AxisScaleBreakStyle

public class AxisScaleBreakStyle

type AxisScaleBreakStyle = class

Public Class AxisScaleBreakStyle

Herança

Object

AxisScaleBreakStyle

Exemplos

O exemplo de código a seguir demonstra como habilitar e personalizar uma quebra de escala após o Chart controle 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;
}

Comentários

Quebras de escala são descontinuidades intencionais no eixo Y que geralmente são usadas para redistribuir os pontos de dados em uma série em um gráfico. Esse recurso melhora a legibilidade quando há grandes diferenças entre os valores altos e baixos dos dados em uma série que está sendo plotada. As quebras de escala não são desenhadas para diferenças entre dados em várias séries.

Por padrão, as quebras de escala são desabilitadas. Você pode habilitar quebras de escala no eixo Y definindo a Enabled propriedade como true. Para alterar a quantidade de espaço vertical da quebra de escala, você pode especificar um Spacing valor. Isso é calculado como uma porcentagem da escala do eixo Y.

Você deve ter separação suficiente entre intervalos de pontos de dados em uma única série para desenhar uma quebra de escala. Por padrão, a quebra de escala poderá ser adicionada somente se houver uma separação entre os intervalos de dados de pelo menos 25% do gráfico. Se você habilitar uma quebra de escala, mas ela não aparecer, mesmo que haja distância suficiente entre os intervalos de dados, você poderá definir a CollapsibleSpaceThreshold propriedade como um valor menor que 25.

Os gráficos dão suporte a até cinco quebras de escala por gráfico; no entanto, o gráfico poderá se tornar ilegível se você exibir mais de uma quebra de escala. Se houver dois ou mais intervalos de dados, considere o uso de outro método 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 uma quebra de escala é usada, os rótulos do eixo Y podem se tornar deslocados. Para desabilitar o deslocamento de rótulo, defina a IsStaggered propriedade como false.

Não há suporte para quebras de escala em nenhuma das seguintes condições:

• Pizza, rosca, funil, pirâmide, radial ou qualquer tipo de gráfico empilhado são usados.

• Intervalos personalizados para rótulos, marcas de escala ou linhas de grade estão habilitados.

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

• Rótulos personalizados são usados.

• Um eixo Y logarítmico é especificado.

• As exibições de eixo no eixo Y, que incluem rolagem e zoom, são usadas.

• Gráficos 3D são usados.

Construtores

Nome	Description
AxisScaleBreakStyle()	Inicializa uma nova instância da classe AxisScaleBreakStyle.

Propriedades

Nome	Description
BreakLineStyle	Obtém ou define o estilo da linha de interrupção que será usada para desenhar a quebra de escala.
CollapsibleSpaceThreshold	Obtém ou define o limite de espaço no gráfico no qual as quebras de escala são desenhadas.
Enabled	Obtém ou define um sinalizador que indica se as quebras de escala estão habilitadas.
LineColor	Obtém ou define a cor da linha de interrupção de escala.
LineDashStyle	Obtém ou define o estilo da linha de quebra de escala.
LineWidth	Obtém ou define a largura da linha de quebra de escala.
MaxNumberOfBreaks	Obtém ou define o número máximo de quebras de escala a serem exibidas no gráfico.
Spacing	Obtém ou define a lacuna de espaçamento entre as linhas da quebra de escala. A lacuna de espaçamento é representada como um percentual do eixo Y.
StartFromZero	Obtém ou define um StartFromZero valor de enumeração que indica se deve iniciar a quebra de escala a partir de zero.

Métodos

Nome	Description
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)