ControlExtensions.AddRichTextBox Yöntem (ControlCollection, Double, Double, Double, Double, String)
Yeni bir ekler RichTextBox çalışma sayfasında belirtilen boyutunu ve konumunu denetlemek.
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 AddRichTextBox ( _
controls As ControlCollection, _
left As Double, _
top As Double, _
width As Double, _
height As Double, _
name As String _
) As RichTextBox
public static RichTextBox AddRichTextBox(
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ğlanır.
- 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ını ç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ı yüksekliği.
- name
Tür: System.String
Denetimin adı.
Dönüş Değeri
Tür: Microsoft.Office.Tools.Excel.Controls.RichTextBox
RichTextBox 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 bağımsız değişkeni nullnull başvuru (Visual Basic'te Nothing) veya sıfır uzunlukta. |
| ControlNameAlreadyExistsException | Aynı ada sahip bir denetim içinde ControlCollection örneği. |
Notlar
AddRichTextBox Yöntemi eklemenize olanak sağlayan RichTextBox sonuna kadar nesne ControlCollection.Kaldırmak için bir RichTextBox önceden programlı olarak eklenmiş olan denetim ve Remove yöntemi.
Örnekler
Aşağıdaki kod örneği ekler bir RichTextBox atar metin denetimi ve sonra biçimleri çalışma sayfasının en üstüne metni kontrol eder.Çalıştır buradan bu örneği kullanmak için Sheet1 bir belge düzeyinde proje sınıfında.
Private Sub ExcelRangeAddRichTextBox()
Dim RichTextBox1 As Microsoft.Office.Tools. _
Excel.Controls.RichTextBox = Me.Controls. _
AddRichTextBox(Me.Range("A1", "B2"), _
"RichTextBox1")
RichTextBox1.Text = "Sample text"
RichTextBox1.Select(0, 6)
RichTextBox1.SelectionFont = New Font( _
"Times New Roman", 10, FontStyle.Bold)
End Sub
private void ExcelRangeAddRichTextBox()
{
Microsoft.Office.Tools.Excel.Controls.RichTextBox
richTextBox1 = this.Controls.AddRichTextBox(
this.Range["A1", "B2"], "richTextBox1");
richTextBox1.Text = "Sample text";
richTextBox1.Select(0, 6);
richTextBox1.SelectionFont = new Font("Times New Roman",
10, FontStyle.Bold);
}
.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.