ChartArea Clase

Definición

Espacio de nombres:

System.Windows.Forms.DataVisualization.Charting

Ensamblado:

System.Windows.Forms.DataVisualization.dll

Representa un área del 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 un 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 interior del trazado, 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 ejes x e y principales y secundarios, excepto los tipos de gráfico circular y anillo.

Cuando se usan tipos de gráfico 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, utilice 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 del gráfico. Puede usar la Area3DStyle propiedad para habilitar y personalizar el gráfico en 3D.

El área de gráfico mínimo y máximo 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 vuelva a calcular estos valores mediante el RecalculateAxesScale método .

Para alinear verticalmente varias áreas de gráfico, establezca la AlignmentOrientation propiedad . Para alinear horizontalmente varias áreas de gráfico, 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

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

Propiedades

AlignmentOrientation	Obtiene o establece la orientación de alineación de un área del gráfico.
AlignmentStyle	Obtiene o establece el estilo de alineación de la clase ChartArea.
AlignWithChartArea	Obtiene o establece el nombre del objeto ChartArea con el que se debe alinear esta área del gráfico.
Area3DStyle	Obtiene o establece un objeto ChartArea3DStyle, que se usa para implementar tridimensionalidad (3D) para todas las series de un área del gráfico.
Axes	Obtiene o establece una matriz que representa todos los ejes para un área del gráfico.
AxisX	Obtiene o establece un objeto Axis que representa el eje X principal.
AxisX2	Obtiene o establece un objeto Axis que representa el eje X secundario.
AxisY	Obtiene o establece un objeto Axis que representa el eje Y principal.
AxisY2	Obtiene o establece un objeto Axis que representa el eje Y secundario.
BackColor	Obtiene o establece el color de fondo de un objeto ChartArea.
BackGradientStyle	Obtiene o establece la orientación para el degradado de fondo de un área del gráfico y también determina si se usa un degradado o no.
BackHatchStyle	Obtiene o establece el estilo de sombreado de un objeto ChartArea.
BackImage	Obtiene o establece la imagen de fondo de un objeto ChartArea.
BackImageAlignment	Obtiene o establece la alineación de una imagen de fondo ChartArea.
BackImageTransparentColor	Obtiene o establece el color de una imagen de fondo de un objeto ChartArea que se dibujará como transparente.
BackImageWrapMode	Obtiene o establece el modo de dibujo de la imagen de fondo de un objeto ChartArea.
BackSecondaryColor	Obtiene o establece el color secundario para el fondo de un objeto ChartArea.
BorderColor	Obtiene o establece el color del borde de un control ChartArea.
BorderDashStyle	Obtiene o establece el estilo del borde de un objeto ChartArea.
BorderWidth	Obtiene o establece el ancho del borde de un objeto ChartArea.
CursorX	Obtiene o establece un objeto Cursor que se usa para los cursores y los intervalos seleccionados a lo largo del eje X.
CursorY	Obtiene o establece un objeto Cursor que se usa para los cursores y los intervalos seleccionados a lo largo del eje Y.
InnerPlotPosition	Obtiene o establece un objeto ElementPosition, que define la posición de trazado interior de un objeto de área del gráfico.
IsSameFontSizeForAllAxes	Obtiene o establece una marca que determina si las etiquetas de los ejes del área del gráfico relevantes tienen el mismo tamaño.
Name	Obtiene o establece el nombre único de un objeto ChartArea.
Position	Obtiene o establece un objeto ElementPosition que define la posición de un objeto ChartArea dentro de la clase Chart.
ShadowColor	Obtiene o establece el color de sombra de un objeto ChartArea.
ShadowOffset	Obtiene o establece el desplazamiento de sombra, en píxeles, de un objeto ChartArea.
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 es visible.

Métodos

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