ControlCollection.AddGroupContentControl Metode

Referensi

Definisi

Ruang nama:: Microsoft.Office.Tools.Word

Rakitan:: Microsoft.Office.Tools.Word.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Overload

AddGroupContentControl(String)	Menambahkan yang baru GroupContentControl pada pilihan saat ini dalam dokumen.
AddGroupContentControl(ContentControl, String)	Menambahkan baru GroupContentControl yang didasarkan pada kontrol konten asli dalam dokumen.
AddGroupContentControl(Range, String)	Menambahkan yang baru GroupContentControl pada rentang yang ditentukan dalam dokumen.

AddGroupContentControl(String)

Menambahkan yang baru GroupContentControl pada pilihan saat ini dalam dokumen.

public:
 Microsoft::Office::Tools::Word::GroupContentControl ^ AddGroupContentControl(System::String ^ name);

public Microsoft.Office.Tools.Word.GroupContentControl AddGroupContentControl (string name);

abstract member AddGroupContentControl : string -> Microsoft.Office.Tools.Word.GroupContentControl

Public Function AddGroupContentControl (name As String) As GroupContentControl

Parameter

name: String

Nama kontrol baru.

Mengembalikan

GroupContentControl

GroupContentControl yang ditambahkan ke dokumen.

Pengecualian

ArgumentNullException

name adalah null atau memiliki panjang nol.

ControlNameAlreadyExistsException

Kontrol dengan nama yang sama sudah ada di ControlCollection.

Contoh

Contoh kode berikut menambahkan paragraf baru ke awal dokumen, dan membuat paragraf baru GroupContentControl yang berisi paragraf ini. GroupContentControl mencegah pengguna mengedit teks dalam paragraf. Untuk informasi selengkapnya tentang menggunakan GroupContentControl untuk melindungi bagian dari dokumen, lihat Kontrol Konten.

Versi ini untuk penyesuaian tingkat dokumen. Untuk menggunakan kode ini, tempelkan ke ThisDocument kelas di proyek Anda, dan panggil AddGroupControlAtSelection metode dari ThisDocument_Startup metode .

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

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

Versi ini untuk add-in tingkat aplikasi yang menargetkan .NET Framework 4 atau .NET Framework 4.5. Untuk menggunakan kode ini, tempelkan ke ThisAddIn kelas di proyek Anda, dan panggil AddGroupControlAtSelection metode dari ThisAddIn_Startup metode .

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

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

Keterangan

Gunakan metode ini untuk menambahkan yang baru GroupContentControl pada pilihan saat ini dalam dokumen pada durasi. Untuk informasi selengkapnya, lihat Menambahkan Kontrol ke Dokumen Office pada Durasi.

Berlaku untuk

AddGroupContentControl(ContentControl, String)

Menambahkan baru GroupContentControl yang didasarkan pada kontrol konten asli dalam dokumen.

public:
 Microsoft::Office::Tools::Word::GroupContentControl ^ AddGroupContentControl(Microsoft::Office::Interop::Word::ContentControl ^ contentControl, System::String ^ name);

public Microsoft.Office.Tools.Word.GroupContentControl AddGroupContentControl (Microsoft.Office.Interop.Word.ContentControl contentControl, string name);

abstract member AddGroupContentControl : Microsoft.Office.Interop.Word.ContentControl * string -> Microsoft.Office.Tools.Word.GroupContentControl

Public Function AddGroupContentControl (contentControl As ContentControl, name As String) As GroupContentControl

Parameter

contentControl: ContentControl

Yang ContentControl merupakan dasar untuk kontrol baru.

name: String

Nama kontrol baru.

Mengembalikan

GroupContentControl

GroupContentControl yang ditambahkan ke dokumen.

Pengecualian

ArgumentNullException

contentControl adalah null.-or- name adalah null atau memiliki panjang nol.

ControlNameAlreadyExistsException

Kontrol dengan nama yang sama sudah ada di ControlCollection.

ArgumentException

contentControlbukan galeri blok pembangun (yaitu, Type properti contentControl tidak memiliki nilai Microsoft.Office.Interop.Word. WdContentControlType.wdContentControlGroup).

Contoh

Contoh kode berikut membuat baru GroupContentControl untuk setiap kontrol grup asli yang ada dalam dokumen.

Versi ini untuk penyesuaian tingkat dokumen. Untuk menggunakan kode ini, tempelkan ke ThisDocument kelas di proyek Anda, dan panggil CreateGroupControlsFromNativeControls metode dari ThisDocument_Startup metode .

