RichTextContentControl.PlaceholderText – vlastnost

Článek
05/14/2013

Získá nebo nastaví text, který je zobrazen v RichTextContentControl dokud text se změní akce uživatele nebo některé operace.

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, který je zobrazen v ovládacím prvku, dokud nebude změněn akce uživatele nebo některé operace.

Poznámky

Dokud uživatel upravuje ovládací prvek, ovládací prvek je 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í Microsoft.Office.Interop.Word.BuildingBlock nebo Range, použít SetPlaceholderText metoda.

Příklady

Následující příklad kódu přidá novou RichTextContentControl na začátek 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 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 doplněk aplikační úrovni.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

RichTextContentControl Rozhraní

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

Sdílet prostřednictvím