NamedRange.Insert(Object, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вставляет ячейку или диапазон ячеек в элемент управления NamedRange и сдвигает остальные ячейки, чтобы освободить место.
public object Insert (object Shift, object CopyOrigin);
Параметры
- Shift
- Object
Указывает, каким способом должны сдвигаться ячейки. Может быть одно из следующих значений XlInsertShiftDirection: xlShiftToRight или xlShiftDown. Если этот аргумент не указан, Microsoft Office Excel принимает решение в зависимости от формы диапазона.
- CopyOrigin
- Object
Одно из значений типа XlInsertFormatOrigin, которое указывает, где получить формат, применяемый к новым ячейкам.
Возвращаемое значение
Примеры
В следующем примере кода значения задаются в ячейках с 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.