AxisScaleBreakStyle Classe

Referência

Definição

Namespace:: System.Web.UI.DataVisualization.Charting

Assembly:: System.Web.DataVisualization.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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 depois que o controle Chart foi 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 são usadas com mais frequência para redistribuir os pontos de dados em uma série em um gráfico. Esse recurso melhora a capacidade de leitura 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 os 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 um percentual 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 propriedade como um valor menor CollapsibleSpaceThreshold que 25.

Os gráficos suportam 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 deslocamento. Para desabilitar o deslocamento do rótulo, de definir IsStaggered a 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 para o 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

AxisScaleBreakStyle()

Inicializa uma nova instância da classe AxisScaleBreakStyle.

Propriedades

BreakLineStyle	Obtém ou define o estilo da linha de quebra 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 os quebras de escala estão habilitados.
LineColor	Obtém ou define a cor da linha de quebra 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 o intervalo de espaçamento entre as linhas de quebra de escala. O intervalo de espaçamento é representado como um percentual do eixo Y.
StartFromZero	Obtém ou define um valor de enumeração StartFromZero que indica se deve iniciar a quebra de escala a partir do zero.

Métodos

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 Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Compartilhar via