NamedRange.Insert(Object, Object) Método

Definição

Insere uma célula ou um intervalo de células no controle NamedRange e desloca outras células para liberar espaço.

public object Insert (object Shift, object CopyOrigin);

Parâmetros

Shift
Object

Especifica em que direção deslocar as células. Pode ser um dos seguintes valores de XlInsertShiftDirection: xlShiftToRight ou xlShiftDown. Se esse argumento for omitido, o Microsoft Office Excel decidirá com base na forma do intervalo.

CopyOrigin
Object

Um dos valores de XlInsertFormatOrigin que especifica onde obter o formato para aplicar as novas células.

Retornos

Object

Exemplos

O exemplo de código a seguir define valores nas células A1 a a3 e, em seguida, usa o Insert método para inserir uma célula em branco em um NamedRange controle chamado NamedRange1 que é definido como a célula a1. Essa operação alterna as células no intervalo para baixo, o que significa que NamedRange1 agora está definido como a célula A2. Para demonstrar isso, o exemplo define o valor de NamedRange1 para Raven , que é exibido na célula A2.

Este exemplo destina-se a uma personalização no nível de documento.

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

Comentários

Parâmetros opcionais

Para obter informações sobre parâmetros opcionais, consulte parâmetros opcionais em soluções do Office.

Aplica-se a