Objeto Chart (Excel)

  • Artículo

Representa un gráfico en un libro.

Comentarios

El gráfico puede ser un gráfico incorporado (incluido en un objeto ChartObject) o una hoja de gráficos independiente.

La colección Charts contiene un objeto Chart para cada hoja de gráficos de un libro. Use Charts (índice), donde índice es el número o nombre del índice de la hoja de gráficos para devolver un único objeto Chart.

El número de índice de gráfico representa la posición de la hoja de gráficos en la barra de fichas del libro. Charts(1) es el primer gráfico (de la extrema izquierda) del libro; Charts(Charts.Count) es el último (de la extrema derecha).

Todas las hojas de gráficos se incluyen en el recuento de índices, incluso si están ocultas. El nombre de la hoja de gráficos se muestra en la pestaña del libro para el gráfico. Use la propiedad Name del objeto ChartObject para definir o devolver el nombre del gráfico.

En el ejemplo siguiente, se cambia el color de la serie 1 en la hoja de gráficos 1.

Charts(1).SeriesCollection(1).Format.Fill.ForeColor.RGB = rgbRed

En el ejemplo siguiente, el gráfico denominado Sales se mueve al final del libro activo.

Charts("Sales").Move after:=Sheets(Sheets.Count)

El objeto Chart también es miembro de la colección Sheets, que contiene todas las hojas del libro (tanto las hojas de gráficos como las hojas de cálculo). Use Sheets(índice), donde índice es el número o nombre del índice de la hoja para devolver una sola hoja.

Cuando un gráfico es el objeto activo, puede usar la propiedad ActiveChart para hacer referencia a él. Una hoja de gráficos está activa si el usuario la ha seleccionado o si se ha activado mediante el método Activate del objeto Chart o el método Activate del objeto ChartObject.

En el ejemplo siguiente, se activa la hoja de gráficos 1 y luego se define el tipo de gráfico y el título.

Charts(1).Activate 
With ActiveChart 
 .Type = xlLine 
 .HasTitle = True 
 .ChartTitle.Text = "January Sales" 
End With

Un gráfico insertado está activo si el usuario lo ha seleccionado o si el objeto ChartObject en el que se incluye se ha activado mediante el método Activate.

En el ejemplo siguiente, se activa el gráfico 1 incorporado en la hoja de cálculo 1 y luego se establece el tipo de gráfico y el título. Observe que una vez que se haya activado el gráfico incorporado, el código del ejemplo es el mismo que en el ejemplo anterior. Si usa la propiedad ActiveChart, podrá escribir código de Visual Basic que puede hacer referencia a un gráfico incorporado o una hoja de gráfico (el que esté activo).

Worksheets(1).ChartObjects(1).Activate 
ActiveChart.ChartType = xlLine 
ActiveChart.HasTitle = True 
ActiveChart.ChartTitle.Text = "January Sales"

Cuando una hoja de cálculo es la hoja activa, puede usar la propiedad ActiveSheet para hacer referencia a ella. En el ejemplo siguiente, se usa el método Activate para activar la hoja de gráficos denominada Chart1 y luego se establece como azul el color interno para la serie 1 del gráfico.

Charts("chart1").Activate 
ActiveSheet.SeriesCollection(1).Format.Fill.ForeColor.RGB = rgbBlue

Eventos

Métodos

Propiedades

Vea también

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.