NamedRange.Insert, méthode

Article
08/10/2011

Insère une cellule ou une plage de cellules dans le contrôle NamedRange et déplace les autres cellules pour créer de l'espace.

Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
Function Insert ( _
    Shift As Object, _
    CopyOrigin As Object _
) As Object

Object Insert(
    Object Shift,
    Object CopyOrigin
)

Paramètres

Shift
Type : System.Object
Spécifie la direction du déplacement des cellules.Il peut s'agir de l'une des valeurs XlInsertShiftDirection suivantes : xlShiftToRight ou xlShiftDown.Si cet argument est omis, Microsoft Office Excel prend la décision en fonction de la forme de la plage.

CopyOrigin
Type : System.Object
Une des valeurs XlInsertFormatOrigin qui indique où obtenir le format à appliquer aux nouvelles cellules.

Valeur de retour

Type : System.Object

Notes

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant définit des valeurs dans les cellules A1 à A3, puis utilise la méthode Insert pour insérer une cellule vide dans un contrôle NamedRange, appelé NamedRange1, auquel la cellule A1 est affectée. Cette opération déplace les cellules dans la plage vers le bas, ce qui signifie que la cellule A2 est maintenant affectée à NamedRange1. Pour illustrer cela, l'exemple affecte à NamedRange1 Raven, qui s'affiche dans la cellule A2.

Cet exemple illustre une personnalisation au niveau du document.

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms

Partager via