Skip to content
本页内容

图表(Chart)

单个图表对象

属性列表

属性说明
设置标题
如果图表有图例,则该属性值为 true
如果坐标轴或图表有可见标题,则该属性值为 true

方法列表

方法说明
为指定图表设置源数据区域

SetSourceData()

为指定图表设置源数据区域

语法

表达式.ActiveWorkbook.ActiveSheet.Shapes.Item(Index).Chart.SetSourceData({ Source, PlotBy })

表达式:文档类型应用对象

参数

属性数据类型默认值必填说明
Source
Range
包含源数据的区域,可用 Range 对象
PlotBy
Enum
指定图表类型,对应 Enum.XlRowCol,可以为 xlColumns 或 xlRows

示例

js
//@file=base.xlsx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet

  // 图形对象
  const shapes = await activeSheet.Shapes

  // 单个图形对象
  const shape = await shapes.AddChart2(340, 51, 0, 0, 300, 300)

  // 单个图表对象
  const chart = await shape.Chart

  // 获取图表数据源
  const source = await activeSheet.Range('A1:D4')

  // 设置图表数据源
  await chart.SetSourceData(source, 1)
}

ChartTitle

设置标题

语法

表达式.ActiveWorkbook.ActiveSheet.Shapes.Item(Index).Chart.ChartTitle

表达式:文档类型应用对象

示例

js
//@file=base.xlsx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet

  // 图形对象
  const shapes = await activeSheet.Shapes

  // 单个图形对象
  const shape = await shapes.AddChart2(340, 51, 0, 0, 300, 300)

  // 单个图表对象
  const chart = await shape.Chart

  // 获取图表数据源
  const source = await activeSheet.Range('A1:D4')

  // 设置图表数据源
  await chart.SetSourceData(source, 1)

  // 设置新标题
  chart.ChartTitle.Text = '这是新标题'
}

HasLegend

如果图表有图例,则该属性值为 true

语法

表达式.ActiveWorkbook.ActiveSheet.Shapes.Item(Index).Chart.HasLegend

表达式:文档类型应用对象

示例

js
//@file=base.xlsx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet

  // 图形对象
  const shapes = await activeSheet.Shapes

  // 单个图形对象
  const shape = await shapes.AddChart2(340, 51, 0, 0, 300, 300)

  // 单个图表对象
  const chart = await shape.Chart

  // 获取图表数据源
  const source = await activeSheet.Range('A1:D4')

  // 设置图表数据源
  await chart.SetSourceData(source, 1)

  // 设置图例不可见
  chart.HasLegend = false
}

HasTitle

如果坐标轴或图表有可见标题,则该属性值为 true

语法

表达式.ActiveWorkbook.ActiveSheet.Shapes.Item(Index).Chart.HasTitle

表达式:文档类型应用对象

示例

js
//@file=base.xlsx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet

  // 图形对象
  const shapes = await activeSheet.Shapes

  // 单个图形对象
  const shape = await shapes.AddChart2(340, 51, 0, 0, 300, 300)

  // 单个图表对象
  const chart = await shape.Chart

  // 获取图表数据源
  const source = await activeSheet.Range('A1:D4')

  // 设置图表数据源
  await chart.SetSourceData(source, 1)

  // 设置标题不可见
  chart.HasTitle = false
}