PlainTextContentControl.PlaceholderText – vlastnost

Článek
01/03/2014

Získá nebo nastaví text zobrazený v PlainTextContentControl dokud text se změní akce uživatele nebo jinou operaci.

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

Syntaxe

'Deklarace
Property PlaceholderText As String

string PlaceholderText { get; set; }

Hodnota vlastnosti

Typ: System.String
Text zobrazený v ovládacím prvku, dokud text se změní akce uživatele nebo jinou operaci.

Poznámky

Dokud uživatel upravit ovládací prvek, ovládací prvek bude naplněn daty ze zdroje dat nebo odstraněn obsah ovládacího prvku, zobrazí se zástupný text.

Zástupný symbol textu s textem, který je v nastavení BuildingBlock nebo Range, použít SetPlaceholderText metody.

Příklady

Následující příklad kódu přidá nový PlainTextContentControl na začátku dokumentu.V příkladu je nastavena PlaceholderText vlastnost na řetězec, který vyzve uživatele k zadání své křestní jméno.

Tato verze je pro vlastní úpravy úrovni dokumentu.Tento kód použít, vložte jej do ThisDocument třídy v projektu a volání AddTextControlAtSelection metoda z ThisDocument_Startup metody.

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

Private Sub AddPlainTextControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    plainTextControl1 = Me.Controls.AddPlainTextContentControl("plainTextControl1")
    plainTextControl1.PlaceholderText = "Enter your first name"
End Sub

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

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

    textControl1 = this.Controls.AddPlainTextContentControl("textControl1");
    textControl1.PlaceholderText = "Enter your first name";
}

Tato verze je aplikace úroveň doplněk.Tento kód použít, vložte jej do ThisAddIn třídy v projektu a volání AddTextControlAtSelection metoda z ThisAddIn_Startup metody.

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

Private Sub AddPlainTextControlAtSelection()
    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()
    plainTextControl1 = vstoDoc.Controls.AddPlainTextContentControl("plainTextControl1")
    plainTextControl1.PlaceholderText = "Enter your first name"
End Sub

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

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

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

    textControl1 = vstoDoc.Controls.AddPlainTextContentControl("textControl1");
    textControl1.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

PlainTextContentControl Rozhraní

Microsoft.Office.Tools.Word – obor názvů

Sdílet prostřednictvím