Clase Chart (Excel VBA)

La clase Chart representa un gráfico en un libro.

Las siguientes clases dan acceso a la clase Chart

Para usar una variable de clase Chart, primero debe ser instanciado, por ejemplo

Dim chr as Chart
Set chr = ActiveChart

Los siguientes procedimientos se pueden usar para establecer variables de clase Chart : Application.ActiveChart, Location, ChartObject.Chart, Shape.Chart, ShapeRange.Chart, Sheets.Add, Sheets.Item, Sheets.Visible, Window.ActiveChart y Workbook.ActiveChart.

For Each

A continuación, se muestra un ejemplo de cómo procesar los elementos Chart en una colección.

Dim chr As Chart
For Each chr In Charts
	
Next chr

Métodos

Activate - Convierte el gráfico actual en el gráfico activo.

ApplyChartTemplate - Aplica un tipo de gráfico estándar o personalizado a un gráfico.

ApplyDataLabels - Aplica rótulos de datos a todas las series de un gráfico.

ApplyLayout - Aplica los diseños que se muestran en la cinta de opciones.

Axes - Devuelve un objeto que representa un solo eje o una colección de ejes en el gráfico.

ChartGroups - Devuelve un objeto que representa un solo grupo de gráficos (un objeto ChartGroup ) o una colección de todos los grupos de gráficos del gráfico (un objeto ChartGroups ).

ChartObjects - Devuelve un objeto que representa un único gráfico incrustado (un objeto ChartObject ) o una colección de todos los gráficos incrustados (un objeto ChartObjects ) en la hoja.

ChartWizard - Modifica las propiedades del gráfico especificado.

CheckSpelling - Comprueba la ortografía de un objeto.

ClearToMatchColorStyle - Borra todos los colores del gráfico especificado que no siguen el estilo de color aplicado al gráfico.

ClearToMatchStyle - Borra el formato de los elementos del gráfico y usa los formatos automáticos.

Copy - Copia la hoja a otra ubicación del libro.

CopyPicture - Copia el objeto seleccionado en el Portapapeles, en forma de imagen.

Delete - Elimina el objeto.

Evaluate - Convierte un nombre de Microsoft Excel en un objeto o un valor.

Export - Exporta el gráfico con un formato de imagen.

ExportAsFixedFormat - Exporta a un archivo con el formato especificado.

FullSeriesCollection - Permite recuperar la serie de salida filtrada especificada por el argumento index .

GetChartElement - Devuelve información sobre el elemento de gráfico en las coordenadas x e y especificadas.

GetProperty -

Location - Desplaza el gráfico a otro lugar.

Move - Mueve el gráfico a otro lugar del libro.

OLEObjects - Devuelve un objeto que representa un único objeto OLE (un objeto OLEObject) o una colección de todos los objetos OLE (una colección OLEObjects ) del gráfico o de la hoja.

Paste - Pega los datos de gráfico que contiene el Portapapeles en el gráfico indicado.

PrintOut - Imprime el objeto.

PrintPreview - Muestra una vista preliminar del objeto tal como aparecería impreso.

Protect - Protege un gráfico para que no se pueda modificar.

Refresh - Hace el gráfico especificado vuelva a dibujarse inmediatamente.

SaveAs - Guarda los cambios del gráfico o de la hoja de cálculo en un archivo diferente.

SaveChartTemplate - Guarda una plantilla de gráfico personalizada en la lista de plantillas de gráfico disponibles.

Select - Selecciona el objeto.

SeriesCollection - Devuelve un objeto que representa una única serie (un objeto series ) o una colección de todas las series (una colección SeriesCollection ) en el gráfico o grupo de gráficos.

SetBackgroundPicture - Establece el gráfico de fondo para una hoja de cálculo o un gráfico.

SetDefaultChart - Especifica el nombre de la plantilla de gráfico que usa Microsoft Excel para crear nuevos gráficos.

SetElement - Conjuntos de elementos de gráfico de un gráfico.

SetProperty -

SetSourceData - Configura el rango de datos de origen para el gráfico.

Unprotect - Elimina la protección de una hoja o de un libro.

Propiedades

AutoScaling True si Microsoft Excel ajusta la escala de un gráfico 3D para que sea más cerca del tamaño del gráfico 2D equivalente.

BackWall Devuelve un objeto Walls que permite al usuario dar formato por separado al plano trasero de un gráfico 3D.

BarShape Devuelve o establece la forma utilizada con el gráfico de columnas o de barras 3D.

CategoryLabelLevel Devuelve una constante XlCategoryLabelLevel que hace referencia al nivel desde el que se van a originar las etiquetas de categoría.

ChartArea Devuelve un objeto ChartArea que representa el área completa del gráfico.

ChartColor Devuelve o establece un valor de tipo Integer que representa la combinación de colores del gráfico.

ChartStyle Devuelve o establece el estilo de gráfico para el gráfico.

ChartTitle Devuelve un objeto ChartTitle que representa el título del gráfico especificado.

ChartType Devuelve o establece el tipo de gráfico.

CodeName Devuelve el nombre de código del objeto.

DataTable Devuelve un objeto DataTable que representa la tabla de datos del gráfico.

DepthPercent Devuelve o establece la profundidad de un gráfico 3D como un porcentaje del ancho del gráfico (entre 20 y 2000 por ciento).

DisplayBlanksAs Devuelve o establece la forma en que se trazan las celdas en blanco en un gráfico.

DisplayValueNotAvailableAsBlank

Elevation Devuelve o establece la elevación de la vista del gráfico 3D, en grados.

