ControlCollection.AddRichTextContentControl – metoda (String)
Přidá novou RichTextContentControl na aktuální výběr v dokumentu.
Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)
Syntaxe
'Deklarace
Function AddRichTextContentControl ( _
name As String _
) As RichTextContentControl
RichTextContentControl AddRichTextContentControl(
string name
)
Parametry
- name
Typ: System.String
Název nového ovládacího prvku.
Vrácená hodnota
Typ: Microsoft.Office.Tools.Word.RichTextContentControl
RichTextContentControl , Byl přidán do dokumentu.
Výjimky
Výjimka | Podmínka |
---|---|
ArgumentNullException | nameje nullodkaz null (Nothing v jazyce Visual Basic) nebo má nulovou délku. |
ControlNameAlreadyExistsException | Ovládací prvek se stejným názvem je již ControlCollection. |
Poznámky
Tuto metodu použijte, chcete-li přidat nový RichTextContentControl na aktuální výběr v dokumentu v době běhu.Další informace naleznete v tématu Přidání ovládacích prvků do dokumentů sady Office v době spuštění.
Příklady
Následující příklad kódu přidá novou RichTextContentControl na začátek dokumentu.
Tato verze je pro přizpůsobení úroveň dokument.Chcete-li použít tento kód, vložte jej do ThisDocument třídy v projektu a volání AddRichTextControlAtSelection metoda z ThisDocument_Startup metoda.
Dim richTextControl1 As Microsoft.Office.Tools.Word.RichTextContentControl
Private Sub AddRichTextControlAtSelection()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Select()
richTextControl1 = Me.Controls.AddRichTextContentControl("richTextControl1")
richTextControl1.PlaceholderText = "Enter your first name"
End Sub
private Microsoft.Office.Tools.Word.RichTextContentControl richTextControl1;
private void AddRichTextControlAtSelection()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
richTextControl1 = this.Controls.AddRichTextContentControl("richTextControl1");
richTextControl1.PlaceholderText = "Enter your first name";
}
Tato verze je pro úroveň aplikace doplněk který se zaměřuje .NET Framework 4 nebo .NET Framework 4.5.Chcete-li použít tento kód, vložte jej do ThisAddIn třídy v projektu a volání AddRichTextControlAtSelection metoda z ThisAddIn_Startup metoda.
Dim richTextControl1 As Microsoft.Office.Tools.Word.RichTextContentControl
Private Sub AddRichTextControlAtSelection()
If Me.Application.ActiveDocument Is Nothing Then
Return
End If
Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
vstoDoc.Paragraphs(1).Range.Select()
richTextControl1 = vstoDoc.Controls.AddRichTextContentControl("richTextControl1")
richTextControl1.PlaceholderText = "Enter your first name"
End Sub
private Microsoft.Office.Tools.Word.RichTextContentControl richTextControl1;
private void AddRichTextControlAtSelection()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
vstoDoc.Paragraphs[1].Range.Select();
richTextControl1 = vstoDoc.Controls.AddRichTextContentControl("richTextControl1");
richTextControl1.PlaceholderText = "Enter your first name";
}
Zabezpečení rozhraní .NET Framework
- Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.
Viz také
Referenční dokumentace
AddRichTextContentControl – přetížení
Microsoft.Office.Tools.Word – obor názvů
Další zdroje
Přidání ovládacích prvků do dokumentů sady Office v době spuštění
Jak: přidání ovládacích prvků obsahu v dokumentech aplikace Word