次の方法で共有


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 を使用したセルの操作」を参照してください。

セルの範囲を挿入する

次のコードサンプルは、場所 B4:E4 にセルの範囲を挿入し、他のセルを下にシフトして、新しいセルのためのスペースを提供します。

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

    range.insert(Excel.InsertShiftDirection.down);

    await context.sync();
});

範囲を挿入する前のデータ

範囲が挿入される前の Excel のデータ。

範囲を挿入した後のデータ

範囲が挿入された後の Excel のデータ。

関連項目