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

AddRichTextBox(ControlCollection, Range, String)

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

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

AddRichTextBox(ControlCollection, Range, String)

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

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

RichTextBox

RichTextBoxÖ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, RichTextBox a1 ile B2arası hücrelere bir denetim ekler, denetime metin atar ve sonra metni biçimlendirir. Bu örneği kullanmak için, Sheet1 belge düzeyindeki bir projedeki sınıfından çalıştırın.

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

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

Açıklamalar

AddRichTextBoxYöntemi RichTextBox , öğesinin sonuna nesne eklemenizi sağlar ControlCollection . RichTextBoxDaha ö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

AddRichTextBox(ControlCollection, Double, Double, Double, Double, String)

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

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

RichTextBox

RichTextBoxÖ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, RichTextBox çalışma sayfasının üst kısmına bir denetim ekler, denetime metin atar ve sonra metni biçimlendirir. Bu örneği kullanmak için, Sheet1 belge düzeyindeki bir projedeki sınıfından çalıştırın.

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

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

Açıklamalar

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

Şunlara uygulanır