ControlExtensions.AddTextBox Yöntem (ControlCollection, Range, String)
Yeni bir ekler TextBox 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 AddTextBox ( _
controls As ControlCollection, _
range As Range, _
name As String _
) As TextBox
public static TextBox AddTextBox(
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ğlanan.
- range
Tür: Microsoft.Office.Interop.Excel.Range
A Range sınırları için 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.TextBox
TextBox 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 veya aralık bağımsız değişkeni nullnull başvuru (Visual Basic\'te Nothing), veya adı bağımsız değişkeni sıfır uzunluk. |
ControlNameAlreadyExistsException | Aynı ada sahip bir denetim söz ControlCollection örneği. |
InvalidRangeException | Belirtilen aralık geçerli değil. Multi-Area aralıkları kullanılamaz. Aralık aynı çalışma sayfasında olması ControlCollection örneği. |
Açıklamalar
AddTextBox Yöntemi sağlar ekleme TextBox sonuna kadar nesneleri ControlCollection. Kaldırmak için bir TextBox , önceden eklenmiştir programlı, kullanın Remove yöntemi.
Aralığı yeniden boyutlandırıldığında denetim otomatik olarak yeniden boyutlandırır.
Örnekler
Aşağıdaki kod örneği ekler bir TextBox hücreleri denetime A1 ile B2ve sonra metin denetimine atar. Bu örneği kullanmak için çalıştırın buradan Sheet1 sınıfında bir belge düzeyinde proje.
Private Sub ExcelRangeAddTextBox()
Dim TextBox1 As Microsoft.Office.Tools.Excel. _
Controls.TextBox = Me.Controls.AddTextBox( _
Me.Range("A1", "B2"), "TextBox1")
TextBox1.Text = "Sample text"
End Sub
private void ExcelRangeAddTextBox()
{
Microsoft.Office.Tools.Excel.Controls.TextBox
textBox1 = this.Controls.AddTextBox(
this.Range["A1", "B2"], "textBox1");
textBox1.Text = "Sample text";
}
.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.