ControlExtensions.AddRichTextBox Método

Definição

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

RichTextBox

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

RichTextBox

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.

Aplica-se a