GroupContentControl Rozhraní

Definice

Představuje chráněnou oblast dokumentu, kterou uživatelé nemohou upravovat ani odstraňovat.

[System.Runtime.InteropServices.Guid("1fc77d35-6978-4dbc-a615-9ed8a8f728f5")]
public interface GroupContentControl : IDisposable, Microsoft.Office.Tools.Word.ContentControlBase, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent
Atributy
Implementuje

Příklady

Následující příklad kódu přidá nový odstavec na začátek dokumentu a vytvoří nový GroupContentControl , který obsahuje tento odstavec. GroupContentControlZabrání uživatelům v úpravách textu v odstavci.

Tato verze je pro přizpůsobení na úrovni dokumentu. Chcete-li použít tento kód, vložte jej do ThisDocument třídy v projektu a zavolejte AddGroupControlAtSelection metodu z ThisDocument_Startup metody.

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

Tato verze je pro doplněk na úrovni aplikace. Chcete-li použít tento kód, vložte jej do ThisAddIn třídy v projektu a zavolejte AddGroupControlAtSelection metodu z ThisAddIn_Startup metody.

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

Poznámky

Pomocí GroupContentControl můžete definovat chráněnou oblast dokumentu, kterou uživatelé nemůžou upravovat ani odstraňovat. GroupContentControlMůže obsahovat libovolné položky dokumentu, například text, tabulky, grafiku a dokonce i další ovládací prvky obsahu. GroupContentControlNeposkytuje žádné uživatelské rozhraní, které je viditelné pro uživatele. Další informace o použití nástroje GroupContentControl k ochraně části dokumentu naleznete v tématu ovládací prvky obsahu a Postupy: Ochrana částí dokumentů pomocí ovládacích prvků obsahu.

Poznámka

Toto rozhraní je implementováno modulem Visual Studio Tools for Office Runtime. Rozhraní není určeno k implementaci do vašeho kódu. Další informace najdete v tématu Visual Studio Tools for Office Runtime přehled.

Ovládací prvky obsahu

GroupContentControlJe jedním z osmi typů ovládacích prvků obsahu, které lze použít k návrhu dokumentů a šablon v aplikaci systém Microsoft Office Word. Ovládací prvky obsahu mají uživatelské rozhraní, které má řízený vstup v podobě formuláře. Pomocí ovládacích prvků obsahu můžete uživatelům zabránit v provádění úprav chráněných oddílů dokumentu nebo šablony a ovládací prvky obsahu pak můžete navázat na zdroj dat. Další informace najdete v tématu ovládací prvky obsahu.

Využití

Tato dokumentace popisuje verzi tohoto typu, který se používá v projektech Office cílených na rozhraní .NET Framework 4 nebo novější. V projektech cílených pro rozhraní .NET Framework 3.5 může mít tento typ jiné členy a ukázky kódu, poskytnuté pro tento typ, nemusejí fungovat. Dokumentaci k tomuto typu projektů cílených rozhraní .NET Framework 3.5 najdete v následující informační části dokumentace k Visual Studiu 2008: http://go.microsoft.com/fwlink/?LinkId=160658 .

Vlastnosti

Application

Získá Application , který představuje aktuální instanci systém Microsoft Office Wordu.

Container (Zděděno od ContentControlBase)
ContainerComponent (Zděděno od ContentControlBase)
Creator

Získá 32 celé číslo, které označuje aplikaci, ve které GroupContentControl byl vytvořen.

DefaultDataSourceUpdateMode

Získá nebo nastaví výchozí hodnotu DataSourceUpdateMode pro ContentControlBase .

(Zděděno od ContentControlBase)
ID

Získá jedinečné číslo identifikující ovládací prvek obsahu.

(Zděděno od ContentControlBase)
InnerObject

Získá základní ContentControl objekt pro ContentControlBase .

(Zděděno od ContentControlBase)
LockContentControl

Získává nebo nastavuje hodnotu, která určuje, jestli se GroupContentControl dá odstranit z dokumentu.

Parent

Získá nadřazenou položku GroupContentControl .

ParentContentControl

Získá nadřazený ovládací prvek obsahu GroupContentControl , který je vnořen v jiném ovládacím prvku obsahu.

Range

Získá Range , který představuje obsah GroupContentControl .

Tag

Získá nebo nastaví řetězec, který chcete přidružit k GroupContentControl .

Text

Získá text v GroupContentControl .

Title

Získá nebo nastaví název GroupContentControl .

Metody

Copy()

Zkopíruje GroupContentControl z dokumentu do schránky.

Cut()

Odebere GroupContentControl z dokumentu a přidá ho do schránky.

Delete(Boolean)

Odstraní dynamicky vytvořený ovládací prvek obsahu z dokumentu a odebere ho z v ControlCollection dokumentu.

(Zděděno od ContentControlBase)

Události

Added

Vyvolá se po přidání ovládacího prvku Content do dokumentu.

(Zděděno od ContentControlBase)
BindingContextChanged

Vyvolá se při BindingContext změně hodnoty vlastnosti ContentControlBase .

(Zděděno od ContentControlBase)
ContentUpdating

Nastane těsně před tím, než systém Microsoft Office Word aktualizuje text v ovládacím prvku obsahu, pokud je ovládací prvek obsahu vázaný na vlastní část XML.

(Zděděno od ContentControlBase)
Deleting

Nastane bezprostředně před odstraněním ovládacího prvku obsahu z dokumentu.

(Zděděno od ContentControlBase)
Entering

Vyvolá se v případě, že uživatel klikne v ovládacím prvku obsahu nebo když je kurzor přesunut do ovládacího prvku obsahu programově.

(Zděděno od ContentControlBase)
Exiting

Vyvolá se v případě, že uživatel klikne mimo ovládací prvek obsahu nebo když se kurzor přesune mimo ovládací prvek obsahu programově.

(Zděděno od ContentControlBase)
StoreUpdating

Nastane těsně před tím, než systém Microsoft Office Word aktualizuje data ve vlastní části XML, která je svázána s ovládacím prvkem obsahu (to znamená po změně textu v ovládacím prvku Content Control).

(Zděděno od ContentControlBase)
Validated

Vyvolá se v případě, že byl ovládací prvek obsahu úspěšně ověřen.

(Zděděno od ContentControlBase)
Validating

Vyvolá se při ověřování obsahu ovládacího prvku obsahu.

(Zděděno od ContentControlBase)

Platí pro