Metodo NamedRange.Insert

Articolo
08/11/2011

Inserisce una cella o un intervallo di celle nel controllo NamedRange e sposta le altre celle in modo da fare spazio.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
Function Insert ( _
    Shift As Object, _
    CopyOrigin As Object _
) As Object

Object Insert(
    Object Shift,
    Object CopyOrigin
)

Parametri

Shift
Tipo: System.Object
Specifica la direzione di spostamento delle celle.Può essere uno dei seguenti valori di XlInsertShiftDirection: xlShiftToRight o xlShiftDown.Se si omette questo argomento, l'azione viene decisa in base alla forma dell'intervallo.

CopyOrigin
Tipo: System.Object
Uno dei valori di XlInsertFormatOrigin che specifica la posizione in cui ottenere il formato da applicare alle nuove celle.

Valore restituito

Tipo: System.Object

Note

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito nelle celle da A1 a A3 vengono impostati dei valori. Viene quindi utilizzato il metodo Insert per inserire una cella vuota in un controllo NamedRange denominato NamedRange1 e impostato sulla cella A1. Questa operazione determina lo spostamento verso il basso delle celle nell'intervallo. NamedRange1 è a questo punto impostato sulla cella A2. A dimostrazione di questo fatto, nell'esempio il valore di NamedRange1 viene impostato su Raven, che viene visualizzato nella cella A2.

Questo esempio è valido per una personalizzazione a livello di documento.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Share via