Metoda ControlExtensions.AddRichTextBox — (ControlCollection, Single, Single, Single, Single, String)

Dodaje nowy RichTextBox formantu do dokumentu w określonym rozmiarze i lokalizacji.

Przestrzeń nazw:  Microsoft.Office.Tools.Word
Zestaw:  Microsoft.Office.Tools.Word.v4.0.Utilities (w Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Składnia

'Deklaracja
<ExtensionAttribute> _
Public Shared Function AddRichTextBox ( _
    controls As ControlCollection, _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As RichTextBox

public static RichTextBox AddRichTextBox(
    this ControlCollection controls,
    float left,
    float top,
    float width,
    float height,
    string name
)

Parametry

• controls
  Typ: Microsoft.Office.Tools.Word.ControlCollection
  Aby dodać formant do kolekcji.Nie zostanie podany parametr ten sam.Jeśli wywołanie tej metody na kolekcja zwróconego przez Document.Controls właściwość (w projekcie poziomie aplikacji) lub DocumentBase.Controls właściwość (w projekcie poziomie dokumentu), parametr ten jest dostarczany automatycznie.

• left
  Typ: System.Single
  Odległość w punktach między lewą krawędzią formantu a lewą krawędzią dokumentu.

• top
  Typ: System.Single
  Odległość w punktach między górną krawędzią formantu a górną krawędzią dokumentu.

• width
  Typ: System.Single
  Szerokość formantu znajdującego się w punktach.

• height
  Typ: System.Single
  Wysokość formantu w punktach.

• name
  Typ: System.String
  Nazwy, które mogą być używane do indeksowania formantu znajdującego się w ControlCollection wystąpienie.

Wartość zwracana

Typ: Microsoft.Office.Tools.Word.Controls.RichTextBox
Formant, który został dodany do dokumentu.

Informacje dotyczące użycia

W językach Visual Basic i C# tę metodę można wywołać jako metodę wystąpienia dowolnego obiektu typu ControlCollection. Gdy w celu wywołania tej metody jest używana składnia metody wystąpienia, należy pominąć pierwszy parametr. Aby uzyskać więcej informacji, zobacz temat Metody rozszerzeń (Visual Basic) lub Metody rozszerzeń (Przewodnik programowania w języku C#).

Wyjątki

Uwagi

Ta metoda umożliwia dodanie RichTextBox obiektów na koniec ControlCollection.

Aby usunąć RichTextBox że dodano programowo, należy użyć Remove metody.

Przykłady

Poniższy kod dodaje RichTextBox kontroli na początek dokumentu, tekst przypisuje do formantu, a następnie formatów tekstu.Aby wykorzystać ten przykład, należy uruchomić go z ThisDocument klasy w projekcie poziomie dokumentu.

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 

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

Zabezpieczenia programu .NET Framework

• Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.

Zobacz też

Informacje

ControlExtensions Klasa

Przeciążenie AddRichTextBox

Przestrzeń nazw Microsoft.Office.Tools.Word