private System.Collections.Generic.List
    <Microsoft.Office.Tools.Word.GroupContentControl> groupControls;

private void CreateGroupControlsFromNativeControls()
{
    if (this.ContentControls.Count <= 0)
        return;

    groupControls = new System.Collections.Generic.List
        <Microsoft.Office.Tools.Word.GroupContentControl>();
    int count = 0;

    foreach (Word.ContentControl nativeControl in this.ContentControls)
    {
        if (nativeControl.Type == Word.WdContentControlType.wdContentControlGroup)
        {
            count++;
            Microsoft.Office.Tools.Word.GroupContentControl tempControl =
                this.Controls.AddGroupContentControl(nativeControl,
                "VSTOGroupControl" + count.ToString());
            groupControls.Add(tempControl);
        }
    }
}

Private groupControls As New System.Collections.Generic.List _
        (Of Microsoft.Office.Tools.Word.GroupContentControl)

Private Sub CreateGroupControlsFromNativeControls()
    If Me.ContentControls.Count <= 0 Then
        Return
    End If

    Dim count As Integer = 0
    For Each nativeControl As Word.ContentControl In Me.ContentControls
        If nativeControl.Type = Word.WdContentControlType.wdContentControlGroup Then
            count += 1
            Dim tempControl As Microsoft.Office.Tools.Word.GroupContentControl = _
                Me.Controls.AddGroupContentControl(nativeControl, _
                "VSTOGroupContentControl" + count.ToString())
            groupControls.Add(tempControl)
        End If
    Next nativeControl
End Sub

Versi ini untuk add-in tingkat aplikasi yang menargetkan .NET Framework 4 atau .NET Framework 4.5. Untuk menggunakan kode ini, tempelkan ke ThisAddIn kelas di proyek Anda, dan panggil CreateGroupControlsFromNativeControls metode dari ThisAddIn_Startup metode .

private System.Collections.Generic.List
    <Microsoft.Office.Tools.Word.GroupContentControl> groupControls;

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

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    if (vstoDoc.ContentControls.Count <= 0)
        return;

    groupControls = new System.Collections.Generic.List
        <Microsoft.Office.Tools.Word.GroupContentControl>();
    int count = 0;

    foreach (Word.ContentControl nativeControl in vstoDoc.ContentControls)
    {
        if (nativeControl.Type == Word.WdContentControlType.wdContentControlGroup)
        {
            count++;
            Microsoft.Office.Tools.Word.GroupContentControl tempControl =
                vstoDoc.Controls.AddGroupContentControl(nativeControl,
                "VSTOGroupControl" + count.ToString());
            groupControls.Add(tempControl);
        }
    }
}

Private groupControls As New System.Collections.Generic.List _
        (Of Microsoft.Office.Tools.Word.GroupContentControl)

Private Sub CreateGroupControlsFromNativeControls()
    If Me.Application.ActiveDocument Is Nothing Then
        Return
    End If

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    If vstoDoc.ContentControls.Count <= 0 Then
        Return
    End If

    Dim count As Integer = 0
    For Each nativeControl As Word.ContentControl In vstoDoc.ContentControls
        If nativeControl.Type = Word.WdContentControlType.wdContentControlGroup Then
            count += 1
            Dim tempControl As Microsoft.Office.Tools.Word.GroupContentControl = _
                vstoDoc.Controls.AddGroupContentControl(nativeControl, _
                "VSTOGroupContentControl" + count.ToString())
            groupControls.Add(tempControl)
        End If
    Next nativeControl
End Sub

Contoh kode berikut membuat baru GroupContentControl untuk setiap kontrol grup asli yang ditambahkan pengguna ke dokumen.

Versi ini untuk penyesuaian tingkat dokumen. Untuk menggunakan kode ini, tempelkan ke ThisDocument kelas di proyek Anda. Untuk C#, Anda juga harus melampirkan ThisDocument_GroupContentControlAfterAdd penanganan aktivitas ke ContentControlAfterAdd peristiwa ThisDocument kelas.

void ThisDocument_GroupContentControlAfterAdd(Word.ContentControl NewContentControl, bool InUndoRedo)
{
    if (NewContentControl.Type == Word.WdContentControlType.wdContentControlGroup)
    {
        this.Controls.AddGroupContentControl(NewContentControl,
            "GroupControl" + NewContentControl.ID);
    }
}

