ControlCollection.AddGroupContentControl – metoda (String)

Článek
08/11/2011

Přidá nový GroupContentControl na aktuální výběr v dokumentu.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
Function AddGroupContentControl ( _
    name As String _
) As GroupContentControl

GroupContentControl AddGroupContentControl(
    string name
)

Parametry

name
Typ: System.String
Název nového ovládacího prvku.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Word.GroupContentControl
GroupContentControl , Byl přidán do dokumentu.

Výjimky

Výjimka	Podmínka
ArgumentNullException	nameje nullodkaz Null (Nothing v jazyce Visual Basic) nebo má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již v ControlCollection.

Poznámky

Tuto metodu lze použít k přidání nového GroupContentControl na aktuální výběr v dokumentu v čase zpracování. Další informace naleznete v tématu Adding Controls to Office Documents at Run Time.

Příklady

Následující příklad kódu přidá nový odstavec do začátku dokumentu a vytvoří nový GroupContentControl obsahující odstavce. GroupContentControl Zabrání uživatelům úpravy textu v odstavci. Další informace o použití GroupContentControl pro ochranu části dokumentu, viz Content Controls.

Tato verze je přizpůsobení úrovni dokumentu. Tento kód použít, vložte ji do ThisDocument třídy v projektu a volání AddGroupControlAtSelection Metoda z ThisDocument_Startup metody.

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

Private Sub AddGroupControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Text = "You cannot edit or change the formatting of text " & _
            "in this paragraph, because this paragraph is in a GroupContentControl."
    Me.Paragraphs(1).Range.Select()
    groupControl1 = Me.Controls.AddGroupContentControl("groupControl1")
End Sub

private Microsoft.Office.Tools.Word.GroupContentControl groupControl1;

private void AddGroupControlAtSelection()
{
    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();

    groupControl1 = this.Controls.AddGroupContentControl("groupControl1");
}

Tato verze je aplikace-úroveň doplněk , který zaměřuje .NET Framework 4. Tento kód použít, vložte ji do ThisAddIn třídy v projektu a volání AddGroupControlAtSelection Metoda z ThisAddIn_Startup metody.

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

Private Sub AddGroupControlAtSelection()
    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.Text = "You cannot edit or change the formatting of text " & _
            "in this paragraph, because this paragraph is in a GroupContentControl."
    vstoDoc.Paragraphs(1).Range.Select()
    groupControl1 = vstoDoc.Controls.AddGroupContentControl("groupControl1")
End Sub

private Microsoft.Office.Tools.Word.GroupContentControl groupControl1;

private void AddGroupControlAtSelection()
{
    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();

    groupControl1 = vstoDoc.Controls.AddGroupContentControl("groupControl1");
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.