NamedRange.Insert 메서드

아티클
08/10/2011

셀이나 셀 범위를 NamedRange 컨트롤에 삽입하고 다른 셀을 이동하여 공간을 만듭니다.

네임스페이스: Microsoft.Office.Tools.Excel
어셈블리: Microsoft.Office.Tools.Excel(Microsoft.Office.Tools.Excel.dll)

구문

‘선언
Function Insert ( _
    Shift As Object, _
    CopyOrigin As Object _
) As Object

Object Insert(
    Object Shift,
    Object CopyOrigin
)

매개 변수

Shift
형식: System.Object
셀을 이동할 방향을 지정합니다.XlInsertShiftDirection 값인 xlShiftToRight 또는 xlShiftDown일 수 있습니다.이 인수를 생략하면 Microsoft Office Excel에서는 범위의 모양에 따라 결정합니다.

CopyOrigin
형식: System.Object
새 셀에 적용할 서식을 가져올 위치를 지정하는 XlInsertFormatOrigin 값 중 하나입니다.

반환 값

형식: System.Object

설명

선택적 매개 변수

선택적 매개 변수에 대한 자세한 내용은 Office 솔루션의 선택적 매개 변수를 참조하십시오.

예제

다음 코드 예제에서는 셀 A1부터 A3까지 값을 설정한 다음 Insert 메서드를 사용하여 셀 A1이 설정되어 있는 NamedRange1이라는 NamedRange 컨트롤에 빈 셀을 삽입합니다. 이 작업으로 인해 범위 안의 셀이 아래로 이동합니다. 즉, 이제 NamedRange1이 셀 A2로 설정됩니다. 이 상황을 보여 주기 위해 이 예제에서는 NamedRange1의 값을 Raven으로 설정하며 이 값은 셀 A2에 표시됩니다.

이 예제는 문서 수준 사용자 지정을 위한 것입니다.

    Private Sub InsertIntoRange()
        Me.Range("A1").Value2 = "Robin"
        Me.Range("A2").Value2 = "Sparrow"
        Me.Range("A3").Value2 = "Crow"

        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1"), _
            "namedRange1")

        namedRange1.Insert(Excel.XlInsertShiftDirection.xlShiftDown, )
        namedRange1.Value2 = "Raven"
    End Sub

private void InsertIntoRange()
{
    this.Range["A1", missing].Value2 = "Robin";
    this.Range["A2", missing].Value2 = "Sparrow";
    this.Range["A3", missing].Value2 = "Crow";

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", missing],
        "namedRange1");

    namedRange1.Insert(Excel.XlInsertShiftDirection.xlShiftDown, missing);
    namedRange1.Value2 = "Raven";
}

.NET Framework 보안

직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

NamedRange 인터페이스

Microsoft.Office.Tools.Excel 네임스페이스

Share via