Freigeben über


ControlExtensions.AddPictureBox-Methode (ControlCollection, Range, String)

Fügt dem Arbeitsblatt im angegebenen Bereich ein neues PictureBox-Steuerelement hinzu.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

'Declaration
<ExtensionAttribute> _
Public Shared Function AddPictureBox ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As PictureBox
public static PictureBox AddPictureBox(
    this ControlCollection controls,
    Range range,
    string name
)

Parameter

  • controls
    Typ: Microsoft.Office.Tools.Excel.ControlCollection
    Die Auflistung, der das Steuerelement hinzugefügt werden soll.Geben Sie diesen Parameter nicht selbst an.Wenn Sie diese Methode für die von der Worksheet.Controls-Eigenschaft (in einem Projekt auf Anwendungsebene) oder von der WorksheetBase.Controls-Eigenschaft (in einem Projekt auf Dokumentebene) zurückgegebene Auflistung aufrufen, wird dieser Parameter automatisch angegeben.

Rückgabewert

Typ: Microsoft.Office.Tools.Excel.Controls.PictureBox
Das PictureBox-Steuerelement, das der ControlCollection-Instanz hinzugefügt wurde.

Hinweis zur Verwendung

In Visual Basic und C# können Sie diese Methode als Instanzenmethode für ein beliebiges Objekt vom Typ ControlCollection aufrufen. Bei Verwendung der Syntax für Instanzenmethoden lassen Sie den ersten Parameter aus. Weitere Informationen finden Sie unter Erweiterungsmethoden (Visual Basic) und Erweiterungsmethoden (C#-Programmierhandbuch).

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

Das Argument für den Namen oder den Bereich ist nullein Nullverweis (Nothing in Visual Basic), oder das Argument für den Namen hat die Länge 0 (null).

ControlNameAlreadyExistsException

Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection-Instanz vorhanden.

InvalidRangeException

Der angegebene Bereich ist nicht gültig.Bereiche, die mehrere Bereiche enthalten, können nicht verwendet werden.Der Bereich muss sich auf dem gleichen Arbeitsblatt wie die ControlCollection-Instanz befinden.

Hinweise

Mithilfe der AddPictureBox-Methode können Sie PictureBox-Objekte am Ende der ControlCollection hinzufügen.Um einen PictureBox zu entfernen, der zuvor programmgesteuert hinzugefügt wurde, verwenden Sie die Remove-Methode.

Die Größe des Steuerelements wird automatisch geändert, wenn die Größe des Bereichs geändert wird.

Beispiele

Im folgenden Codebeispiel wird den Zellen A1 bis C12 ein PictureBox-Steuerelement hinzugefügt, und dann wird ein Bild hinzugefügt.Dabei wird davon ausgegangen, dass im Stammverzeichnis von C:\ eine Datei mit dem Namen Image.jpg vorhanden ist.Wenn Sie dieses Beispiel verwenden möchten, führen Sie es in der Sheet1-Klasse in einem Projekt auf Dokumentebene aus.

    Private Sub ExcelRangeAddPictureBox()

        Dim PictureBox1 As Microsoft.Office.Tools. _
            Excel.Controls.PictureBox = Me.Controls. _
            AddPictureBox(Me.Range("A1", "C12"), _
            "PictureBox1")

        PictureBox1.Image = System.Drawing.Image. _
            FromFile("C:\Image.jpg")

    End Sub

private void ExcelRangeAddPictureBox()
{

    Microsoft.Office.Tools.Excel.Controls.PictureBox
         pictureBox1 = this.Controls.AddPictureBox(
         this.Range["A1", "C12"], "pictureBox1");
    pictureBox1.Image = System.Drawing.Image.FromFile(
        "C:\\Image.jpg");
}

.NET Framework-Sicherheit

Siehe auch

Referenz

ControlExtensions Klasse

AddPictureBox-Überladung

Microsoft.Office.Tools.Excel-Namespace