ControlExtensions.AddListBox Yöntem (ControlCollection, Range, String)
Yeni bir ekler ListBox belirtilen aralık çalışma sayfası denetimi.
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 AddListBox ( _
controls As ControlCollection, _
range As Range, _
name As String _
) As ListBox
public static ListBox AddListBox(
this ControlCollection controls,
Range range,
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ğlanır.
- range
Tür: Microsoft.Office.Interop.Excel.Range
A Range , sınırları için bir denetim sağlar.
- name
Tür: System.String
Denetimde dizin oluşturmak için kullanılan denetimin adını ControlCollection örneği.
Dönüş Değeri
Tür: Microsoft.Office.Tools.Excel.Controls.ListBox
ListBox 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öntemleri (Visual Basic) veya Genişletme Yöntemleri (C# Programlama Kılavuzu).
Özel Durumlar
Exception | Koşul |
---|---|
ArgumentNullException | Ad veya aralık bağımsız değişkeni nullnull başvuru (Visual Basic'te Nothing), ya da name bağımsız değişkeni sıfır uzunlukta. |
ControlNameAlreadyExistsException | Aynı ada sahip bir denetim içinde ControlCollection örneği. |
InvalidRangeException | Belirtilen aralık geçerli değil.Multi-Area aralıkları kullanılamaz.Aralığı aynı çalışma sayfasında olması gereken ControlCollection örneği. |
Notlar
AddListBox Yöntemi eklemenize olanak sağlayan ListBox sonuna kadar nesne ControlCollection.Kaldırmak için bir ListBox , daha önce eklenmiştir programlı olarak, kullanmak Remove yöntemi.
Aralığı yeniden boyutlandırıldığında denetimi otomatik olarak yeniden boyutlandırır.
Örnekler
Aşağıdaki kod örneği ekler bir ListBox hücreleri denetime A1 ile B6, iki öğe için liste kutusu ekler ve ilk öğeyi seçer.Çalıştır buradan bu örneği kullanmak için Sheet1 bir belge düzeyinde proje sınıfında.
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
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;
}
.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üvenilen Koddan Kitaplıkları Kullanma.