Condividi tramite


Metodo ControlCollection.AddGroupContentControl (Range, String)

Aggiunge un nuovo oggetto GroupContentControl in corrispondenza dell'intervallo specificato nel documento.

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

Sintassi

'Dichiarazione
Function AddGroupContentControl ( _
    range As Range, _
    name As String _
) As GroupContentControl
GroupContentControl AddGroupContentControl(
    Range range,
    string name
)

Parametri

Valore restituito

Tipo: Microsoft.Office.Tools.Word.GroupContentControl
Oggetto GroupContentControl 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 GroupContentControl in corrispondenza dell'intervallo specificato 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 paragrafo all'inizio del documento e viene creato un oggetto GroupContentControl contenente tale paragrafo. L'oggetto GroupContentControl impedisce la modifica del testo contenuto nel paragrafo da parte dell'utente. Per ulteriori informazioni sull'utilizzo di GroupContentControl per la protezione di parti di un documento, vedere Controlli del contenuto.

Questa versione è valida per una personalizzazione a livello di documento. Per utilizzare questo codice, incollarlo nella classe ThisDocument del progetto e quindi chiamare il metodo AddGroupControlAtRange dal metodo ThisDocument_Startup.

Dim groupControl2 As Microsoft.Office.Tools.Word.GroupContentControl

Private Sub AddGroupControlAtRange()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim range1 As Word.Range = Me.Paragraphs(1).Range
    range1.Text = "You cannot edit or change the formatting of text " & _
            "in this paragraph, because this paragraph is in a GroupContentControl."
    range1.Select()
    groupControl2 = Me.Controls.AddGroupContentControl(range1, "groupControl2")
End Sub
private Microsoft.Office.Tools.Word.GroupContentControl groupControl2;

private void AddGroupControlAtRange()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Word.Range range1 = this.Paragraphs[1].Range;
    range1.Text = "You cannot edit or change the formatting of text " +
        "in this paragraph, because this paragraph is in a GroupContentControl.";
    range1.Select();

    groupControl2 = this.Controls.AddGroupContentControl(range1, "groupControl2");
}

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 e quindi chiamare il metodo AddGroupControlAtRange dal metodo ThisAddIn_Startup.

Dim groupControl2 As Microsoft.Office.Tools.Word.GroupContentControl

Private Sub AddGroupControlAtRange()
    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()
    Dim range1 As Word.Range = vstoDoc.Paragraphs(1).Range
    range1.Text = "You cannot edit or change the formatting of text " & _
            "in this paragraph, because this paragraph is in a GroupContentControl."
    range1.Select()
    groupControl2 = vstoDoc.Controls.AddGroupContentControl(range1, "groupControl2")
End Sub
private Microsoft.Office.Tools.Word.GroupContentControl groupControl2;

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

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    Word.Range range1 = vstoDoc.Paragraphs[1].Range;
    range1.Text = "You cannot edit or change the formatting of text " +
        "in this paragraph, because this paragraph is in a GroupContentControl.";
    range1.Select();

    groupControl2 = vstoDoc.Controls.AddGroupContentControl(range1, "groupControl2");
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

ControlCollection Interfaccia

Overload AddGroupContentControl

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