PlainTextContentControl.PlaceholderText (Propiedad)

Obtiene o establece el texto que se muestra en PlainTextContentControl hasta que este texto se modifica mediante una acción del usuario o alguna otra operación.

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

Sintaxis

'Declaración
Property PlaceholderText As String

string PlaceholderText { get; set; }

Valor de propiedad

Tipo: System.String
El texto que se muestra en el control hasta que se modifica por una acción del usuario o cualquier otra operación.

Comentarios

El texto del marcador de posición se muestra hasta que un usuario modifica el control, éste se llena con los datos de un origen de datos o se elimina el contenido del control.

Para establecer el texto del marcador de posición en el texto que está en BuildingBlock o Range, utilice el método SetPlaceholderText.

Ejemplos

En el ejemplo de código siguiente se agrega un nuevo PlainTextContentControl al principio del documento.En el ejemplo se establece la propiedad PlaceholderText en una cadena que pide al usuario que escriba su nombre.

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

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

PlainTextContentControl Interfaz

Microsoft.Office.Tools.Word (Espacio de nombres)