GroupContentControl – rozhraní

Článek
05/14/2013

Představuje chráněné oblasti dokumentu, který uživatelé nelze upravit ani odstranit.

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

Syntaxe

'Deklarace
<GuidAttribute("1fc77d35-6978-4dbc-a615-9ed8a8f728f5")> _
Public Interface GroupContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("1fc77d35-6978-4dbc-a615-9ed8a8f728f5")]
public interface GroupContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

Typ GroupContentControl zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	Application	Získá Microsoft.Office.Interop.Word.Application , která představuje aktuální instance aplikace Microsoft Office Word.
	BindingContext	Získá nebo nastaví kolekce vedoucích měny IBindableComponent. (Zděděno z IBindableComponent.)
	Container	Infrastruktura. (Zděděno z ContentControlBase.)
	ContainerComponent	Infrastruktura. (Zděděno z ContentControlBase.)
	Creator	Získá 32bitové celé číslo, které označuje aplikace, ve kterém GroupContentControl byla vytvořena.
	DataBindings	Získá kolekci objektů vázání dat pro tento IBindableComponent. (Zděděno z IBindableComponent.)
	DefaultDataSourceUpdateMode	Získá nebo nastaví výchozí DataSourceUpdateMode u ContentControlBase. (Zděděno z ContentControlBase.)
	ID	Získá jedinečné číslo identifikující obsah ovládacího prvku. (Zděděno z ContentControlBase.)
	InnerObject	Získá základní Microsoft.Office.Interop.Word.ContentControl pro objekt Microsoft.Office.Tools.Word.ContentControlBase. (Zděděno z ContentControlBase.)
	LockContentControl	Získá nebo nastaví hodnotu, která určuje, zda GroupContentControl lze odstranit z dokumentu.
	Parent	Získá rodiče GroupContentControl.
	ParentContentControl	Získá nadřazený ovládací prvek z obsahu GroupContentControl který je vnořen do jiného ovládacího prvku obsahu.
	Range	Získá Range , která představuje obsah GroupContentControl.
	Site	Získá nebo nastaví ISite přidružené IComponent. (Zděděno z IComponent.)
	Tag	Získá nebo nastaví řetězec, který chcete přidružit k GroupContentControl.
	Text	Získá text GroupContentControl.
	Title	Získá nebo nastaví název GroupContentControl.

Nahoru

Metody

	Název	Popis
	BeginInit	Signály objekt spouštění dané inicializace. (Zděděno z ISupportInitialize.)
	Copy	Kopie GroupContentControl z dokumentu do schránky.
	Cut	Odebere GroupContentControl z dokumentu a přidá jej do schránky.
	Delete	Odstraní dynamicky vytvořených ovládacích obsahu z dokumentu a odebere ji z ControlCollection v dokumentu. (Zděděno z ContentControlBase.)
	Dispose	Provádí úkoly definované aplikací spojených s uvolněním, uvolnění nebo obnovení nespravované prostředky. (Zděděno z IDisposable.)
	EndInit	Signály objekt inicializace, že je dokončena. (Zděděno z ISupportInitialize.)

Nahoru

Události

	Název	Popis
	Added	Nastane poté, co je ovládací prvek obsahu do dokumentu. (Zděděno z ContentControlBase.)
	BindingContextChanged	Dochází při hodnotu BindingContext vlastnost ContentControlBase změny. (Zděděno z ContentControlBase.)
	ContentUpdating	Pokud ovládací prvek obsahu je vázán k vlastní části XML dochází těsně před aktualizací Microsoft Office Word text v ovládacím prvku obsahu. (Zděděno z ContentControlBase.)
	Deleting	Vyvolá se těsně před ovládací prvek obsahu je odstranit z dokumentu. (Zděděno z ContentControlBase.)
	Disposed	Představuje metodu, která zpracovává Disposed události komponenty. (Zděděno z IComponent.)
	Entering	Dojde, když uživatel klikne na ovládací prvek obsahu, nebo pokud kurzor je přesunut do obsahu ovládacího prvku programově. (Zděděno z ContentControlBase.)
	Exiting	Dochází při kliknutí na tlačítko mimo ovládací prvek obsahu, nebo když kurzor se přesune mimo ovládací prvek obsahu programově. (Zděděno z ContentControlBase.)
	StoreUpdating	Právě dříve, než aplikace Microsoft Office Word aktualizuje data ve vlastní části XML, který je vázán na obsah ovládacího prvku (po textu v obsahu řízení změn). (Zděděno z ContentControlBase.)
	Validated	Vyvolá se v případě, že ovládací prvek obsahu byla úspěšně ověřen. (Zděděno z ContentControlBase.)
	Validating	Vyvolá se v případě ověřuje obsah ovládacího prvku obsahu. (Zděděno z ContentControlBase.)

Nahoru

Poznámky

Použití GroupContentControl k definování chráněné oblasti dokumentu, který uživatelé nemohou upravit nebo odstranit.A GroupContentControl může obsahovat všechny položky, dokumentu, například textu, tabulek, grafiky a i ostatní obsah ovládacích prvků.A GroupContentControl poskytuje žádné uživatelské rozhraní, která je pro uživatele viditelné.Další informace o použití GroupContentControl k ochraně část dokumentu, viz Ovládací prvky obsahu a Jak: chránit části 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 naleznete v tématu Visual Studio Tools pro přehled Runtime sady Office.

Ovládací prvky obsahu

GroupContentControl Je jedním z osmi typů ovládacích prvků obsahu, které můžete použít k návrhu dokumenty a šablony aplikace Microsoft Office Word.Obsahu, že ovládací prvky uživatelského rozhraní (UI), je řízen vstupní formulář, atd.Chcete-li zabránit uživatelům v úpravách chráněné oddíly dokumentu nebo šablony, můžete použít ovládací prvky obsahu a ke zdroji dat můžete také navázat ovládací prvky obsahu.Další informace naleznete v tématu Ovládací prvky obsahu.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených pro rozhraní .NET Framework 4 a .NET Framework 4.5. 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 v projektech cílených na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k aplikaci Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Příklady

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

Tato verze je pro přizpůsobení úroveň dokument.Chcete-li použít tento kód, vložte jej do ThisDocument třídy v projektu a volání AddGroupControlAtSelection metoda z ThisDocument_Startup metoda.

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 pro doplněk aplikační úrovni.Chcete-li použít tento kód, vložte jej do ThisAddIn třídy v projektu a volání AddGroupControlAtSelection metoda z ThisAddIn_Startup metoda.

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