PlainTextContentControl 类 (2007 system)

更新： 2008 年 7 月

表示文档中的文本块。

命名空间：  Microsoft.Office.Tools.Word
程序集：  Microsoft.Office.Tools.Word.v9.0（在 Microsoft.Office.Tools.Word.v9.0.dll 中）

语法

声明
<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

备注

PlainTextContentControl 只能包含文本。可以设置 PlainTextContentControl 中的文本的格式，但是该控件中的所有文本都自动采用相同的格式设置。例如，如果将 PlainTextContentControl 中某个句子的某个单词设置为斜体，则该控件中的所有文本都为斜体。

若要访问 PlainTextContentControl 中的文本，请使用 Text 属性。默认情况下，PlainTextContentControl 不能包含换行符。若要更改此行为，请使用 MultiLine 属性。

若要创建可包含文本和其他多种类型内容（包括表、图片或其他内容控件）的文档区域，请使用 RichTextContentControl。

内容控件

可用于设计 Microsoft Office Word 中的文档和模板的内容控件类型有八种，PlainTextContentControl 是其中之一。内容控件具有一个用户界面 (UI)，其中包含类似于窗体的受控输入。使用内容控件可以防止用户编辑文档或模板的受保护部分，还可以将内容控件绑定到数据源。有关更多信息，请参见内容控件。

示例

下面的代码示例会在文档开头添加一个新的 PlainTextContentControl。

此版本针对的是文档级自定义项。若要使用此代码，请将其粘贴到项目内的 ThisDocument 类中，然后从 ThisDocument_Startup 方法中调用 AddTextControlAtSelection 方法。

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

此版本针对的是应用程序级外接程序。若要使用此代码，请将其粘贴到项目内的 ThisAddIn 类中，然后从 ThisAddIn_Startup 方法中调用 AddTextControlAtSelection 方法。

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

继承层次结构

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

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

另请参见

参考

PlainTextContentControl 成员

Microsoft.Office.Tools.Word 命名空间

其他资源

内容控件

如何：向 Word 文档添加内容控件

如何：使用内容控件保护文档的某些部分

演练：使用内容控件创建模板

演练：将内容控件绑定到自定义 XML 部件

修订记录