Office Scriptsでセルのテキストを取得する - Excel

Office Scriptsでセルのテキストを取得するコードを紹介します。

概要

Office Scirptsでセルのテキストを取得する場合は、ExcelScripts.Range オブジェクトの getValue() メソッドを利用します。

書式

コード

Office Scriptsを作成します。
以下のコードを記述します。

function main(workbook: ExcelScript.Workbook) {
  let sheet: ExcelScript.Worksheet = workbook.getWorksheets()[0];
  let celltext: string = sheet.getRange("B2").getValue() as string;
  sheet.getRange("F2").setValue("input:"+celltext);
}

解説

シートオブジェクトを取得します。[0]を指定しているため、一番最初のシートオブジェクト(ExcelScripts.WorkSheet)をsheet変数に代入します。

  let sheet: ExcelScript.Worksheet = workbook.getWorksheets()[0];

ExcelScripts.WorkSheetオブジェクトのgetRangeメソッドを呼び出し、ExcelScript.Rangeオブジェクトを取得します。 getRangeメソッドの引数に取得するセルの範囲を与えます。今回のコードでは "B2" を与えていますので、 B2セルがExcelScripts.Rangeオブジェクトで取得されます。
getRange()メソッドで取得した、ExcelScript.RangeオブジェクトのgetValue()メソッドを呼び出しセルの値を変数(celltext)に代入します。

let celltext: string = sheet.getRange("B2").getValue() as string;

celltext変数の値の先頭に "input:" の文字列を追加しF2セルに表示します。 セルへの文字列の設定はこちらの記事を参照してください。

sheet.getRange("F2").setValue("input:"+celltext);

実行結果

スクリプトのコードを記述後、B2セルに値を入力します。


[コード エディタ]ウィンドウの[実行]ボタンをクリックします。


F2セルにB2セルに入力した文字列の先頭に"input:"の文字列を追加した文字列が設定されます。


Office Scriptsでセルの値を取得することができました。