ControlExtensions.AddRichTextBox Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| AddRichTextBox(ControlCollection, Range, Single, Single, String) |
Adiciona um novo controle RichTextBox ao documento no tamanho e local especificados. |
| AddRichTextBox(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um novo controle RichTextBox ao documento no tamanho e local especificados. |
AddRichTextBox(ControlCollection, Range, Single, Single, String)
Adiciona um novo controle RichTextBox ao documento no tamanho e local especificados.
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);
Parâmetros
- controls
- ControlCollection
A coleção a ser adicionada ao controle. Não forneça esse parâmetro. Quando você chama esse método na coleção retornada pela propriedade Controls (em um projeto no nível de aplicativo) ou Controls (em um projeto no nível de documento), esse parâmetro é fornecido automaticamente.
- range
- Range
O local do controle.
- width
- Single
A largura do controle em pontos.
- height
- Single
A altura do controle em pontos.
- name
- String
O nome que pode ser usado para indexar o controle na instância de ControlCollection.
Retornos
O controle que foi adicionado ao documento.
Exceções
O argumento name ou range é null ou o argumento name tem tamanho zero.
Um controle com o mesmo nome já está na instância de ControlCollection.
O intervalo que foi especificado não é válido.
Exemplos
O exemplo de código a seguir adiciona um RichTextBox controle ao primeiro parágrafo no documento, atribui texto ao controle e, em seguida, formata o texto. Para usar esse exemplo, execute-o na classe ThisDocument em um projeto no nível de documento.
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
Comentários
Esse método permite que você adicione RichTextBox objetos ao final do ControlCollection .
Para remover um RichTextBox que foi adicionado programaticamente, use o Remove método.
Aplica-se a
AddRichTextBox(ControlCollection, Single, Single, Single, Single, String)
Adiciona um novo controle RichTextBox ao documento no tamanho e local especificados.
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);
Parâmetros
- controls
- ControlCollection
A coleção a ser adicionada ao controle. Não forneça esse parâmetro. Quando você chama esse método na coleção retornada pela propriedade Controls (em um projeto no nível de aplicativo) ou Controls (em um projeto no nível de documento), esse parâmetro é fornecido automaticamente.
- left
- Single
A distância em pontos entre a borda esquerda do controle e a borda esquerda do documento.
- top
- Single
A distância em pontos entre a borda superior do controle e a borda superior do documento.
- width
- Single
A largura do controle em pontos.
- height
- Single
A altura do controle em pontos.
- name
- String
O nome que pode ser usado para indexar o controle na instância de ControlCollection.
Retornos
O controle que foi adicionado ao documento.
Exceções
O argumento name é null ou tem tamanho zero.
Um controle com o mesmo nome já está na instância de ControlCollection.
Exemplos
O exemplo de código a seguir adiciona um RichTextBox controle ao início do documento, atribui texto ao controle e, em seguida, formata o texto. Para usar esse exemplo, execute-o na classe ThisDocument em um projeto no nível de documento.
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
Comentários
Esse método permite que você adicione RichTextBox objetos ao final do ControlCollection .
Para remover um RichTextBox que foi adicionado programaticamente, use o Remove método.