金山文档开放平台

主题

回到顶部
本页内容

图表

Chart

单个图表对象

语法

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

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

示例 

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

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
}

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