Proprietà PlainTextContentControl.PlaceholderText
Ottiene o imposta il testo visualizzato in PlainTextContentControl 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 BuildingBlock o Range, utilizzare il metodo SetPlaceholderText.
Esempi
Nell'esempio di codice seguente viene aggiunto un nuovo oggetto PlainTextContentControl 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 AddTextControlAtSelection dal metodo ThisDocument_Startup.
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";
}
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 AddTextControlAtSelection dal metodo ThisAddIn_Startup.
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";
}
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.