ChartArea Classe

Definição

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Representa uma área de gráfico na imagem do gráfico.

public ref class ChartArea : System::Web::UI::DataVisualization::Charting::ChartNamedElement

public class ChartArea : System.Web.UI.DataVisualization.Charting.ChartNamedElement

type ChartArea = class
    inherit ChartNamedElement

Public Class ChartArea
Inherits ChartNamedElement

Herança

Object

ChartElement

ChartNamedElement

ChartArea

Comentários

Dentro de um determinado gráfico, a posição da plotagem interna é a área retangular, dentro das linhas do eixo x e y, em que os pontos de dados são desenhados. A posição da plotagem é 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 de eixo 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 inclui 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 o , AxisYAxisX2e AxisY2 as AxisXpropriedades. Se você precisar definir uma propriedade que afete todos os eixos no gráfico, use a Axes propriedade.

Uma ou mais séries sã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 de 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 shape, bem como tipos de gráfico de barras e 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 área área por gráfico do gráfico. Você pode usar a Area3DStyle propriedade para habilitar e personalizar seu 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

Nome	Description
ChartArea()	Inicializa uma nova instância da classe ChartArea.
ChartArea(String)	Inicializa uma nova instância da ChartArea classe com o nome da área do gráfico especificado.

Propriedades

Nome	Description
AlignmentOrientation	Obtém ou define a orientação de alinhamento de uma área de gráfico.
AlignmentStyle	Obtém ou define o estilo de alinhamento do ChartArea.
AlignWithChartArea	Obtém ou define o nome do ChartArea objeto ao qual essa área do gráfico deve ser alinhada.
Area3DStyle	Obtém ou define um ChartArea3DStyle objeto, que é usado para implementar 3D para todas as séries em uma área de gráfico.
Axes	Obtém ou define uma matriz que representa todos os eixos de uma área de gráfico.
AxisX	Obtém ou define um Axis objeto que representa o eixo X primário.
AxisX2	Obtém ou define um Axis objeto que representa o eixo X secundário.
AxisY	Obtém ou define um Axis objeto que representa o eixo Y primário.
AxisY2	Obtém ou define um Axis objeto que representa o eixo Y secundário.
BackColor	Obtém ou define a cor da tela de fundo de um ChartArea objeto.
BackGradientStyle	Obtém ou define a orientação para o gradiente em segundo plano de uma área do gráfico e também determina se um gradiente é usado ou não.
BackHatchStyle	Obtém ou define o estilo de eclosão de um ChartArea objeto.
BackImage	Obtém ou define a imagem de plano de fundo de um ChartArea objeto.
BackImageAlignment	Obtém ou define o alinhamento de uma ChartArea imagem de plano de fundo.
BackImageTransparentColor	Obtém ou define a cor de uma ChartArea imagem de plano de fundo do objeto que será desenhada como transparente.
BackImageWrapMode	Obtém ou define o modo de desenho para a imagem de plano de fundo de um ChartArea objeto.
BackSecondaryColor	Obtém ou define a cor secundária da tela de fundo de um ChartArea objeto.
BorderColor	Obtém ou define a cor da borda de um ChartArea objeto.
BorderDashStyle	Obtém ou define o estilo de borda de um ChartArea objeto.
BorderWidth	Obtém ou define a largura da borda de um ChartArea objeto.
InnerPlotPosition	Obtém ou define um ElementPosition objeto, que define a posição da plotagem interna de um objeto de área do gráfico.
IsSameFontSizeForAllAxes	Obtém ou define um sinalizador que determina se os rótulos dos eixos de área do gráfico relevantes são de tamanho igual.
Name	Obtém ou define o nome exclusivo de um ChartArea objeto.
Position	Obtém ou define um ElementPosition objeto que define a posição de um ChartArea objeto dentro do Chart.
ShadowColor	Obtém ou define a cor da sombra de um ChartArea objeto.
ShadowOffset	Obtém ou define o deslocamento de sombra, em pixels, de um ChartArea objeto.
Tag	Obtém ou define um objeto associado a esse elemento de gráfico. (Herdado de ChartElement)
Visible	Obtém ou define um valor que indica se uma área do gráfico está visível.

Métodos

Nome	Description
Dispose()	Libera os recursos usados pelo ChartElement. (Herdado de ChartElement)
Dispose(Boolean)	Libera os recursos não gerenciados usados pela ChartArea classe e, opcionalmente, libera os recursos gerenciados.
Equals(Object)	Determina se o especificado Object é igual ao atual ChartElement. (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 de gráfico.
GetSeriesZPosition(Series)	Retorna a posição Z de uma série, que é útil para desenho personalizado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
RecalculateAxesScale()	Recalcula as propriedades da área do gráfico após alterações feitas no gráfico no Customize evento.
ToString()	Retorna uma cadeia de caracteres que representa o atual Object. (Herdado de ChartElement)
TransformPoints(Point3D[])	Aplica transformações 3D a uma matriz de pontos 3D, o que deve ser feito antes que os métodos de desenho GDI+ possam ser chamados.