ChartArea Classe

  • Referência

Definição

Namespace:
System.Windows.Forms.DataVisualization.Charting
Assembly:
System.Windows.Forms.DataVisualization.dll

Representa uma área na imagem do gráfico.

public ref class ChartArea : System::Windows::Forms::DataVisualization::Charting::ChartNamedElement
public class ChartArea : System.Windows.Forms.DataVisualization.Charting.ChartNamedElement
type ChartArea = class
    inherit ChartNamedElement
Public Class ChartArea
Inherits ChartNamedElement
Herança
Object
ChartElement
ChartNamedElement
ChartArea

Comentários

Em qualquer determinado gráfico, a posição do gráfico interno é a área retangular, dentro das linhas dos eixos x e y, em que os pontos de dados são desenhados. A posição do gráfico é a área retangular que abrange a posição do gráfico interno, as marcas de escala e os rótulos do eixo. A área do gráfico é a área retangular que abrange a posição do gráfico, as marcas de escala, os rótulos dos eixos e os títulos do eixo no gráfico.

Uma área de gráfico é representada por uma ChartArea classe; ChartArea os objetos são armazenados na ChartAreaCollection classe .

O número de séries de gráficos que podem ser plotadas em uma área de gráfico é ilimitado.

Um ChartArea objeto:

  • Usa uma área de plotagem interna distinta.

  • É usado para plotar uma ou mais séries de gráficos.

  • Tem eixos x e y primários e secundários, exceto para tipos de gráfico de pizza e rosca.

Quando você usa tipos de gráfico de forma, que incluem gráficos de pizza, rosca, funil, pirâmide, polar e radar, a posição de plotagem interna define o tamanho da forma do tipo de gráfico. Por exemplo, quando você aumentar o valor da InnerPlotPosition propriedade em um gráfico de pizza, aumentará o raio da forma de pizza.

Para todos os outros tipos de gráfico, cada área do gráfico tem dois conjuntos de eixos X e Y, primário e secundário. Para acessar propriedades relacionadas a esses eixos, use as AxisXpropriedades , AxisX2e AxisYAxisY2 . Se você precisar definir uma propriedade que afete todos os eixos no gráfico, use a Axes propriedade .

Uma ou mais séries estão associadas a uma área de gráfico. A série tem uma ChartArea propriedade que determina a área do gráfico à qual cada série pertence. Por padrão, a série está conectada à área do gráfico padrão. Para desabilitar a exibição de uma série, defina a ChartArea propriedade dessa série como uma cadeia de caracteres de comprimento zero.

Se outra área do gráfico for adicionada ao gráfico, você poderá associar qualquer série à nova área do gráfico. Em todos os tipos de gráfico de forma, bem como tipos de gráfico de barras e de barras empilhadas, cada série deve ser plotada em uma área de gráfico separada. Em todos os outros tipos de gráfico, várias séries podem ser combinadas na mesma área do gráfico.

Um gráfico 3D é exibido em uma base de área de gráfico por gráfico. Você pode usar a Area3DStyle propriedade para habilitar e personalizar o gráfico em 3D.

A área mínima e máxima do gráfico não serão recalculadas automaticamente se você adicionar novos dados, portanto, o gráfico não alterará automaticamente os tamanhos do eixo. Você pode exigir que a área do gráfico recalcule esses valores usando o RecalculateAxesScale método .

Para alinhar várias áreas do gráfico verticalmente, defina a AlignmentOrientation propriedade . Para alinhar várias áreas do gráfico horizontalmente, primeiro você deve posicionar as áreas do gráfico usando a Position propriedade e, em seguida, definir a AlignmentOrientation propriedade como Horizontal.

Para suprimir a exibição de uma série, defina a Series propriedade dessa série como uma cadeia de caracteres de comprimento zero.

Construtores

ChartArea()

Inicializa uma nova instância da classe ChartArea.
ChartArea(String)

Inicializa uma nova instância da classe ChartArea com o nome da área do gráfico especificado.

Propriedades

AlignmentOrientation

Obtém ou define a orientação de alinhamento de uma área do gráfico.
AlignmentStyle

