Chart

本文介绍与表格文档Chart相关的API。

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 = '这是新标题';
    }
阿里云首页 智能媒体管理 相关技术圈