Właściwość RichTextContentControl.PlaceholderText —

Pobiera lub ustawia tekst, który jest wyświetlany w RichTextContentControl aż tekst zostanie zmieniony przez akcję użytkownika lub innej operacji.

Przestrzeń nazw:  Microsoft.Office.Tools.Word
Zestaw:  Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)

Składnia

'Deklaracja
Property PlaceholderText As String
string PlaceholderText { get; set; }

Wartość właściwości

Typ: System.String
Tekst jest wyświetlany w formancie, aż tekst zostanie zmieniony przez akcję użytkownika lub innej operacji.

Uwagi

Tekst zastępczy jest wyświetlany aż użytkownik dokona edycji formantu, formant jest wypełniana danymi ze źródła danych lub zawartość formantu zostanie usunięta.

Aby ustawić symbol zastępczy tekstu do symbolu, który znajduje się w Microsoft.Office.Interop.Word.BuildingBlock lub Range, użyj SetPlaceholderText metody.

Przykłady

Poniższy kod dodaje nowy RichTextContentControl do początku dokumentu.W przykładzie ustawiana PlaceholderText właściwość ciąg prosi użytkownika o wpisanie imienia jego lub jej.

Ta wersja jest dla dostosowania poziomu dokumentu.Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie i wywołanie AddRichTextControlAtSelection metodę z ThisDocument_Startup metody.

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";
}

Ta wersja jest na poziomie aplikacji dodatek.Aby użyć tego kodu, wklej go do ThisAddIn klasy w projekcie i wywołanie AddRichTextControlAtSelection metodę z ThisAddIn_Startup metody.

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";
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

RichTextContentControl Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Word