Clase Chart (Word VBA)

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

Los principales procedimientos de la clase Chart son Copy, Delete y Select

Set

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

Dim chr as Chart
Set chr = ActiveDocument.Background.Chart

Los siguientes procedimientos se pueden usar para establecer variables de clase Chart : InlineShape.Chart y Shape.Chart

Temas

Algunos procedimientos de esta clase se han agrupado en temas y se describen en páginas temáticas separadas

Name with its procedures ChartTitle, HasTitle y SeriesNameLevel
Display/Show with its procedures DisplayBlanksAs, ShowAllFieldButtons, ShowLegendFieldButtons y ShowValueFieldButtons

Métodos

Los principales métodos de la clase Chart son

Copy - No está admitido para este objeto.

ActiveDocument.Background.Chart.Copy

Delete - Elimina el objeto.

ActiveDocument.Background.Chart.Delete

Select - Selecciona el objeto.

ActiveDocument.Background.Chart.Select

Otros Métodos

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

ActiveDocument.Background.Chart.ApplyDataLabels

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

Dim lngLayout As Long: lngLayout =  
ActiveDocument.Background.Chart.ApplyLayout Layout:=lngLayout

Axes - Devuelve una colección de ejes en el gráfico.

Dim axs As Axes
Set axs = ActiveDocument.Background.Chart.Axes()

ChartWizard - Modifica las propiedades del gráfico especificado.

ActiveDocument.Background.Chart.ChartWizard

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

Dim strFileName As String: strFileName =  
Dim booExport As Boolean
booExport = ActiveDocument.Background.Chart.Export(FileName:=strFileName)

GetChartElement - Devuelve información sobre el elemento del gráfico situado en las coordenadas X e Y especificadas.

Dim lngx As Long: lngx = 
Dim lngy As Long: lngy = 
Dim lngElementID As Long: lngElementID = 
Dim lngArg1 As Long: lngArg1 = 
Dim lngArg2 As Long: lngArg2 =  
ActiveDocument.Background.Chart.GetChartElement x:=lngx, y:=lngy, ElementID:=lngElementID, Arg1:=lngArg1, Arg2:=lngArg2

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

Dim strSource As String: strSource =  
ActiveDocument.Background.Chart.SetSourceData Source:=strSource

Propiedades

AutoScaling True si Microsoft Word ajusta el tamaño de un gráfico 3D para que sea más parecido al gráfico 2D equivalente.

ActiveDocument.Background.Chart.AutoScaling = True

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

Dim wllsBackWall As Walls
Set wllsBackWall = ActiveDocument.Background.Chart.BackWall

BarShape Devuelve o establece la forma utilizada para cada serie en un gráfico de barras o columnas 3D.

ActiveDocument.Background.Chart.BarShape = xlBox

CategoryLabelLevel Devuelve o establece una constante XlCategoryLabel que especifica el nivel de origen de los rótulos de categoría de gráfico.

ActiveDocument.Background.Chart.CategoryLabelLevel = xlCategoryLabelLevelAll

ChartArea Devuelve todo el área del gráfico.

Dim caaChartArea As ChartArea
Set caaChartArea = ActiveDocument.Background.Chart.ChartArea

ChartColor Devuelve o establece un entero que representa la combinación de colores para el gráfico.

ActiveDocument.Background.Chart.ChartColor =

ChartData Devuelve información sobre los datos vinculados o incrustados asociados al gráfico.

Dim cdaChartData As ChartData
Set cdaChartData = ActiveDocument.Background.Chart.ChartData

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

Dim cgsChartGroups As ChartGroups
Set cgsChartGroups = ActiveDocument.Background.Chart.ChartGroups

ChartStyle Devuelve o establece el estilo del gráfico.

ActiveDocument.Background.Chart.ChartStyle =

ChartType Devuelve o establece el tipo del gráfico.

ActiveDocument.Background.Chart.ChartType =

DataTable Devuelve la tabla de datos del gráfico.

Dim dteDataTable As DataTable
Set dteDataTable = ActiveDocument.Background.Chart.DataTable

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).

ActiveDocument.Background.Chart.DepthPercent =

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

ActiveDocument.Background.Chart.Elevation =

Floor Devuelve el plano inferior del gráfico 3D.

Dim flrFloor As Floor
Set flrFloor = ActiveDocument.Background.Chart.Floor

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

ActiveDocument.Background.Chart.GapDepth =

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

ActiveDocument.Background.Chart.HasAxis = True

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

ActiveDocument.Background.Chart.HasDataTable = True

HasLegend True si el gráfico tiene una leyenda.

ActiveDocument.Background.Chart.HasLegend = True

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

ActiveDocument.Background.Chart.HeightPercent =

Legend Devuelve la leyenda del gráfico.

Dim lgnLegend As Legend
Set lgnLegend = ActiveDocument.Background.Chart.Legend

Parent Devuelve al objeto primario del objeto especificado.

Dim objParent As Object
Set objParent = ActiveDocument.Background.Chart.Parent

Perspective Devuelve o establece la perspectiva de la vista del gráfico 3D.

ActiveDocument.Background.Chart.Perspective =

PivotLayout No admitido en este objeto.

Dim objPivotLayout As Object
Set objPivotLayout = ActiveDocument.Background.Chart.PivotLayout

PlotArea Devuelve el área de trazado de un gráfico.

Dim paaPlotArea As PlotArea
Set paaPlotArea = ActiveDocument.Background.Chart.PlotArea

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

ActiveDocument.Background.Chart.PlotBy = xlColumns

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

ActiveDocument.Background.Chart.PlotVisibleOnly = True

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.

ActiveDocument.Background.Chart.RightAngleAxes = True

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

ActiveDocument.Background.Chart.Rotation =

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

Dim shpsShapes As Shapes
Set shpsShapes = ActiveDocument.Background.Chart.Shapes

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

ActiveDocument.Background.Chart.ShowAxisFieldButtons = True

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

ActiveDocument.Background.Chart.ShowDataLabelsOverMaximum = True

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

ActiveDocument.Background.Chart.ShowReportFilterFieldButtons = True

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

Dim wllsSideWall As Walls
Set wllsSideWall = ActiveDocument.Background.Chart.SideWall

Walls Devuelve las paredes del gráfico 3D.

Dim wllsWalls As Walls
Set wllsWalls = ActiveDocument.Background.Chart.Walls