Metodo ControlCollection.AddRichTextContentControl (String)

Articolo
05/17/2013

Aggiunge un nuovo oggetto RichTextContentControl 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 AddRichTextContentControl ( _
    name As String _
) As RichTextContentControl

RichTextContentControl AddRichTextContentControl(
    string name
)

Parametri

name
Tipo: System.String
Nome del nuovo controllo.

Valore restituito

Tipo: Microsoft.Office.Tools.Word.RichTextContentControl
Oggetto RichTextContentControl 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 RichTextContentControl 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 RichTextContentControl 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 AddRichTextControlAtSelection dal metodo ThisDocument_Startup.

Dim richTextControl1 As Microsoft.Office.Tools.Word.RichTextContentControl

Private Sub AddRichTextControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    richTextControl1 = Me.Controls.AddRichTextContentControl("richTextControl1")
    richTextControl1.PlaceholderText = "Enter your first name"
End Sub

private Microsoft.Office.Tools.Word.RichTextContentControl richTextControl1;

private void AddRichTextControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    richTextControl1 = this.Controls.AddRichTextContentControl("richTextControl1");
    richTextControl1.PlaceholderText = "Enter your first name";
}

Questa versione è per un componente aggiuntivo a livello di applicazione destinati .NET Framework 4 o .NET Framework 4.5.Per utilizzare questo codice, incollarlo nella classe ThisAddIn del progetto, quindi chiamare il metodo AddRichTextControlAtSelection dal metodo ThisAddIn_Startup.

Dim richTextControl1 As Microsoft.Office.Tools.Word.RichTextContentControl

Private Sub AddRichTextControlAtSelection()
    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()
    richTextControl1 = vstoDoc.Controls.AddRichTextContentControl("richTextControl1")
    richTextControl1.PlaceholderText = "Enter your first name"
End Sub

private Microsoft.Office.Tools.Word.RichTextContentControl richTextControl1;

private void AddRichTextControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    richTextControl1 = vstoDoc.Controls.AddRichTextContentControl("richTextControl1");
    richTextControl1.PlaceholderText = "Enter your first name";
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.