Excel JavaScript API を使用して範囲をクリアまたは削除する

この記事では、Excel JavaScript API を使用して範囲をクリアおよび削除するコード サンプルを提供します。 オブジェクトで Range サポートされているプロパティとメソッドの完全な一覧については、「 Excel.Range クラス」を参照してください。

注:

Excel JavaScript API には、"Cell" オブジェクトまたはクラスがありません。 代わりに、Excel JavaScript API はすべての Excel セルを Range オブジェクトとして定義します。 Excel UI の個々のセルは、Excel JavaScript API の 1 つのセルを持つ Range オブジェクトに変換されます。 1 つの Range オブジェクトに複数の連続したセルを含めることもできます。 詳しくは、「Excel JavaScript API を使用したセルの操作」を参照してください。

セルの範囲をクリアする

次のコード サンプルは、範囲 E2：E5 のセルの内容と書式をすべてクリアします。

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let range = sheet.getRange("E2:E5");

    range.clear();

    await context.sync();
});

範囲をクリアする前のデータ

範囲をクリアした後のデータ

セルの範囲を削除する

次のコード サンプルでは、 範囲 B4:E4 のセルを削除し、削除されたセルによって空いた領域を埋めるために他のセルをシフトします。

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let range = sheet.getRange("B4:E4");

    range.delete(Excel.DeleteShiftDirection.up);

    await context.sync();
});

範囲を削除する前のデータ

範囲を削除した後のデータ

関連項目

• Excel JavaScript API を使用してセルを操作する
• Excel JavaScript API を使用して範囲を設定および取得する
• Office アドインの Excel JavaScript オブジェクト モデル