GroupContentControl – rozhraní

Článek
08/11/2011

Představuje chráněné oblasti dokumentu, uživatelé nemohou úprava nebo 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ává Microsoft.Office.Interop.Word.Application , představuje aktuální instance aplikace Word systém Microsoft Office .
	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	32Bitové integer označující, ve kterém aplikace získává GroupContentControl byl vytvořen.
	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 pro 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.ContentControlproobjekt 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	Rodiče získává GroupContentControl.
	ParentContentControl	Získá kontrolu obsahu nadřazeného GroupContentControl který je vnořen do jiného obsahu ovládacího prvku.
	Range	Získává Range , 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 GroupContentControl.
	Text	Získá v textu GroupContentControl.
	Title	Získá nebo nastaví název GroupContentControl.

Na začátek

Metody

	Název	Popis
	BeginInit	Objekt signály spuš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í prvek dynamicky vytvořený obsah z dokumentu a odebere ji ze 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	Objekt signály že Inicializace byla dokončena. (Zděděno z ISupportInitialize.)

Na začátek

Události

	Název	Popis
	Added	Vyvolá se po přidání ovládacího prvku obsah do dokumentu. (Zděděno z ContentControlBase.)
	BindingContextChanged	Dochází při hodnotu BindingContext Vlastnost ContentControlBase změny. (Zděděno z ContentControlBase.)
	ContentUpdating	Dojde před aktualizací systém Microsoft Office Word text v ovládacím prvku obsah obsah ovládací prvek vázán na vlastní části jazyk XML . (Zděděno z ContentControlBase.)
	Deleting	Dochází právě před odstraněním ovládacího prvku obsah 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 klepne v ovládacím prvku obsah nebo kurzor programově přesunuta do ovládacího prvku obsah . (Zděděno z ContentControlBase.)
	Exiting	Dojde, když uživatel klepne mimo kontrolu obsah nebo kurzor programově přesunuta mimo kontrolu obsah . (Zděděno z ContentControlBase.)
	StoreUpdating	Nastane těsně před systém Microsoft Office Word aktualizuje data ve vlastní svázané s obsah jazyk XML části řízení (po text v obsah řízení změn). (Zděděno z ContentControlBase.)
	Validated	Vyvolá se při řízení obsah byl úspěšně ověřen. (Zděděno z ContentControlBase.)
	Validating	Vyvolá se při ověřuje obsah ovládacího prvku obsah . (Zděděno z ContentControlBase.)

Na začátek

Poznámky

Použít GroupContentControl k definování chráněné oblasti dokumentu, uživatelé nemohou úprava nebo odstranit. A GroupContentControl mohou obsahovat jakékoli položky dokumentu, například text, tabulky, grafiku a i ostatní obsah ovládacích prvků. A GroupContentControl poskytuje žádné uživatelské rozhraní pro uživatelviditelný. Další informace o použití GroupContentControl pro ochranu části dokumentu, viz Content Controls a How to: Protect Parts of Documents by Using Content Controls.

Poznámka

Toto rozhraní je implementováno modulem runtime nástrojů Visual Studio Tools for Office. Rozhraní není určeno k implementaci do vašeho kódu. Další informace naleznete v tématu Visual Studio Tools for Office Runtime Overview.

Ovládací prvky obsahu

GroupContentControl Je jedním z osmi typů ovládacích prvků obsahu lze navrhnout dokumenty a šablony aplikace Microsoft Office Word. Obsahu mají ovládací prvky uživatel rozhraní (UI), byla řízena vstupní formulář, atd. Ovládací prvky obsah můžete zabránit uživatelům v úpravách chráněné oddíly dokumentu nebo šablonaa svázat ovládací prvky obsah zdroj dat. Další informace naleznete v tématu Content Controls.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených na rozhraní .NET Framework 4. V projektech cílených na rozhraní .NET Framework 3.5 může mít tento typ rozdílné členy a příklady kódů pro tento typ nemusí 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 do začátku dokumentu a vytvoří nový GroupContentControl obsahující odstavce. GroupContentControl Zabrání uživatelům úpravy textu v odstavci.

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- doplněkúroveň. 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");
}