ChartArea Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa uma área do 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
Observações
Dentro de qualquer gráfico, a posição interna do gráfico é a área retangular, dentro das linhas dos eixos x e y, onde são desenhados os pontos de dados. A posição do gráfico é a área retangular que abrange a posição interior do gráfico, as marcas de assinalação e os rótulos dos eixos. A área do mapa é a área retangular que abrange a posição do gráfico, as marcas de assinalação, as etiquetas dos eixos e os títulos dos eixos no gráfico.
Uma área de carta é 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 representadas numa área de gráfico é ilimitado.
Um ChartArea objeto:
Utiliza uma área de plotagem interna distinta.
É usado para traçar uma ou mais séries de gráficos.
Tem eixos primário e secundário x e y, exceto os tipos de tarte e quadro de donuts.
Quando se usam tipos de gráficos de forma, que incluem tarte, donut, funil, pirâmide, polar e radar, a posição interna de plotagem define o tamanho da forma do tipo de carta. Por exemplo, quando aumenta o valor da InnerPlotPosition propriedade num gráfico circular, aumenta o raio da forma da pizza.
Para todos os outros tipos de cartas, cada área de mapa tem dois conjuntos de eixos X e Y, primário e secundário. Para aceder a propriedades relacionadas com estes eixos, use as AxisXpropriedades , AxisX2, AxisY e AxisY2 . Se precisares de definir uma propriedade que afete todos os eixos do gráfico, usa essa Axes propriedade.
Uma ou mais séries estão associadas a uma área do mapa. A série tem uma ChartArea propriedade que determina a área do mapa a que cada série pertence. Por defeito, a série está ligada à área padrão do gráfico. Para desativar a visualização de uma série, defina a ChartArea propriedade dessa série para uma cadeia de comprimento zero.
Se outra área do mapa for adicionada ao gráfico, pode associar qualquer série à nova área do gráfico. Em todos os tipos de gráficos de formas, bem como nos tipos de gráficos de barras e barras empilhadas, cada série deve ser representada numa área separada do gráfico. Em todos os outros tipos de gráficos, múltiplas séries podem ser combinadas na mesma área do mapa.
Um gráfico 3D é apresentado numa base de gráfico área a área. Pode usar a Area3DStyle propriedade para ativar e personalizar o seu mapa em 3D.
O mínimo e o máximo da área do gráfico não serão automaticamente recalculados se adicionar novos dados, por isso o gráfico não mudará automaticamente de tamanho dos eixos. Pode exigir que a área do gráfico recalcule estes 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, deve primeiro posicionar as áreas do gráfico usando a Position propriedade e depois definir a AlignmentOrientation propriedade para Horizontal.
Para suprimir a exibição de uma série, defina a Series propriedade dessa série para uma cadeia de comprimento zero.
Construtores
| Name | Description |
|---|---|
| ChartArea() |
Inicializa uma nova instância da ChartArea classe. |
| ChartArea(String) |
Inicializa uma nova instância da ChartArea classe com o nome especificado da área do mapa. |
Propriedades
| Name | Description |
|---|---|
| AlignmentOrientation |
Obtém ou define a orientação de alinhamento de uma área do mapa. |
| AlignmentStyle |
Obtém ou define o estilo de alinhamento do ChartArea. |
| AlignWithChartArea |
Obtém ou define o nome do ChartArea objeto ao qual esta área do mapa deve estar alinhada. |
| Area3DStyle |
Obtém ou define um ChartArea3DStyle objeto, que é usado para implementar 3D para todas as séries numa área de gráfico. |
| Axes |
Obtém ou define um array que representa todos os eixos de uma área de carta. |
| AxisX |
Obtém ou define um Axis objeto que representa o eixo primário dos X. |
| AxisX2 |
Obtém ou define um Axis objeto que representa o eixo secundário dos X. |
| 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 secundário Y. |
| BackColor |
Obtém ou define a cor de fundo de um ChartArea objeto. |
| BackGradientStyle |
Obtém ou define a orientação para o gradiente de fundo de uma área de gráfico, e também determina se um gradiente é usado ou não. |
| BackHatchStyle |
Obtém ou define o estilo de hachura de um ChartArea objeto. |
| BackImage |
Obtém ou define a imagem de fundo de um ChartArea objeto. |
| BackImageAlignment |
Obtém ou define o alinhamento de uma ChartArea imagem de fundo. |
| BackImageTransparentColor |
Obtém ou define a cor da imagem de fundo de um ChartArea objeto que será desenhada como transparente. |
| BackImageWrapMode |
Obtém ou define o modo de desenho para a imagem de fundo de um ChartArea objeto. |
| BackSecondaryColor |
Obtém ou define a cor secundária para o 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 da 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 interna do gráfico de um objeto área do mapa. |
| IsSameFontSizeForAllAxes |
Recebe ou define um flag que determina se os rótulos dos eixos relevantes da área do gráfico têm o mesmo tamanho. |
| Name |
Recebe ou define o nome único 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 este elemento do mapa. (Herdado de ChartElement) |
| Visible |
Recebe ou define um valor que indica se uma área do gráfico é visível. |
Métodos
| Name | Description |
|---|---|
| Dispose() |
Liberta os recursos usados pelo ChartElement. (Herdado de ChartElement) |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pela ChartArea classe e, opcionalmente, liberta os recursos geridos. |
| Equals(Object) |
Determina se o especificado Object é igual à corrente ChartElement. (Herdado de ChartElement) |
| GetHashCode() |
Devolve uma função de hash para um determinado tipo. (Herdado de ChartElement) |
| GetSeriesDepth(Series) |
Devolve a profundidade de a Series numa área de carta. |
| GetSeriesZPosition(Series) |
Devolve a posição Z de uma série, o que é útil para desenhos personalizados. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| RecalculateAxesScale() |
Recalcula as propriedades da área do mapa após alterações feitas no mapa no Customize evento. |
| ToString() |
Devolve uma cadeia que representa a corrente Object. (Herdado de ChartElement) |
| TransformPoints(Point3D[]) |
Aplica transformações 3D a um array de pontos 3D, o que deve ser feito antes de poderem ser chamados métodos de desenho GDI+. |