Obtém ou define o estilo de alinhamento do ChartArea.
AlignWithChartArea

Obtém ou define o nome do objeto ChartArea ao qual essa área do gráfico deve ser alinhada.
Area3DStyle

Obtém ou define um objeto ChartArea3DStyle, que é usado para implementar 3D (tridimensional) em todas as séries de uma área do gráfico.
Axes

Obtém ou define uma matriz que representa todos os eixos de uma área do gráfico.
AxisX

Obtém ou define um objeto Axis que representa o eixo X primário.
AxisX2

Obtém ou define um objeto Axis que representa o eixo X secundário.
AxisY

Obtém ou define um objeto Axis que representa o eixo Y primário.
AxisY2

Obtém ou define um objeto Axis que representa o eixo Y secundário.
BackColor

Obtém ou define a cor da tela de fundo de um objeto ChartArea.
BackGradientStyle

Obtém ou define a orientação do gradiente da tela de fundo de uma área do gráfico e também determina se um gradiente é ou não usado.
BackHatchStyle

Obtém ou define o estilo de hachura de um objeto ChartArea.
BackImage

Obtém ou define a imagem de tela de fundo de um objeto ChartArea.
BackImageAlignment

Obtém ou define o alinhamento de uma imagem de tela de fundo ChartArea.
BackImageTransparentColor

Obtém ou define a cor de uma imagem de tela de fundo do objeto ChartArea que será desenhada como transparente.
BackImageWrapMode

Obtém ou define o modo de desenho da imagem de tela de fundo de um objeto ChartArea.
BackSecondaryColor

Obtém ou define a cor secundária da tela de fundo de um objeto ChartArea.
BorderColor

Obtém ou define a cor da borda de um objeto ChartArea.
BorderDashStyle

Obtém ou define o estilo de borda de um objeto ChartArea.
BorderWidth

Obtém ou largura da borda de um objeto ChartArea.
CursorX

Obtém ou define um objeto Cursor que é usado para cursores e intervalos selecionados ao longo do eixo x.
CursorY

Obtém ou define um objeto Cursor usado para cursores e intervalos selecionados ao longo do eixo Y.
InnerPlotPosition

Obtém ou define um ElementPosition objeto, que define a posição de plotagem interna de um objeto da área de gráfico.
IsSameFontSizeForAllAxes

Obtém ou define um sinalizador que determina se os rótulos do eixo da área do gráfico relevante têm tamanhos iguais.
Name

Obtém ou define o nome exclusivo de um objeto ChartArea.
Position

Obtém ou define um objeto ElementPosition que define a posição de um objeto ChartArea dentro do Chart.
ShadowColor

Obtém ou define a cor da sombra de um objeto ChartArea.
ShadowOffset

Obtém ou define o deslocamento de sombra, em pixels, de um objeto ChartArea.
Tag

Obtém ou define um objeto associado a esse elemento do gráfico.

(Herdado de ChartElement)
Visible

Obtém ou define um sinalizador que determina se uma área do gráfico é visível.

Métodos

Dispose()

Libera os recursos usados pelo ChartElement.

(Herdado de ChartElement)
Dispose(Boolean)

Libera os recursos não gerenciados e, opcionalmente, os gerenciados.
Equals(Object)

Determina se o Object especificado é igual ao ChartElement atual.

(Herdado de ChartElement)
GetHashCode()

Retorna uma função de hash para um tipo específico.

(Herdado de ChartElement)
GetSeriesDepth(Series)

Retorna a profundidade de um Series em uma área do gráfico.
GetSeriesZPosition(Series)

Retorna a posição de Z de uma série, o que é útil para desenho personalizado.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
RecalculateAxesScale()

Recalcula as propriedades da área do gráfico depois de fazer alterações no gráfico, no evento Customize.
ToString()

Retorna uma cadeia de caracteres que representa o Object atual.

(Herdado de ChartElement)
TransformPoints(Point3D[])

Aplica transformações 3D a uma matriz de pontos 3D, que deve ser feito antes que métodos de desenho GDI+ possam ser chamados.

Aplica-se a