ControlExtensions.AddRichTextBox Метод

Определение

Перегрузки

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

Добавляет в заданное расположение документа новый элемент управления RichTextBox указанного размера.

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

Добавляет в заданное расположение документа новый элемент управления RichTextBox указанного размера.

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

Добавляет в заданное расположение документа новый элемент управления RichTextBox указанного размера.

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

Параметры

controls
ControlCollection

Коллекция, в которую добавляется элемент управления. Не предоставляйте этот параметр вручную. При вызове этого метода для коллекции, возвращаемой свойством Controls (в проекте уровня приложения) или свойством Controls (в проекте уровня документа), данный параметр предоставляется автоматически.

range
Range

Расположение элемента управления.

width
Single

Ширина элемента управления в пунктах.

height
Single

Высота элемента управления в пунктах.

name
String

Имя, которое можно использовать для индексации элемента управления в экземпляре класса ControlCollection.

Возвращаемое значение

RichTextBox

Элемент управления, добавленный в документ.

Исключения

Аргумент name или range равен null, или аргумент name имеет нулевую длину.

Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection.

Указанный диапазон не существует.

Примеры

Следующий пример кода добавляет RichTextBox элемент управления в первый абзац документа, назначает элементу управления текст, а затем форматирует текст. Чтобы использовать этот пример, запустите его из ThisDocument класса в проекте уровня документа.

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 

Комментарии

Этот метод позволяет добавлять RichTextBox объекты в конец ControlCollection .

Чтобы удалить объект RichTextBox , который был добавлен программно, используйте Remove метод.

Применяется к

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

Добавляет в заданное расположение документа новый элемент управления RichTextBox указанного размера.

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

Параметры

controls
ControlCollection

Коллекция, в которую добавляется элемент управления. Не предоставляйте этот параметр вручную. При вызове этого метода для коллекции, возвращаемой свойством Controls (в проекте уровня приложения) или свойством Controls (в проекте уровня документа), данный параметр предоставляется автоматически.

left
Single

Расстояние в пунктах между левым краем элемента управления и левым краем документа.

top
Single

Расстояние в пунктах между верхним краем элемента управления и верхним краем документа.

width
Single

Ширина элемента управления в пунктах.

height
Single

Высота элемента управления в пунктах.

name
String

Имя, которое можно использовать для индексации элемента управления в экземпляре класса ControlCollection.

Возвращаемое значение

RichTextBox

Элемент управления, добавленный в документ.

Исключения

Аргумент name равен null или имеет нулевую длину.

Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection.

Примеры

Следующий пример кода добавляет RichTextBox элемент управления в начало документа, присваивает элементу управления текст, а затем форматирует текст. Чтобы использовать этот пример, запустите его из ThisDocument класса в проекте уровня документа.

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 

Комментарии

Этот метод позволяет добавлять RichTextBox объекты в конец ControlCollection .

Чтобы удалить объект RichTextBox , который был добавлен программно, используйте Remove метод.

Применяется к