ChartArea Clase

Definición

Espacio de nombres:

System.Windows.Forms.DataVisualization.Charting

Ensamblado:

System.Windows.Forms.DataVisualization.dll

Representa un área de gráfico en la imagen del 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

Herencia

Object

ChartElement

ChartNamedElement

ChartArea

Comentarios

Dentro de cualquier gráfico determinado, la posición del trazado interno es el área rectangular, dentro de las líneas del eje x e y, donde se dibujan los puntos de datos. La posición del trazado es el área rectangular que abarca la posición del trazado interno, las marcas de graduación y las etiquetas del eje. El área del gráfico es el área rectangular que abarca la posición del trazado, las marcas de graduación, las etiquetas del eje y los títulos del eje del gráfico.

Un área de gráfico se representa mediante una ChartArea clase; ChartArea los objetos se almacenan en la ChartAreaCollection clase .

El número de series de gráficos que se pueden trazar en un área de gráfico es ilimitada.

Objeto ChartArea :

• Usa un área de trazado interna distinta.

• Se usa para trazar una o varias series de gráficos.

• Tiene los ejes x y y principales y secundarios, excepto para los tipos de gráfico circular y de anillos.

Cuando se usan tipos de gráficos de formas, que incluyen gráficos circulares, anillos, embudo, pirámide, polar y radar, la posición de trazado interno define el tamaño de la forma de tipo de gráfico. Por ejemplo, al aumentar el valor de la InnerPlotPosition propiedad en un gráfico circular, aumentará el radio de la forma circular.

Para todos los demás tipos de gráficos, cada área de gráfico tiene dos conjuntos de ejes X e Y, principal y secundario. Para acceder a las propiedades relacionadas con estos ejes, use las AxisXpropiedades , AxisYAxisX2y AxisY2 . Si necesita establecer una propiedad que afecte a todos los ejes del gráfico, use la Axes propiedad .

Una o varias series están asociadas a un área de gráfico. La serie tiene una ChartArea propiedad que determina el área de gráfico a la que pertenece cada serie. De forma predeterminada, la serie está conectada al área de gráfico predeterminada. Para deshabilitar la presentación de una serie, establezca la ChartArea propiedad de esa serie en una cadena de longitud cero.

Si se agrega otro área de gráfico al gráfico, puede asociar cualquier serie con el nuevo área del gráfico. En todos los tipos de gráfico de formas, así como los tipos de gráfico de barras apiladas y barras, cada serie debe trazarse en un área de gráfico independiente. En todos los demás tipos de gráfico, se pueden combinar varias series en el mismo área del gráfico.

Un gráfico 3D se muestra en un área de gráfico por área de gráfico. Puede usar la Area3DStyle propiedad para habilitar y personalizar el gráfico en 3D.

El área de gráfico mínima y máxima no se volverá a calcular automáticamente si agrega nuevos datos, por lo que el gráfico no cambiará automáticamente los tamaños del eje. Puede requerir que el área del gráfico recalcule estos valores mediante el RecalculateAxesScale método .

Para alinear varias áreas del gráfico verticalmente, establezca la AlignmentOrientation propiedad . Para alinear varias áreas de gráfico horizontalmente, primero debe colocar las áreas del gráfico mediante la Position propiedad y, a continuación, establecer la AlignmentOrientation propiedad en Horizontal.

Para suprimir la presentación de una serie, establezca la Series propiedad de esa serie en una cadena de longitud cero.

Constructores

Nombre	Description
ChartArea()	Inicializa una nueva instancia de la clase ChartArea.
ChartArea(String)	Inicializa una nueva instancia de la ChartArea clase con el nombre de área de gráfico especificado.

Propiedades

