Condividi tramite


Metodo ControlCollection.AddPlainTextContentControl (String)

Aggiunge un nuovo oggetto PlainTextContentControl in corrispondenza della selezione corrente nel documento.

Spazio dei nomi:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

'Dichiarazione
Function AddPlainTextContentControl ( _
    name As String _
) As PlainTextContentControl
PlainTextContentControl AddPlainTextContentControl(
    string name
)

Parametri

Valore restituito

Tipo: Microsoft.Office.Tools.Word.PlainTextContentControl
Oggetto PlainTextContentControl aggiunto al documento.

Eccezioni

Eccezione Condizione
ArgumentNullException

name è nullriferimento null (Nothing in Visual Basic) oppure ha lunghezza zero.

ControlNameAlreadyExistsException

In ControlCollection è già presente un controllo con lo stesso nome.

Note

Utilizzare questo metodo per aggiungere un nuovo oggetto PlainTextContentControl in corrispondenza della selezione corrente nel documento in fase di esecuzione. Per ulteriori informazioni, vedere Aggiunta di controlli ai documenti di Office in fase di esecuzione.

Esempi

Nell'esempio di codice seguente viene aggiunto un nuovo oggetto PlainTextContentControl all'inizio del documento.

Questa versione è valida per una personalizzazione a livello di documento. Per utilizzare questo codice, incollarlo nella classe ThisDocument del progetto, quindi chiamare il metodo AddTextControlAtSelection dal metodo 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";
}

Questa versione è valida per un componente aggiuntivo a livello di applicazione destinato a .NET Framework 4. Per utilizzare questo codice, incollarlo nella classe ThisAddIn del progetto, quindi chiamare il metodo AddTextControlAtSelection dal metodo 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";
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

ControlCollection Interfaccia

Overload AddPlainTextContentControl

Spazio dei nomi Microsoft.Office.Tools.Word

Altre risorse

Aggiunta di controlli ai documenti di Office in fase di esecuzione

Metodi di supporto per i controlli host

Procedura: aggiungere controlli del contenuto ai documenti di Word