Interfejs GroupContentControl

Artykuł
01/08/2014

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

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 reprezentująca 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	Pobiera całkowita 32-bitowa, wskazująca aplikacji, w której 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, który identyfikuje formant zawartości. (Odziedziczone z ContentControlBase).
	InnerObject	Pobiera podstawowych Microsoft.Office.Interop.Word.ContentControl dla obiektu Microsoft.Office.Tools.Word.ContentControlBase. (Odziedziczone z ContentControlBase).
	LockContentControl	Pobiera lub ustawia wartość określająca, czy GroupContentControl może być usunięty z dokumentu.
	Parent	Pobiera element nadrzędny z GroupContentControl.
	ParentContentControl	Pobiera nadrzędnego zawartości kontrolę nad GroupContentControl który jest zagnieżdżony w innym formancie zawartości.
	Range	Pobiera Range reprezentująca zawartość GroupContentControl.
	Site	Zwraca lub ustawia ISite związane z IComponent. (Odziedziczone z IComponent).
	Tag	Pobiera lub ustawia ciąg, który ma być skojarzony 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 przez aplikację skojarzone z uwalnianiem, zwalnianiem lub resetowaniem 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ści ContentControlBase zmiany. (Odziedziczone z ContentControlBase).
	ContentUpdating	Występuje tuż przed tekstu w formancie zawartości, aktualizacje programu Microsoft Office Word, jeśli niestandardowa część kodu XML jest powiązany formant zawartości. (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 przycisk w formancie zawartości lub gdy kursor jest przesuwany do formantu zawartości programowo. (Odziedziczone z ContentControlBase).
	Exiting	Występuje, gdy użytkownik kliknie poza formant zawartości lub gdy kursor zostanie przeniesiony poza kontrolą zawartości programowo. (Odziedziczone z ContentControlBase).
	StoreUpdating	Występuje tuż przed programu Microsoft Office Word aktualizuje dane w niestandardowa część kodu XML, powiązaną z zawartością sterowania (po tekstu w treści kontrolować zmiany). (Odziedziczone z ContentControlBase).
	Validated	Występuje, gdy formant zawartości został pomyślnie sprawdzony. (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 do definiowania chroniony obszar dokumentu, który użytkownicy nie można edytować ani usunąć.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 o używaniu GroupContentControl ochrona innej części dokumentu, zobacz Formanty zawartości i Porady: ochrona części dokumentów za pomocą 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 for Office Runtime ― Przegląd.

Formanty zawartości

GroupContentControl Jest jednym z ośmiu typów formantów zawartości, których można użyć do projektowania dokumentów i szablonów w programie Microsoft Office Word.Zawartość formantów ma interfejs użytkownika (UI) który kontrolował wprowadzania, np.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 kod dodaje się nowy ustęp na początku dokumentu, a następnie tworzy nową GroupContentControl zawierający niniejszego ustępu.GroupContentControl Uniemożliwia użytkownikom edycję tekstu w akapicie.

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

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