Excel JavaScript API を使用してセル範囲を挿入する

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

重要な点

• Range.insertを使用して新しいセルを追加し、既存のセルをシフトしてスペースを作成します。
• シフト方向を下または右に指定します。
• 既存のセルは、新しい空のセルに合わせて移動します。
• セル参照を含む数式は、挿入後に自動的に調整されます。

セルの範囲を挿入する

Range.insert メソッドは、ワークシートに新しい空のセルを追加し、既存のセルをシフトしてスペースを作成します。 既存のセルをシフトする方向 (下または右) を指定する必要があります。 これは、上書きせずに既存のコンテンツの中央にデータを追加する場合に便利です。

次のコードサンプルは、場所 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();
});

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

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

関連項目

• Office アドインの Excel JavaScript オブジェクト モデル
• Excel JavaScript API を使用してセルを操作する
• Excel JavaScript API を使用して範囲をクリアまたは削除する
• Excel JavaScript API を使用して範囲の値、テキスト、または数式を設定して取得する
• Excel JavaScript API を使用して範囲を切り取り、コピー、貼り付ける