ControlCollection.AddPictureBox-Methode (Double, Double, Double, Double, String) (2007 System)

  • Artikel

Aktualisiert: November 2007

Fügt dem Arbeitsblatt an der angegebenen Position ein neues PictureBox-Steuerelement in der angegebenen Größe hinzu.

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

Syntax

Public Function AddPictureBox ( _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As PictureBox

Dim instance As ControlCollection
Dim left As Double
Dim top As Double
Dim width As Double
Dim height As Double
Dim name As String
Dim returnValue As PictureBox

returnValue = instance.AddPictureBox(left, _
    top, width, height, name)

public PictureBox AddPictureBox(
    double left,
    double top,
    double width,
    double height,
    string name
)

Parameter

  • left
    Typ: System.Double

    Die Entfernung zwischen dem linken Rand des Steuerelements und dem linken Rand des Arbeitsblatts in Punkt.

  • top
    Typ: System.Double

    Die Entfernung zwischen dem oberen Rand des Steuerelements und dem oberen Rand des Arbeitsblatts in Punkt.

  • width
    Typ: System.Double

    Die Breite des Steuerelements in Punkt.

  • height
    Typ: System.Double

    Die Höhe des Steuerelements in Punkt.

Rückgabewert

Typ: Microsoft.Office.Tools.Excel.Controls.PictureBox

Das PictureBox-Steuerelement, das der ControlCollection-Instanz hinzugefügt wurde.

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

Das Argument für den Namen ist nullNULL-Verweis (Nothing in Visual Basic) oder hat die Länge 0 (null).
ControlNameAlreadyExistsException

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

Hinweise

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

Beispiele

Im folgenden Codebeispiel wird oben im Arbeitsblatt 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.

Private Sub ExcelAddPictureBox()

    Dim PictureBox1 As Microsoft.Office.Tools. _
        Excel.Controls.PictureBox = Me.Controls. _
        AddPictureBox(0, 0, 150, 150, "PictureBox1")

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

End Sub


private void ExcelAddPictureBox()
{

    Microsoft.Office.Tools.Excel.Controls.PictureBox
         pictureBox1 = this.Controls.AddPictureBox(
         0, 0, 150, 150, "pictureBox1");
    pictureBox1.Image = System.Drawing.Image.FromFile(
        "C:\\Image.jpg");
}

Berechtigungen

Siehe auch

Referenz

ControlCollection-Klasse

ControlCollection-Member

AddPictureBox-Überladung

Microsoft.Office.Tools.Excel-Namespace