Metoda ControlExtensions.AddRichTextBox — (ControlCollection, Single, Single, Single, Single, String)
Dodano 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
Kolekcja, aby dodać formant.Nie podano tego parametru samodzielnie.Kiedy 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 znajdującego się w punktach.
- name
Typ: System.String
Nazwę, która może 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 Rozszerzenie metody (Visual Basic) lub Rozszerzenie metody (Podręcznik programowania C#).
Wyjątki
| Wyjątek | Warunek |
|---|---|
| ArgumentNullException | name Argument jest nullodwołanie o wartości null (Nothing w języku Visual Basic) lub ma zerową długość. |
| ControlNameAlreadyExistsException | Formant o tej samej nazwie jest już pod ControlCollection wystąpienie. |
Uwagi
Ta metoda umożliwia dodanie RichTextBox obiektów na koniec ControlCollection.
Aby usunąć RichTextBox który został dodany programowo, należy użyć Remove metoda.
Przykłady
Poniższy przykład kodu dodaje RichTextBox tym tekstem steruje do początku dokumentu, tekst przypisuje do formantu, a następnie formaty.Aby wykorzystać ten przykład, należy uruchomić go z ThisDocument klasy w projekcie na 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 Przy użyciu bibliotek z częściowo zaufanego kodu..