ControlExtensions.AddListBox 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

AddListBox(ControlCollection, Range, String)

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

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

AddListBox(ControlCollection, Range, String)

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

public static Microsoft.Office.Tools.Excel.Controls.ListBox AddListBox (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

ListBox

ListBoxÖ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, ListBox a1 ile B6hücrelerine bir denetim ekler, liste kutusuna iki öğe ekler ve sonra ilk öğeyi seçer. Bu örneği kullanmak için, Sheet1 belge düzeyindeki bir projedeki sınıfından çalıştırın.

private void ExcelRangeAddListBox()
{

    Microsoft.Office.Tools.Excel.Controls.ListBox
         listBox1 = this.Controls.AddListBox(
         this.Range["A1", "B6"], "lisBox1");
    listBox1.Items.Add("First Item");
    listBox1.Items.Add("Second Item");
    listBox1.SelectedIndex = 0;
}

Private Sub ExcelRangeAddListBox()

    Dim ListBox1 As Microsoft.Office.Tools.Excel. _
        Controls.ListBox = Me.Controls.AddListBox( _
        Me.Range("A1", "B6"), "ListBox1")

    ListBox1.Items.Add("First Item")
    ListBox1.Items.Add("Second Item")
    ListBox1.SelectedIndex = 0

End Sub

Açıklamalar

AddListBoxYöntemi ListBox , öğesinin sonuna nesne eklemenizi sağlar ControlCollection . ListBoxDaha ö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

AddListBox(ControlCollection, Double, Double, Double, Double, String)

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

public static Microsoft.Office.Tools.Excel.Controls.ListBox AddListBox (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

ListBox

ListBoxÖ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, ListBox çalışma sayfasının üst kısmına bir denetim ekler, liste kutusuna iki öğe ekler ve sonra ilk öğeyi seçer. Bu örneği kullanmak için, Sheet1 belge düzeyindeki bir projedeki sınıfından çalıştırın.

private void ExcelAddListBox()
{

    Microsoft.Office.Tools.Excel.Controls.ListBox
         listBox1 = this.Controls.AddListBox(
         0, 0, 90, 71.25, "lisBox1");
    listBox1.Items.Add("First Item");
    listBox1.Items.Add("Second Item");
    listBox1.SelectedIndex = 0;
}

Private Sub ExcelAddListBox()

    Dim ListBox1 As Microsoft.Office.Tools.Excel. _
        Controls.ListBox = Me.Controls.AddListBox( _
        0, 0, 90, 71.25, "ListBox1")

    ListBox1.Items.Add("First Item")
    ListBox1.Items.Add("Second Item")
    ListBox1.SelectedIndex = 0

End Sub

Açıklamalar

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

Şunlara uygulanır