Método NamedRange.Insert

Artigo
01/09/2014

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

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function Insert ( _
    Shift As Object, _
    CopyOrigin As Object _
) As Object

Object Insert(
    Object Shift,
    Object CopyOrigin
)

Parâmetros

Shift
Tipo: System.Object
Especifica que maneira do deslocamento das células.Pode ser um dos seguintes valores de XlInsertShiftDirection : xlShiftToRight ou xlShiftDown.Se esse argumento é omitido, Microsoft Office Excel decidir baseado na forma do intervalo.

CopyOrigin
Tipo: System.Object
Um dos valores de XlInsertFormatOrigin que especifica onde obter o formato para aplicar as novas células.

Valor de retorno

Tipo: System.Object

Comentários

Parâmetros Opcionais

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

Exemplos

Os seguintes valores de conjuntos de exemplo das células A1 com o A3, e usam o método de Insert para inserir uma célula em branco em um controle de NamedRange chamado NamedRange1 que será definida como a célula A1. Esta operação desloca as células no intervalo para baixo, o que significa que NamedRange1 agora está definido para a célula A2. Para demonstrar isso, o exemplo define o valor de NamedRange1 a Corvo, que exibe na célula A2.

Este exemplo é para uma personalização de um documento nível.

    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"].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";
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via