RichTextContentControl.PlaceholderText Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit le texte affiché dans le RichTextContentControl jusqu'à ce que le texte soit modifié par une action utilisateur ou une autre opération.
public string PlaceholderText { get; set; }
Valeur de propriété
Texte affiché dans le contrôle jusqu'à ce qu'il soit modifié par une action utilisateur ou une autre opération.
Exemples
L’exemple de code suivant ajoute un nouveau RichTextContentControl au début du document. L’exemple affecte PlaceholderText à la propriété une chaîne qui invite l’utilisateur à taper son prénom.
Cette version est destinée à une personnalisation au niveau du document. Pour utiliser ce code, collez-le dans la ThisDocument classe de votre projet, puis appelez la AddRichTextControlAtSelection méthode à partir de la ThisDocument_Startup méthode.
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";
}
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
Cette version est destinée à un complément au niveau de l’application. Pour utiliser ce code, collez-le dans la ThisAddIn classe de votre projet, puis appelez la AddRichTextControlAtSelection méthode à partir de la ThisAddIn_Startup méthode.
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";
}
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
Remarques
Le texte de l’espace réservé s’affiche jusqu’à ce qu’un utilisateur modifie le contrôle, que le contrôle soit rempli avec les données d’une source de données ou que le contenu du contrôle soit supprimé.
Pour définir le texte de l’espace réservé en tant que texte dans un Microsoft.Office.Interop.Word.BuildingBlock ou un Range , utilisez la SetPlaceholderText méthode.