Range.Insert メソッド (Excel)

ワークシートまたはマクロ シートの指定された範囲に、空白のセルまたはセル範囲を挿入します。指定された範囲にあったセルはシフトされます。

構文

Insert (Shift、CopyOrigin)

expressionRange オブジェクトを表す変数です。

パラメーター

名前 必須 / オプション データ型 説明
Shift 省略可能 バリアント型 (Variant) セルをシフトする方向を指定します。 XlInsertShiftDirection 定数のいずれかを指定できます: xlShiftToRight または xlShiftDown。 この引数を省略すると、セル範囲の形に応じてシフト方向が自動的に決定されます。
CopyOrigin 省略可能 バリアント型 (Variant) コピーの原点。つまり、挿入されたセルの書式をコピーする場所です。 XlInsertFormatOrigin 定数として、xlFormatFromLeftOrAbove (既定値) または xlFormatFromRightOrBelow のいずれかを指定できます。

戻り値

バリアント型

注釈

Excel にセルをインタラクティブに挿入するときに、[書式のクリア] と同等の CopyOrigin 値はありません。 これを実現するには、 ClearFormats メソッドを使用します

With Range("B2:E5")
    .Insert xlShiftDown
    .ClearFormats
End With

この例では、ヘッダー行からではなく、下の行 (行 3) から書式をコピーして、行 2 の上に行を挿入します。

Range("2:2").Insert CopyOrigin:=xlFormatFromRightOrBelow

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。