Chart

ActiveWorkbook.ActiveSheet.Shapes.Item(Index).Chart

获取单个图表对象。

• 语法

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

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

• 示例

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

方法

ActiveWorkbook.ActiveSheet.Shapes.Item(Index).Chart.SetSourceData()

通过SetSourceData()方法，您可以为指定图表设置源数据区域。

• 语法

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

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

• 参数

  属性	数据类型	是否必填	描述
  Source	Range	是	包含源数据的区域，可用Range对象。
  PlotBy	Enum	否	指定源数据处于行中还是列中。更多信息，请参见XlRowCol。

• 示例

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

属性

ActiveWorkbook.ActiveSheet.Shapes.Item(Index).Chart.HasLegend

通过HasLegend属性，您可以设置图表的图例是否可见。

• 语法

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

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

  Boolean取值为true时，表示图表的图例可见，取值为false时，表示图表的图例不可见。

• 示例

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

ActiveWorkbook.ActiveSheet.Shapes.Item(Index).Chart.HasTitle

通过HasTitle属性，您可以设置图表的标题是否可见。

• 语法

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

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

  Boolean取值为true时，表示图表的标题可见，取值为false时，表示图表的标题不可见。

• 示例

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

ActiveWorkbook.ActiveSheet.Shapes.Item(Index).Chart.ChartTitle.Text

通过Text属性，您可以设置图表的标题。

• 语法

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

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

• 示例

  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 = '这是新标题';
  }