PlainTextContentControl (Clase) (2007 System)

Artículo
09/04/2008

Actualización: Julio de 2008

Representa un bloque de texto de un documento.

Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word.v9.0 (en Microsoft.Office.Tools.Word.v9.0.dll)

Sintaxis

<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

Comentarios

Un control PlainTextContentControl sólo puede contener texto. Puede dar formato al texto de un control PlainTextContentControl, pero automáticamente se aplicará el mismo formato a todo el texto del control. Por ejemplo, si pone en cursiva una palabra de una frase que se encuentra en un control PlainTextContentControl, todo el texto incluido en el control se pone en cursiva.

Para obtener acceso al texto de un control PlainTextContentControl, utilice la propiedad Text. De forma predeterminada, los controles PlainTextContentControl no pueden contener saltos de línea. Para cambiar este comportamiento, utilice la propiedad MultiLine.

Para crear una región de documento que pueda contener texto y muchos otros tipos de contenido, como tablas, imágenes o controles de contenido de otro tipo, utilice un control RichTextContentControl.

Controles de contenido

El control PlainTextContentControl es uno de los ocho tipos de controles de contenido que se pueden utilizar para diseñar documentos y plantillas en Microsoft Office Word. Los controles de contenido tienen una interfaz de usuario con entrada controlada, como un formulario. Puede usar los controles de contenido para evitar que los usuarios modifiquen las secciones protegidas del documento o plantilla y también puede enlazar los controles de contenido a un origen de datos. Para obtener más información, consulte Controles de contenido.

Ejemplos

En el ejemplo de código siguiente se agrega un nuevo PlainTextContentControl al principio del documento.

Se trata de una versión para una personalización en el nivel del documento. Para usar este código, péguelo en la clase ThisDocument del proyecto y llame al método AddTextControlAtSelection desde el método 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";
}

Se trata de una versión para un complemento en el nivel de la aplicación. Para usar este código, péguelo en la clase ThisAddIn del proyecto y llame al método AddTextControlAtSelection desde el método 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";
}

Jerarquía de herencia

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

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.