Officeスクリプトグラフの作成と基本操作まとめ

OfficeScripts（オフィススクリプト）でグラフの作成方法の操作方法をまとめて紹介します。

ドノ

スクリプト内のシート名・変数名・値などは例が入っていますので状況に応じて変更して使用してください。

ここでは下図のようにA1:B4にデータがあるとしてスクリプト例を紹介します。

グラフの作成・取得

まずはグラフの作成方法について紹介します。

グラフの作成

function main(workbook: ExcelScript.Workbook) {

    // アクティブなワークシートを取得
    const sheet = workbook.getActiveWorksheet();

    // グラフを作成
    let chart = sheet.addChart(ExcelScript.ChartType.columnClustered, sheet.getRange("A1:B4"));
}

上記のスクリプトを実行するとこのようなグラフが作成されます。

ドノ

ExcelScript.ChartTypeを変えることでいろいろなグラフを作成できます。

グラフの種類

ExcelScript.ChartType.columnClustered ：棒グラフ
ExcelScript.ChartType.columnStacked：積み上げ棒グラフ
ExcelScript.ChartType.line ：折れ線グラフ
ExcelScript.ChartType.pie ：円グラフ
ExcelScript.ChartType.xyscatter ：散布図

図形の取得（すべて or 名前指定）

function main(workbook: ExcelScript.Workbook) {
    
    // アクティブなワークシートを取得
    let sheet = workbook.getActiveWorksheet();

    // グラフを取得
    let charts = sheet.getCharts();           //すべてのグラフ
    let chart = sheet.getChart("グラフ 1");  //名前を指定したグラフ
}

グラフの名前の確認方法

グラフの名前は対象のグラフを選択するとワークシートの左上に表示されます。

グラフの名前の変更

function main(workbook: ExcelScript.Workbook) {

    // アクティブなワークシートを取得
    let sheet = workbook.getActiveWorksheet();

    // ワークシート上のグラフを取得
    let chart = sheet.getChart("グラフ 1");  //名前は適宜変更してください

    // 新しい名前に変更
    chart.setName("グラフ 2");                //名前は適宜変更してください
}

グラフの位置・サイズ

次にグラフの位置とサイズの変更方法について紹介します。

下記が位置設定・サイズ設定の例となります。それぞれ設定の数値を変更して利用してください。

function main(workbook: ExcelScript.Workbook) {

  // アクティブなワークシートを取得
  let sheet = workbook.getActiveWorksheet();

  // グラフを作成
  let chart = sheet.addChart(ExcelScript.ChartType.columnClustered, sheet.getRange("A1:B4"));

  // グラフの位置を設定
  chart.setTop(10);  // 上からの位置
  chart.setLeft(150); // 左からの位置

  // グラフのサイズを設定
  chart.setHeight(200); // 高さ
  chart.setWidth(400);  // 幅
}

上記の実行結果はこんな感じです。

グラフの装飾

次にグラフの装飾について紹介します。タイトル・軸設定・グラフの色変更などについて例を紹介します。

グラフのタイトル

function main(workbook: ExcelScript.Workbook) {

  // アクティブなワークシートを取得
  let sheet = workbook.getActiveWorksheet();

  // グラフを作成
  let chart = sheet.addChart(ExcelScript.ChartType.columnClustered, sheet.getRange("A1:B4"));

  // グラフのタイトルを設定
  chart.getTitle().setText("新しいタイトル");
}

上記の実行結果はこんな感じです。

グラフの軸ラベル

function main(workbook: ExcelScript.Workbook) {

  // アクティブなワークシートを取得
  let sheet = workbook.getActiveWorksheet();

  // グラフを作成
  let chart = sheet.addChart(ExcelScript.ChartType.columnClustered, sheet.getRange("A1:B4"));

  // グラフの軸ラベルを設定
  chart.getAxes().getCategoryAxis().getTitle().setText("X軸のタイトル");
  chart.getAxes().getValueAxis().getTitle().setText("Y軸のタイトル");
}

上記の実行結果はこんな感じです。

グラフの色変更

function main(workbook: ExcelScript.Workbook) {

    // アクティブなワークシートを取得
    let sheet = workbook.getActiveWorksheet();

    // グラフを作成
    let chart = sheet.addChart(ExcelScript.ChartType.columnClustered, sheet.getRange("A1:B4"));

    // グラフの色変更
    let series = chart.getSeries()[0];                  // 色変更するデータ系列を取得（例 0）
    series.getFormat().getFill().setSolidColor("blue"); // 色を青に設定
}

上記の実行結果はこんな感じです。

グラフの削除

次にグラフの削除について紹介します。

名前を指定して削除

function main(workbook: ExcelScript.Workbook) {

    // アクティブなワークシートを取得
    let sheet = workbook.getActiveWorksheet();

    // 削除したいグラフの名前を指定して取得
    let chart = sheet.getChart("グラフ 1");  //名前は適宜変更してください

    // グラフを削除
    chart.delete();
}

すべての図形を削除

function main(workbook: ExcelScript.Workbook) {

    // アクティブなワークシートを取得
    let sheet = workbook.getActiveWorksheet();

    // ワークシート上のすべてのグラフを取得
    let charts = sheet.getCharts();

    // すべての図形を削除
    charts.forEach(chart => {
        chart.delete();
    });
}