NamedRange.Insert(Object, Object) Метод

Определение

Вставляет ячейку или диапазон ячеек в элемент управления NamedRange и сдвигает остальные ячейки, чтобы освободить место.

public object Insert (object Shift, object CopyOrigin);

Параметры

Shift
Object

Указывает, каким способом должны сдвигаться ячейки. Может быть одно из следующих значений XlInsertShiftDirection: xlShiftToRight или xlShiftDown. Если этот аргумент не указан, Microsoft Office Excel принимает решение в зависимости от формы диапазона.

CopyOrigin
Object

Одно из значений типа XlInsertFormatOrigin, которое указывает, где получить формат, применяемый к новым ячейкам.

Возвращаемое значение

Object

Примеры

В следующем примере кода значения задаются в ячейках с a1 по A3, а затем с помощью Insert метода вставляется пустая ячейка в NamedRange элемент управления с именем, равным NamedRange1 ячейке a1. Эта операция сдвигает ячейки в диапазоне вниз, что означает, что NamedRange1 теперь задано значение ячейка a2. Чтобы продемонстрировать это, в примере задается значение NamedRange1 Raven , которое отображается в ячейке A2.

Этот пример предназначен для настройки на уровне документа.

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

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

    namedRange1.Insert(Excel.XlInsertShiftDirection.xlShiftDown);
    namedRange1.Value2 = "Raven";
}
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

Комментарии

Необязательные параметры

Дополнительные сведения о необязательных параметрах см. в разделе необязательные параметры в решениях Office.

Применяется к