Private Sub ThisDocument_GroupContentControlAfterAdd(ByVal NewContentControl As Word.ContentControl, _
    ByVal InUndoRedo As Boolean) Handles Me.ContentControlAfterAdd

    If NewContentControl.Type = Word.WdContentControlType.wdContentControlGroup Then
        Me.Controls.AddGroupContentControl(NewContentControl, _
            "GroupControl" + NewContentControl.ID)
    End If
End Sub

Versi ini untuk add-in tingkat aplikasi yang menargetkan .NET Framework 4 atau .NET Framework 4.5. Untuk menggunakan kode ini, tempelkan ke ThisAddIn kelas di proyek Anda. Selain itu, Anda harus melampirkan ActiveDocument_GroupContentControlAfterAdd penanganan aktivitas ke ContentControlAfterAdd peristiwa dokumen aktif.

void ActiveDocument_GroupContentControlAfterAdd(
    Word.ContentControl NewContentControl, bool InUndoRedo)
{
    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    if (NewContentControl.Type == Word.WdContentControlType.wdContentControlGroup)
    {
        vstoDoc.Controls.AddGroupContentControl(NewContentControl,
            "GroupControl" + NewContentControl.ID);
    }
}

Private Sub ActiveDocument_GroupContentControlAfterAdd( _
    ByVal NewContentControl As Word.ContentControl, _
    ByVal InUndoRedo As Boolean)

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    If NewContentControl.Type = Word.WdContentControlType. _
        wdContentControlGroup Then
        vstoDoc.Controls.AddGroupContentControl(NewContentControl, _
            "GroupControl" + NewContentControl.ID)
    End If
End Sub

Keterangan

Gunakan metode ini untuk menambahkan baru GroupContentControl yang didasarkan pada kontrol konten asli dalam dokumen pada durasi. Ini berguna saat Anda membuat GroupContentControl pada durasi, dan Anda ingin membuat ulang kontrol yang sama saat berikutnya dokumen dibuka. Untuk informasi selengkapnya, lihat Menambahkan Kontrol ke Dokumen Office pada Durasi.

Berlaku untuk

AddGroupContentControl(Range, String)

Menambahkan yang baru GroupContentControl pada rentang yang ditentukan dalam dokumen.

public:
 Microsoft::Office::Tools::Word::GroupContentControl ^ AddGroupContentControl(Microsoft::Office::Interop::Word::Range ^ range, System::String ^ name);

public Microsoft.Office.Tools.Word.GroupContentControl AddGroupContentControl (Microsoft.Office.Interop.Word.Range range, string name);

abstract member AddGroupContentControl : Microsoft.Office.Interop.Word.Range * string -> Microsoft.Office.Tools.Word.GroupContentControl

Public Function AddGroupContentControl (range As Range, name As String) As GroupContentControl

Parameter

range: Range

Range yang menyediakan batas untuk kontrol baru.

name: String

Nama kontrol baru.

Mengembalikan

GroupContentControl

GroupContentControl yang ditambahkan ke dokumen.

Pengecualian

ArgumentNullException

name adalah null atau memiliki panjang nol.

ControlNameAlreadyExistsException

Kontrol dengan nama yang sama sudah ada di ControlCollection.

Contoh

Contoh kode berikut menambahkan paragraf baru ke awal dokumen, dan membuat GroupContentControl yang berisi paragraf ini. GroupContentControl mencegah pengguna mengedit teks dalam paragraf. Untuk informasi selengkapnya tentang menggunakan GroupContentControl untuk melindungi bagian dari dokumen, lihat Kontrol Konten.

Versi ini untuk penyesuaian tingkat dokumen. Untuk menggunakan kode ini, tempelkan ke ThisDocument kelas di proyek Anda, dan panggil AddGroupControlAtRange metode dari ThisDocument_Startup metode .

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

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()
{
    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");
}

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

Keterangan

Gunakan metode ini untuk menambahkan yang baru GroupContentControl pada rentang tertentu dalam dokumen pada durasi. Untuk informasi selengkapnya, lihat Menambahkan Kontrol ke Dokumen Office pada Durasi.

Berlaku untuk

Bagikan melalui

ControlCollection.AddGroupContentControl Metode

Definisi

Overload

AddGroupContentControl(String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Berlaku untuk

AddGroupContentControl(ContentControl, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Berlaku untuk

AddGroupContentControl(Range, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Berlaku untuk

Sumber Daya Tambahan: