ControlExtensions.AddPictureBox Yöntem

  • Başvuru

Tanım

Ad Alanı:
Microsoft.Office.Tools.Excel
Bütünleştirilmiş Kod:
Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Aşırı Yüklemeler

AddPictureBox(ControlCollection, Range, String)

PictureBoxBelirtilen aralıktaki çalışma sayfasına yeni bir denetim ekler.
AddPictureBox(ControlCollection, Double, Double, Double, Double, String)

PictureBoxBelirtilen boyut ve konumdaki çalışma sayfasına yeni bir denetim ekler.

AddPictureBox(ControlCollection, Range, String)

PictureBoxBelirtilen aralıktaki çalışma sayfasına yeni bir denetim ekler.

public static Microsoft.Office.Tools.Excel.Controls.PictureBox AddPictureBox (this Microsoft.Office.Tools.Excel.ControlCollection controls, Microsoft.Office.Interop.Excel.Range range, string name);

Parametreler

controls
ControlCollection

Denetiminin ekleneceği koleksiyon. Bu parametreyi kendiniz sağlamayın. Bu yöntemi özelliği tarafından döndürülen koleksiyonda Controls (uygulama düzeyi projede) veya Controls özellikte (belge düzeyi projesinde) çağırdığınızda, bu parametre otomatik olarak sağlanır.

range
Range

RangeDenetimin sınırlarını sağlayan bir.

name
String

Örnekteki denetimin dizinini eklemek için kullanılabilen denetimin adı ControlCollection .

Döndürülenler

PictureBox

PictureBoxÖrneğe eklenen denetim ControlCollection .

Özel durumlar

ArgumentNullException

Ad veya Aralık bağımsız değişkeni null ya da ad bağımsız değişkeninin sıfır uzunluğu vardır.

ControlNameAlreadyExistsException

Örnekte aynı ada sahip bir denetim zaten var ControlCollection .

InvalidRangeException

Belirtilen aralık geçersiz. Çok alanlı aralıklar kullanılamaz. Aralık, örnekle aynı çalışma sayfasında olmalıdır ControlCollection .

Örnekler

Aşağıdaki kod örneği, PictureBox C12aracılığıyla a1 hücrelerine bir denetim ekler ve sonra bir görüntü ekler. Örnek, C dizininin kökünde adlı bir dosyanın var olduğunu varsayar Image.jpg . Bu örneği kullanmak için, Sheet1 belge düzeyindeki bir projedeki sınıfından çalıştırın.

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

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

Açıklamalar

AddPictureBoxYöntemi PictureBox , öğesinin sonuna nesne eklemenizi sağlar ControlCollection . PictureBoxDaha önce programlı olarak eklenen bir öğesini kaldırmak için yöntemini kullanın Remove .

Aralık yeniden boyutlandırılırken denetim otomatik olarak yeniden boyutlandırılır.

Şunlara uygulanır

AddPictureBox(ControlCollection, Double, Double, Double, Double, String)

PictureBoxBelirtilen boyut ve konumdaki çalışma sayfasına yeni bir denetim ekler.

public static Microsoft.Office.Tools.Excel.Controls.PictureBox AddPictureBox (this Microsoft.Office.Tools.Excel.ControlCollection controls, double left, double top, double width, double height, string name);

Parametreler

controls
ControlCollection

Denetiminin ekleneceği koleksiyon. Bu parametreyi kendiniz sağlamayın. Bu yöntemi özelliği tarafından döndürülen koleksiyonda Controls (uygulama düzeyi projede) veya Controls özellikte (belge düzeyi projesinde) çağırdığınızda, bu parametre otomatik olarak sağlanır.

left
Double

Denetimin sol kenarı ile çalışma sayfasının sol kenarı arasındaki uzaklık.

top
Double

Denetimin üst kenarı ile çalışma sayfasının üst kenarı arasındaki uzaklık.

width
Double

Nokta cinsinden denetim genişliği.

height
Double

Nokta cinsinden denetimin yüksekliği.

name
String

Denetimin adı.

Döndürülenler

PictureBox

PictureBoxÖrneğe eklenen denetim ControlCollection .

Özel durumlar

ArgumentNullException

Ad bağımsız değişkeni null sıfır uzunluğa sahip veya bu değeri aştı.

ControlNameAlreadyExistsException

Örnekte aynı ada sahip bir denetim zaten var ControlCollection .

Örnekler

Aşağıdaki kod örneği, PictureBox çalışma sayfasının üst kısmına bir denetim ekler ve sonra bir resim ekler. Örnek, C dizininin kökünde adlı bir dosyanın var olduğunu varsayar Image.jpg . Bu örneği kullanmak için, Sheet1 belge düzeyindeki bir projedeki sınıfından çalıştırın.

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

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

Açıklamalar

AddPictureBoxYöntemi PictureBox , öğesinin sonuna nesne eklemenizi sağlar ControlCollection . PictureBoxDaha önce programlı olarak eklenmiş bir denetimi kaldırmak için Remove yöntemini kullanın.

Şunlara uygulanır