Floor Devuelve un objeto Floor que representa el plano inferior del gráfico 3D.

GapDepth Devuelve o establece la distancia entre la serie de datos de un gráfico 3D como un porcentaje del ancho del marcador.

HasAxis Devuelve o establece información acerca de los ejes existentes en el gráfico.

HasDataTable True si el gráfico tiene una tabla de datos.

HasLegend True si el gráfico tiene una leyenda.

HasTitle True si el eje o el gráfico tiene un título visible.

HeightPercent Devuelve o establece el alto de un gráfico 3D como un porcentaje del ancho del gráfico (entre 5 y 500 por ciento).

Hyperlinks Devuelve una colección Hyperlinks que representa los hipervínculos del gráfico.

Index Devuelve un valor de tipo Long que representa el número de índice del objeto dentro de una colección de objetos similares.

Legend Devuelve un objeto Legend que representa la leyenda del gráfico.

MailEnvelope Representa un encabezado de correo electrónico de un documento.

Name Devuelve o establece un valor de tipo String que representa el nombre del objeto.

Next Devuelve un objeto Worksheet que representa la hoja siguiente.

PageSetup Devuelve un objeto PageSetup que contiene todos los valores de configuración de página para el objeto especificado.

Perspective Devuelve o establece un valor de tipo Long que representa la perspectiva de la vista del gráfico 3D.

PivotLayout Devuelve un objeto PivotLayout que representa la ubicación de los campos en un informe de tabla dinámica y la colocación de los ejes en un informe de gráfico dinámico.

PlotArea Devuelve un objeto PlotArea que representa el área de trazado de un gráfico.

PlotBy Devuelve o establece la forma en que se utilizan las columnas o filas como series de datos en el gráfico.

PlotVisibleOnly True si sólo se trazan las celdas visibles.

Previous Devuelve un objeto Worksheet que representa la hoja anterior.

PrintedCommentPages Devuelve el número de páginas de comentarios que se imprimirán para el gráfico actual.

ProtectContents Es True si el contenido de la hoja está protegido.

ProtectData True si el usuario no puede modificar las fórmulas de las series.

ProtectDrawingObjects Es True si las formas están protegidas.

ProtectFormatting True si el usuario no puede modificar el formato del gráfico.

ProtectionMode Es True si está activada la protección de sólo interfaz de usuario.

ProtectSelection True si no es posible seleccionar los elementos del gráfico.

RightAngleAxes True si los ejes del gráfico están en ángulo recto, independientemente de la rotación de gráfico o la elevación.

Rotation Devuelve o establece el giro de la vista del gráfico 3D (el giro del área de trazado alrededor del eje z, en grados).

SeriesNameLevel Devuelve una constante XlSeriesNameLevel que hace referencia al nivel desde el que se van a originar los nombres de las series.

Shapes Devuelve una colección Shapes que representa todas las formas de la hoja de gráfico.

ShowAllFieldButtons Devuelve o establece si se muestran todos los botones de campo en un gráfico dinámico.

ShowAxisFieldButtons Devuelve o establece si se muestran los botones del campo de eje en un gráfico dinámico.

ShowDataLabelsOverMaximum Devuelve o establece si se muestran los rótulos de datos cuando el valor es mayor que el valor máximo del eje de valores.

ShowExpandCollapseEntireFieldButtons True para mostrar los botones Expandir todo el campo y Contraer todo el campo del gráfico dinámico especificado.

ShowLegendFieldButtons Devuelve o establece si se muestran los botones del campo de leyenda en un gráfico dinámico.

ShowReportFilterFieldButtons Devuelve o establece si se muestran los botones del campo de filtro del informe en un gráfico dinámico.

ShowValueFieldButtons Devuelve o establece si se muestran los botones del campo de valores en un gráfico dinámico.

SideWall Devuelve un objeto Walls que permite al usuario dar formato por separado al plano lateral de un gráfico 3D.

Tab Devuelve un objeto Tab para un gráfico.

Visible Devuelve o establece un valor XlSheetVisibility que determina si el objeto es visible.

Walls Devuelve un objeto Walls que representa los planos laterales del gráfico 3D.

Axes - Colección de todos los objetos AXIS del gráfico especificado.

ChartArea - Representa el área de un gráfico.

ChartGroups - Representa una o varias series trazadas en un gráfico empleando el mismo formato.

ChartObjects - Colección de todos los objetos ChartObject de la hoja de gráfico, hoja de diálogo u hoja de cálculo especificadas.

ChartTitle - Representa el título del gráfico.

DataTable - Representa una tabla de datos de un gráfico.

Floor - Representa el plano inferior de un gráfico 3D.

FullSeriesCollection - Representa el conjunto completo de objetos series de un gráfico.

Hyperlinks - Representa la colección de hipervínculos de una hoja de cálculo o de un rango.

Legend - Representa la leyenda de un gráfico.

OLEObjects - Colección de todos los objetos OLEObject de la hoja de cálculo especificada.

PageSetup - Representa la descripción de la configuración de página.

PivotLayout - Representa la ubicación de los campos de un informe de gráfico dinámico.

PlotArea - Representa el área de trazado de un gráfico.

SeriesCollection - Colección de todos los objetos series en el gráfico o grupo de gráficos especificado.

Shapes - Colección de todos los objetos Shape de la hoja especificada.

Tab - Representa la ficha de un gráfico o de una hoja de cálculo.

Walls - Representa las paredes de un gráfico 3D.

Worksheet - Representa una hoja de cálculo.