ControlCollection.AddPlainTextContentControl – metoda (Range, String)

Článek
08/11/2011

Přidá nový PlainTextContentControl na zadaný rozsah v dokumentu.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
Function AddPlainTextContentControl ( _
    range As Range, _
    name As String _
) As PlainTextContentControl

PlainTextContentControl AddPlainTextContentControl(
    Range range,
    string name
)

Parametry

range
Typ: Microsoft.Office.Interop.Word.Range
A Range , který poskytuje hranice pro nový ovládací prvek.

name
Typ: System.String
Název nového ovládacího prvku.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Word.PlainTextContentControl
PlainTextContentControl , 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ž v ControlCollection.

Poznámky

Tuto metodu lze použít k přidání nového PlainTextContentControl v určeném rozsahu dokumentu v čase zpracování. Další informace naleznete v tématu Adding Controls to Office Documents at Run Time.

Příklady

Následující příklad kódu přidá nový PlainTextContentControl na začátku dokumentu.

Tato verze je přizpůsobení úrovni dokumentu. Tento kód použít, vložte ji do ThisDocument třídy v projektu a volání AddTextControlAtRange Metoda z ThisDocument_Startup metody.

Dim plainTextControl2 As Microsoft.Office.Tools.Word.PlainTextContentControl

Private Sub AddPlainTextControlAtRange()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    plainTextControl2 = Me.Controls.AddPlainTextContentControl(Me.Paragraphs(1).Range, "plainTextControl2")
    plainTextControl2.PlaceholderText = "Enter your first name"
End Sub

private Microsoft.Office.Tools.Word.PlainTextContentControl textControl2;

private void AddTextControlAtRange()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();

    textControl2 = this.Controls.AddPlainTextContentControl(this.Paragraphs[1].Range,
        "textControl2");
    textControl2.PlaceholderText = "Enter your first name";
}

Tato verze je aplikace-úroveň doplněk , který zaměřuje .NET Framework 4. Tento kód použít, vložte ji do ThisAddIn třídy v projektu a volání AddTextControlAtRange Metoda z ThisAddIn_Startup metody.

Dim plainTextControl2 As Microsoft.Office.Tools.Word.PlainTextContentControl

Private Sub AddPlainTextControlAtRange()
    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()
    plainTextControl2 = vstoDoc.Controls.AddPlainTextContentControl( _
        vstoDoc.Paragraphs(1).Range, "plainTextControl2")
    plainTextControl2.PlaceholderText = "Enter your first name"
End Sub

private Microsoft.Office.Tools.Word.PlainTextContentControl textControl2;

private void AddTextControlAtRange()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();

    textControl2 = vstoDoc.Controls.AddPlainTextContentControl(
        vstoDoc.Paragraphs[1].Range,
        "textControl2");
    textControl2.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.