图表(Chart)

单个图表对象

属性列表

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

方法列表

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

SetSourceData()

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

语法

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

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

参数

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

示例

//@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

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

示例

//@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

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

示例

//@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

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

示例

//@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
}