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.
Возвращаемое значение
Элемент управления, добавленный в документ.
Исключения
Аргумент 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.
Возвращаемое значение
Элемент управления, добавленный в документ.
Исключения
Аргумент 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 метод.