GroupContentControl Интерфейс

Определение

Представляет защищенную область документа, которую пользователи не могут изменять или удалять.

[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
Атрибуты
Реализации

Примеры

Следующий пример кода добавляет новый абзац в начало документа и создает новый GroupContentControl , содержащий этот абзац. GroupContentControlПозволяет запретить пользователям изменять текст в абзаце.

Эта версия предназначена для настройки на уровне документа. Чтобы использовать этот код, вставьте его в ThisDocument класс в проекте и вызовите AddGroupControlAtSelection метод из ThisDocument_Startup метода.

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

Эта версия предназначена для надстройки уровня приложения. Чтобы использовать этот код, вставьте его в ThisAddIn класс в проекте и вызовите AddGroupControlAtSelection метод из ThisAddIn_Startup метода.

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

Комментарии

Используйте GroupContentControl для определения защищенной области документа, которую пользователи не могут изменять или удалять. GroupContentControlМожет содержать любые элементы документа, такие как текст, таблицы, графика и даже другие элементы управления содержимым. А GroupContentControl не предоставляет пользовательский интерфейс, видимый пользователю. Дополнительные сведения об использовании GroupContentControl для защиты части документа см. в разделах элементы управления содержимым и Защита частей документов с помощью элементов управления содержимым.

Примечание

Данный интерфейс реализуется набором средств Visual Studio для Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Visual Studio Tools for Office Runtime Overview.

Элементы управления содержимым

GroupContentControl— Это один из восьми типов элементов управления содержимым, которые можно использовать для проектирования документов и шаблонов в Microsoft Office Word. Элементы управления содержимым имеют пользовательский интерфейс, который имеет контролируемые входные данные, такие как форма. Элементы управления содержимым можно использовать, чтобы запретить пользователям изменять защищенные разделы документа или шаблона, а также можно привязывать элементы управления содержимым к источнику данных. Для получения дополнительной информации см. Content Controls.

Использование

В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформы .NET Framework 4 или более поздних ее версий. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены, а примеры кода, приведенные для этого типа, могут не работать. Документацию об этом типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Свойства

Application

Получает объект Application, представляющий текущий экземпляр Microsoft Office Word.

Container (Унаследовано от ContentControlBase)
ContainerComponent (Унаследовано от ContentControlBase)
Creator

Возвращает 32-разрядное целое число, указывающее приложение, в котором был создан элемент управления GroupContentControl.

DefaultDataSourceUpdateMode

Получает или задает значение DataSourceUpdateMode по умолчанию для ContentControlBase.

(Унаследовано от ContentControlBase)
ID

Возвращает уникальное число, идентифицирующее элемент управления содержимым.

(Унаследовано от ContentControlBase)
InnerObject

Получает базовый объект ContentControl для объекта ContentControlBase.

(Унаследовано от ContentControlBase)
LockContentControl

Получает или задает значение, которое указывает, можно ли удалять объект GroupContentControl из документа.

Parent

Возвращает родительский класс класса GroupContentControl.

ParentContentControl

Возвращает родительский элемент управления содержимым для элемента управления GroupContentControl, вложенного в другой элемент управления содержимым.

Range

Получает объект Range, представляющий содержимое объекта GroupContentControl.

Tag

Возвращает или задает строку, которую необходимо связать с элементом управления GroupContentControl.

Text

Возвращает текст из элемента управления GroupContentControl.

Title

Получает или задает заголовок GroupContentControl.

Методы

Copy()

Копирует элемент управления GroupContentControl из документа в буфер обмена.

Cut()

Удаляет из документа элемент управления GroupContentControl и заносит его в буфер обмена.

Delete(Boolean)

Удаляет динамически созданный элемент управления содержимым из документа и из коллекции ControlCollection в документе.

(Унаследовано от ContentControlBase)

События

Added

Происходит после добавления в документ элемента управления содержимым.

(Унаследовано от ContentControlBase)
BindingContextChanged

Происходит при изменении значения свойства BindingContext объекта ContentControlBase.

(Унаследовано от ContentControlBase)
ContentUpdating

Происходит непосредственно перед тем, как приложение Microsoft Office Word обновляет текст в элементе управления содержимым, если этот элемент управления привязан к настраиваемой XML-части.

(Унаследовано от ContentControlBase)
Deleting

Происходит непосредственно перед удалением из документа элемента управления содержимым.

(Унаследовано от ContentControlBase)
Entering

Происходит, когда пользователь щелкает мышью внутри элемента управления содержимым, либо при программном перемещении курсора внутрь элемента управления содержимым.

(Унаследовано от ContentControlBase)
Exiting

Происходит, когда пользователь щелкает мышью за пределами элемента управления содержимым, либо при программном перемещении курсора за пределы элемента управления содержимым.

(Унаследовано от ContentControlBase)
StoreUpdating

Происходит непосредственно перед тем, как Microsoft Office Word автоматически обновляет данные в пользовательской XML-части, которая привязана к элементу управления содержимым (то есть после изменения текста в элементе управления содержимым).

(Унаследовано от ContentControlBase)
Validated

Происходит после успешной проверки элемента управления содержимым.

(Унаследовано от ContentControlBase)
Validating

Происходит при проверке содержимого элемента управления.

(Унаследовано от ContentControlBase)

Применяется к