Nombre	Description
AlignmentOrientation	Obtiene o establece la orientación de alineación de un área de gráfico.
AlignmentStyle	Obtiene o establece el estilo de alineación de ChartArea.
AlignWithChartArea	Obtiene o establece el nombre del ChartArea objeto al que se debe alinear este área del gráfico.
Area3DStyle	Obtiene o establece un ChartArea3DStyle objeto , que se usa para implementar tridimensionales (3D) para todas las series de un área de gráfico.
Axes	Obtiene o establece una matriz que representa todos los ejes de un área de gráfico.
AxisX	Obtiene o establece un Axis objeto que representa el eje X principal.
AxisX2	Obtiene o establece un Axis objeto que representa el eje X secundario.
AxisY	Obtiene o establece un Axis objeto que representa el eje Y principal.
AxisY2	Obtiene o establece un Axis objeto que representa el eje Y secundario.
BackColor	Obtiene o establece el color de fondo de un ChartArea objeto .
BackGradientStyle	Obtiene o establece la orientación para el degradado de fondo de un área de gráfico y también determina si se usa o no un degradado.
BackHatchStyle	Obtiene o establece el estilo de sombreado de un ChartArea objeto.
BackImage	Obtiene o establece la imagen de fondo de un ChartArea objeto .
BackImageAlignment	Obtiene o establece la alineación de una ChartArea imagen de fondo.
BackImageTransparentColor	Obtiene o establece el color de una imagen de fondo de objeto ChartArea que se dibujará como transparente.
BackImageWrapMode	Obtiene o establece el modo de dibujo de la imagen de fondo de un ChartArea objeto .
BackSecondaryColor	Obtiene o establece el color secundario del fondo de un ChartArea objeto .
BorderColor	Obtiene o establece el color de borde de un ChartArea objeto .
BorderDashStyle	Obtiene o establece el estilo de borde de un ChartArea objeto .
BorderWidth	Obtiene o establece el ancho de borde de un ChartArea objeto .
CursorX	Obtiene o establece un Cursor objeto que se usa para cursores y rangos seleccionados a lo largo del eje X.
CursorY	Obtiene o establece un Cursor objeto que se usa para cursores y rangos seleccionados a lo largo del eje Y.
InnerPlotPosition	Obtiene o establece un ElementPosition objeto , que define la posición de trazado interno de un objeto de área de gráfico.
IsSameFontSizeForAllAxes	Obtiene o establece una marca que determina si las etiquetas de los ejes del área del gráfico pertinente tienen un tamaño igual.
Name	Obtiene o establece el nombre único de un ChartArea objeto .
Position	Obtiene o establece un ElementPosition objeto que define la posición de un ChartArea objeto dentro de Chart.
ShadowColor	Obtiene o establece el color de sombra de un ChartArea objeto .
ShadowOffset	Obtiene o establece el desplazamiento de sombra, en píxeles, de un ChartArea objeto .
Tag	Obtiene o establece un objeto asociado a este elemento de gráfico. (Heredado de ChartElement)
Visible	Obtiene o establece una marca que determina si un área del gráfico está visible.

Métodos

Nombre	Description
Dispose()	Libera los recursos usados por .ChartElement (Heredado de ChartElement)
Dispose(Boolean)	Libera recursos administrados y, opcionalmente, administrados.
Equals(Object)	Determina si el objeto especificado Object es igual al objeto actual ChartElement. (Heredado de ChartElement)
GetHashCode()	Devuelve una función hash para un tipo determinado. (Heredado de ChartElement)
GetSeriesDepth(Series)	Devuelve la profundidad de en Series un área de gráfico.
GetSeriesZPosition(Series)	Devuelve la posición Z de una serie, que resulta útil para el dibujo personalizado.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
RecalculateAxesScale()	Vuelve a calcular las propiedades del área del gráfico después de que se hayan realizado cambios en el gráfico en el Customize evento.
ToString()	Devuelve una cadena que representa el objeto actual Object. (Heredado de ChartElement)
TransformPoints(Point3D[])	Aplica transformaciones 3D a una matriz de puntos 3D, que debe realizarse antes de que se pueda llamar a los métodos de dibujo de GDI+.