ControlExtensions.AddPictureBox Yöntem (ControlCollection, Double, Double, Double, Double, String)

Makale
08/01/2011

Yeni bir ekler PictureBox denetlemek için çalışma sayfasında belirtilen boyut ve konum.

Ad alanı: Microsoft.Office.Tools.Excel
Derleme: Microsoft.Office.Tools.Excel.v4.0.Utilities (Microsoft.Office.Tools.Excel.v4.0.Utilities.dll içinde)

Sözdizimi

'Bildirim
<ExtensionAttribute> _
Public Shared Function AddPictureBox ( _
    controls As ControlCollection, _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As PictureBox

public static PictureBox AddPictureBox(
    this ControlCollection controls,
    double left,
    double top,
    double width,
    double height,
    string name
)

Parametreler

controls
Tür: Microsoft.Office.Tools.Excel.ControlCollection
Denetim eklemek için koleksiyon.Bu parametre kendinizin saðlamasý değil.Tarafından döndürülen koleksiyonu bu yöntem aradığınızda Worksheet.Controls (uygulama düzeyinde projedeki) özelliği veya WorksheetBase.Controls özelliği (bir belge düzeyinde projesinde), bu parametre otomatik olarak sağlanan.

left
Tür: System.Double
Nokta denetiminin sol kenarına çalışma sayfasının sol kenarı arasındaki uzaklık.

top
Tür: System.Double
Nokta denetim üst kenarı çalışma sayfasının üst kenarı arasındaki uzaklık.

width
Tür: System.Double
Puan denetimin genişliği.

height
Tür: System.Double
Denetim noktaları içinde yüksekliği.

name
Tür: System.String
Denetimin ady.

Dönüş Değeri

Tür: Microsoft.Office.Tools.Excel.Controls.PictureBox
PictureBox Eklenmiştir denetim ControlCollection örneği.

Kullanım Notu

Visual Basic ve C# programlarında, bu yöntemi ControlCollection türündeki herhangi bir nesne üzerinde örnek yöntemi olarak çağırabilirsiniz. Bu yöntemi çağırmak için örnek yöntemi sözdizimini kullandığınızda, ilk parametreyi yok sayın. Daha fazla bilgi için bkz. Uzantı Yöntemler (@) veya Uzantı Yöntemler (C# programlama Kılavuzu).

Özel Durumlar

Exception	Koşul
ArgumentNullException	Ad bağımsız değişkeni nullnull başvuru (Visual Basic\'te Nothing) veya sıfır uzunluk.
ControlNameAlreadyExistsException	Aynı ada sahip bir denetim söz ControlCollection örneği.

Açıklamalar

AddPictureBox Yöntemi sağlar ekleme PictureBox sonuna kadar nesneleri ControlCollection. Kaldırmak için bir PictureBox önceden programlı olarak eklenen Denetim ve Remove yöntemi.

Örnekler

Aşağıdaki kod örneği ekler bir PictureBox kontrol çalışma sayfasının en üstüne ve sonra ekler bir görüntü. Adlı bir dosya örnek varsayar Image.jpg var kökündeki c dizin. Bu örneği kullanmak için çalıştırın buradan Sheet1 sınıfında bir belge düzeyinde proje.

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

.NET Framework Güvenliği

Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. kısmen güvenilir kod tarafından Kitaplıklar kullanma.

Ayrıca bkz.

Başvuru

ControlExtensions Sınıf

AddPictureBox Fazla Yük

Microsoft.Office.Tools.Excel Ad Alanı

Aracılığıyla paylaş