Proprietà RichTextContentControl.PlaceholderText

Articolo
05/17/2013

Ottiene o imposta il testo visualizzato in RichTextContentControl fino a quando il testo non viene modificato mediante un'azione dell'utente o altre operazioni.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

'Dichiarazione
Property PlaceholderText As String

string PlaceholderText { get; set; }

Valore proprietà

Tipo: System.String
Testo visualizzato nel controllo fino a quando il testo non viene modificato mediante un'azione dell'utente o altre operazioni.

Note

Il testo segnaposto viene visualizzato fino a quando il controllo non viene modificato da un utente, popolato con i dati ottenuti da un'origine dati oppure il suo contenuto non viene eliminato.

Per impostare il testo segnaposto sul testo contenuto in Microsoft.Office.Interop.Word.BuildingBlock o Range, utilizzare il metodo SetPlaceholderText.

Esempi

Nell'esempio di codice seguente viene aggiunto un nuovo oggetto RichTextContentControl all'inizio del documento.Nell'esempio la proprietà PlaceholderText viene impostata su una stringa che richiede all'utente di digitare il proprio nome.

Questa versione è valida per una personalizzazione a livello di documento.Per utilizzare questo codice, incollarlo nella classe ThisDocument del progetto, quindi chiamare il metodo AddRichTextControlAtSelection dal metodo ThisDocument_Startup.

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

Questa versione è valida per un componente aggiuntivo a livello di applicazione.Per utilizzare questo codice, incollarlo nella classe ThisAddIn del progetto, quindi chiamare il metodo AddRichTextControlAtSelection dal metodo ThisAddIn_Startup.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

RichTextContentControl Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Condividi tramite