ControlExtensions.AddRichTextBox Methode

Definition

Überlädt

AddRichTextBox(ControlCollection, Range, Single, Single, String)

Fügt dem Dokument in der angegebenen Größe und an der angegebenen Position ein neues RichTextBox-Steuerelement hinzu.

AddRichTextBox(ControlCollection, Single, Single, Single, Single, String)

Fügt dem Dokument in der angegebenen Größe und an der angegebenen Position ein neues RichTextBox-Steuerelement hinzu.

AddRichTextBox(ControlCollection, Range, Single, Single, String)

Fügt dem Dokument in der angegebenen Größe und an der angegebenen Position ein neues RichTextBox-Steuerelement hinzu.

public static Microsoft.Office.Tools.Word.Controls.RichTextBox AddRichTextBox (this Microsoft.Office.Tools.Word.ControlCollection controls, Microsoft.Office.Interop.Word.Range range, float width, float height, string name);

Parameter

controls
ControlCollection

Die Auflistung, der das Steuerelement hinzugefügt werden soll. Geben Sie diesen Parameter nicht selbst an. Wenn Sie diese Methode für die von der Controls-Eigenschaft (in einem Projekt auf Anwendungsebene) oder von der Controls-Eigenschaft (in einem Projekt auf Dokumentebene) zurückgegebene Auflistung aufrufen, wird dieser Parameter automatisch angegeben.

range
Range

Der Speicherort des Steuerelements.

width
Single

Die Breite des Steuerelements in Punkt.

height
Single

Die Höhe des Steuerelements in Punkt.

name
String

Der Name, der zum Indizieren des Steuerelements in der ControlCollection-Instanz verwendet werden kann.

Gibt zurück

RichTextBox

Das Steuerelement, das dem Dokument hinzugefügt wurde.

Ausnahmen

Das name-Argument oder das range-Argument ist null, oder das name-Argument hat die Länge 0 (null).

Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection-Instanz vorhanden.

Der angegebene Bereich ist nicht gültig.

Beispiele

Im folgenden Codebeispiel wird dem RichTextBox ersten Absatz im Dokument ein-Steuerelement hinzugefügt, dem-Steuerelement Text zugewiesen und dann der Text formatiert. Um dieses Beispiel zu verwenden, führen Sie es von der- ThisDocument Klasse in einem Projekt auf Dokument Ebene aus.

private void WordRangeAddRichTextBox()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.RichTextBox
         richTextBox1 = this.Controls.AddRichTextBox(
         this.Paragraphs[1].Range, 75, 15, "richTextBox1");
    richTextBox1.Text = "Sample text";
    richTextBox1.Select(0, 6);
    richTextBox1.SelectionFont = new Font("Times New Roman",
        10, FontStyle.Bold);
}
Private Sub WordRangeAddRichTextBox()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim RichTextBox1 As Microsoft.Office.Tools.Word.Controls. _
        RichTextBox = Me.Controls.AddRichTextBox( _
        Me.Paragraphs(1).Range, 75, 15, "RichTextBox1")
    RichTextBox1.Text = "Sample text"
    RichTextBox1.Select(0, 6)
    RichTextBox1.SelectionFont = New Font("Times New Roman", _
        10, FontStyle.Bold)
End Sub 

Hinweise

Diese Methode ermöglicht es Ihnen,- RichTextBox Objekte am Ende der hinzuzufügen ControlCollection .

Verwenden Sie die-Methode, um eine RichTextBox , die Programm gesteuert hinzugefügt wurde, zu entfernen Remove .

Gilt für

AddRichTextBox(ControlCollection, Single, Single, Single, Single, String)

Fügt dem Dokument in der angegebenen Größe und an der angegebenen Position ein neues RichTextBox-Steuerelement hinzu.

public static Microsoft.Office.Tools.Word.Controls.RichTextBox AddRichTextBox (this Microsoft.Office.Tools.Word.ControlCollection controls, float left, float top, float width, float height, string name);

Parameter

controls
ControlCollection

Die Auflistung, der das Steuerelement hinzugefügt werden soll. Geben Sie diesen Parameter nicht selbst an. Wenn Sie diese Methode für die von der Controls-Eigenschaft (in einem Projekt auf Anwendungsebene) oder von der Controls-Eigenschaft (in einem Projekt auf Dokumentebene) zurückgegebene Auflistung aufrufen, wird dieser Parameter automatisch angegeben.

left
Single

Die Entfernung zwischen dem linken Rand des Steuerelements und dem linken Rand des Dokuments in Punkt.

top
Single

Die Entfernung zwischen dem oberen Rand des Steuerelements und dem oberen Rand des Dokuments in Punkt.

width
Single

Die Breite des Steuerelements in Punkt.

height
Single

Die Höhe des Steuerelements in Punkt.

name
String

Der Name, der zum Indizieren des Steuerelements in der ControlCollection-Instanz verwendet werden kann.

Gibt zurück

RichTextBox

Das Steuerelement, das dem Dokument hinzugefügt wurde.

Ausnahmen

Das name-Argument ist null oder hat die Länge 0 (null).

Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection-Instanz vorhanden.

Beispiele

Im folgenden Codebeispiel wird ein- RichTextBox Steuerelement am Anfang des Dokuments hinzugefügt, dem-Steuerelement Text zugewiesen und dann der Text formatiert. Um dieses Beispiel zu verwenden, führen Sie es von der- ThisDocument Klasse in einem Projekt auf Dokument Ebene aus.

private void WordAddRichTextBox()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.RichTextBox
         richTextBox1 = this.Controls.AddRichTextBox(
        0, 0, 75, 15, "richTextBox1");
    richTextBox1.Text = "Sample text";
    richTextBox1.Select(0, 6);
    richTextBox1.SelectionFont = new Font("Times New Roman",
        10, FontStyle.Bold);
}
Private Sub WordAddRichTextBox()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim RichTextBox1 As Microsoft.Office.Tools.Word.Controls. _
        RichTextBox = Me.Controls.AddRichTextBox(0, 0, 75, 15, _
        "RichTextBox1")
    RichTextBox1.Text = "Sample text"
    RichTextBox1.Select(0, 6)
    RichTextBox1.SelectionFont = New Font("Times New Roman", _
        10, FontStyle.Bold)
End Sub 

Hinweise

Diese Methode ermöglicht es Ihnen,- RichTextBox Objekte am Ende der hinzuzufügen ControlCollection .

Verwenden Sie die-Methode, um eine RichTextBox , die Programm gesteuert hinzugefügt wurde, zu entfernen Remove .

Gilt für