Partager via


PlainTextContentControl, classe (System 2007)

Mise à jour : Juillet 2008

Représente un bloc de texte dans un document.

Espace de noms :  Microsoft.Office.Tools.Word
Assembly :  Microsoft.Office.Tools.Word.v9.0 (dans Microsoft.Office.Tools.Word.v9.0.dll)

Syntaxe

<DefaultBindingPropertyAttribute("Text")> _
<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class PlainTextContentControl _
    Inherits ContentControlBase _
    Implements ISupportInitializeControl, ISupportInitialize

Dim instance As PlainTextContentControl
[DefaultBindingPropertyAttribute("Text")]
[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class PlainTextContentControl : ContentControlBase, 
    ISupportInitializeControl, ISupportInitialize

Notes

Un PlainTextContentControl peut contenir du texte uniquement. Vous pouvez mettre en forme le texte dans un PlainTextContentControl, mais tout le texte dans le contrôle a automatiquement la même mise en forme. Par exemple, si vous mettez en italique un mot d'une phrase dans un PlainTextContentControl, tout le texte à l'intérieur du contrôle est mis en italique.

Pour accéder au texte dans un PlainTextContentControl, utilisez la propriété Text. Par défaut, un PlainTextContentControl ne peut pas contenir des sauts de ligne. Pour changer ce comportement, utilisez la propriété MultiLine.

Pour créer une région de document qui peut contenir du texte et de nombreux autres types de contenus, tels que des tableaux, des images ou d'autres contrôles de contenu, utilisez un RichTextContentControl.

Contrôles de contenu

Le PlainTextContentControl est l'un des huit types de contrôles de contenu que vous pouvez utiliser pour créer des documents et des modèles dans Microsoft Office Word. Les contrôles de contenu ont une interface utilisateur (IU) dont les entrées sont contrôlées comme dans le cas d'un formulaire. Vous pouvez utiliser des contrôles de contenu pour empêcher les utilisateurs de modifier des sections protégées du document ou du modèle et vous pouvez également lier des contrôles de contenu à une source de données. Pour plus d'informations, consultez Contrôles de contenu.

Exemples

L'exemple de code suivant ajoute un nouveau PlainTextContentControl au début du document.

Cette version est destinée à une personnalisation au niveau du document. Pour utiliser ce code, collez-le dans la classe ThisDocument de votre projet, puis appelez la méthode AddTextControlAtSelection à partir de la méthode 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";
}

Cette version est destinée à un complément d'application. Pour utiliser ce code, collez-le dans la classe ThisAddIn de votre projet, puis appelez la méthode AddTextControlAtSelection à partir de la méthode 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 = Me.Application.ActiveDocument.GetVstoObject()
    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 = this.Application.ActiveDocument.GetVstoObject();
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    textControl1 = vstoDoc.Controls.AddPlainTextContentControl("textControl1");
    textControl1.PlaceholderText = "Enter your first name";
}

Hiérarchie d'héritage

System.Object
  Microsoft.VisualStudio.Tools.Office.RemoteComponent
    Microsoft.VisualStudio.Tools.Office.RemoteBindableComponent
      Microsoft.Office.Tools.Word.ContentControlBase
        Microsoft.Office.Tools.Word.PlainTextContentControl

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Membres PlainTextContentControl

Microsoft.Office.Tools.Word, espace de noms

Autres ressources

Contrôles de contenu

Comment : ajouter des contrôles de contenu à des documents Word

Comment : protéger des parties de documents à l'aide de contrôles de contenu

Procédure pas à pas : création d'un modèle à l'aide de contrôles de contenu

Procédure pas à pas : liaison de contrôles de contenu à des parties XML personnalisées

Historique des modifications

Date

Historique

Raison

Juillet 2008

Ajout d'une version de l'exemple de code pour un complément d'application.

Modifications de fonctionnalités dans le SP1.