Interfejs GroupContentControl

Artykuł
05/08/2013

Reprezentuje region chronionego dokumentu, który użytkownicy nie można edytować ani usuwać.

Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestaw: Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)

Składnia

'Deklaracja
<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 uwidacznia następujące elementy członkowskie.

Właściwości

	Nazwa	Opis
	Application	Pobiera Microsoft.Office.Interop.Word.Application , oznaczającą w bieżącym wystąpieniu programu Microsoft Office Word.
	BindingContext	Zwraca lub ustawia kolekcji menedżerów waluty IBindableComponent. (Odziedziczone z IBindableComponent).
	Container	Infrastruktura. (Odziedziczone z ContentControlBase).
	ContainerComponent	Infrastruktura. (Odziedziczone z ContentControlBase).
	Creator	32-Bitowa liczba całkowita, która wskazuje aplikacji, w którym dostaje GroupContentControl został utworzony.
	DataBindings	Zwraca kolekcję obiektów wiązania danych dla tej IBindableComponent. (Odziedziczone z IBindableComponent).
	DefaultDataSourceUpdateMode	Pobiera lub ustawia domyślną DataSourceUpdateMode dla ContentControlBase. (Odziedziczone z ContentControlBase).
	ID	Pobiera unikatowy numer identyfikacyjny formantu zawartości. (Odziedziczone z ContentControlBase).
	InnerObject	Pobiera, podstawową Microsoft.Office.Interop.Word.ContentControl obiekt na potrzeby Microsoft.Office.Tools.Word.ContentControlBase. (Odziedziczone z ContentControlBase).
	LockContentControl	Pobiera lub ustawia wartość, która określa, czy GroupContentControl mogą zostać usunięte z dokumentu.
	Parent	Pobiera element nadrzędny z GroupContentControl.
	ParentContentControl	Pobiera element nadrzędny zawartości kontrolę nad GroupContentControl który jest zagnieżdżony w innym formancie zawartości.
	Range	Pobiera Range , oznaczającą zawartość GroupContentControl.
	Site	Zwraca lub ustawia ISite związane z IComponent. (Odziedziczone z IComponent).
	Tag	Pobiera lub ustawia ciąg, który chcesz skojarzyć z GroupContentControl.
	Text	Pobiera tekst GroupContentControl.
	Title	Pobiera lub ustawia tytuł GroupContentControl.

Początek

Metody

	Nazwa	Opis
	BeginInit	Sygnalizuje ten obiekt, że inicjowania jest uruchamiana. (Odziedziczone z ISupportInitialize).
	Copy	Kopie GroupContentControl z dokumentu do Schowka.
	Cut	Usuwa GroupContentControl z dokumentu i dodaje go do Schowka.
	Delete	Usuwa dynamicznie utworzony formant zawartości z dokumentu i usuwa go z ControlCollection w dokumencie. (Odziedziczone z ContentControlBase).
	Dispose	Wykonuje zadania zdefiniowane aplikacji skojarzonej z zwalniania, zwalnianie lub resetowanie niezarządzanych zasobów. (Odziedziczone z IDisposable).
	EndInit	Sygnalizuje ten obiekt, że inicjowanie zostanie zakończone. (Odziedziczone z ISupportInitialize).

Początek

Zdarzenia

	Nazwa	Opis
	Added	Występuje po dodaniu formantu zawartości do dokumentu. (Odziedziczone z ContentControlBase).
	BindingContextChanged	Występuje, gdy wartość BindingContext właściwość ContentControlBase zmiany. (Odziedziczone z ContentControlBase).
	ContentUpdating	Występuje tuż przed programu Microsoft Office Word tekst w formancie zawartości jest aktualizowany, jeśli formant zawartości jest powiązany niestandardowa część kodu XML. (Odziedziczone z ContentControlBase).
	Deleting	Występuje tuż przed formant zawartości jest usunięte z dokumentu. (Odziedziczone z ContentControlBase).
	Disposed	Metoda, która obsługuje reprezentuje Disposed zdarzeń składnika. (Odziedziczone z IComponent).
	Entering	Występuje, gdy użytkownik kliknie w formancie zawartości lub w przypadku, gdy kursor jest przesuwany do formantu zawartości programowo. (Odziedziczone z ContentControlBase).
	Exiting	Występuje, gdy użytkownik kliknie poza formantu zawartości lub gdy kursor jest przesuwany poza kontrolą zawartości programowo. (Odziedziczone z ContentControlBase).
	StoreUpdating	Występuje tuż przed programu Microsoft Office Word aktualizuje dane w niestandardowa część kodu XML, która jest ograniczona do zawartości kontroli (to znaczy, po tekstu w treści kontrolowania zmian). (Odziedziczone z ContentControlBase).
	Validated	Występuje, gdy formant zawartości została pomyślnie sprawdzona. (Odziedziczone z ContentControlBase).
	Validating	Występuje, gdy trwa sprawdzanie poprawności zawartości formantu zawartości. (Odziedziczone z ContentControlBase).

Początek

Uwagi

Użycie GroupContentControl definiujących obszar chronionego dokumentu, który użytkownicy nie można edytować ani usuwać.A GroupContentControl może zawierać jakichkolwiek elementów dokumentu, takich jak tekst, tabele, grafiki i nawet inne formanty zawartości.A GroupContentControl zapewnia brak interfejsu użytkownika, który jest widoczny dla użytkownika.Aby uzyskać więcej informacji na temat korzystania z GroupContentControl do ochrony części dokumentu, zobacz Formanty zawartości i Jak: ochrona części dokumentów przy użyciu formantów zawartości.

[!UWAGA]

Ten interfejs jest implementowany przez Visual Studio Tools for Office Runtime. Nie jest on przeznaczony do implementacji w kodzie. Aby uzyskać więcej informacji, zobacz Visual Studio Tools dla pakietu Office, omówienie Runtime.

Formanty zawartości

GroupContentControl Jest jednym z ośmiu typów formantów zawartości, które służą do projektowania dokumentów i szablonów w programie Microsoft Office Word.Zawartości, że formanty mają interfejs użytkownika (UI) który kontrolował dane tak, jak formularz.Formanty zawartości można użyć, aby uniemożliwić użytkownikom edytowanie chronionych sekcji dokumentu lub szablonu, a formanty zawartości można również powiązać ze źródłem danych.Aby uzyskać więcej informacji, zobacz Formanty zawartości.

Użycie

W dokumentacji opisano wersję typu używanego w projektach dla pakietu Office przeznaczonych do pracy z programem .NET Framework 4 i .NET Framework 4.5. W projektach przeznaczonych do pracy z programem .NET Framework 3.5 ten typ może mieć inne elementy członkowskie, a przykładowy kod podany dla tego typu może nie działać. Aby uzyskać dokumentację tego typu używanego w projektach przeznaczonych do działania z programem .NET Framework 3.5, zobacz następującą sekcję informacyjną w dokumentacji programu Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Przykłady

Poniższy przykład kodu dodaje się nową literę na początku dokumentu i tworzy nową GroupContentControl zawierający niniejszego ustępu.GroupContentControl Uniemożliwia użytkownikom edycję tekstu w akapicie.

Ta wersja jest dostosowywanie poziomie dokumentu.Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie, a wywołanie AddGroupControlAtSelection metodę 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");
}

Ta wersja jest na poziomie aplikacji dodatek.Aby użyć tego kodu, wklej go do ThisAddIn klasy w projekcie, a wywołanie AddGroupControlAtSelection metodę 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");
}