Поделиться через


GroupContentControl - интерфейс

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

Пространство имен:  Microsoft.Office.Tools.Word
Сборка:  Microsoft.Office.Tools.Word (в Microsoft.Office.Tools.Word.dll)

Синтаксис

'Декларация
<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

Тип GroupContentControl предоставляет следующие члены.

Свойства

  Имя Описание
Открытое свойство Application Получает объект Microsoft.Office.Interop.Word.Application, представляющий текущий экземпляр Microsoft Office Word.
Открытое свойство BindingContext Получает или задает коллекцию диспетчеров денежных единиц для объекта IBindableComponent. (Унаследовано от IBindableComponent.)
Открытое свойство Container Инфраструктура. (Унаследовано от ContentControlBase.)
Открытое свойство ContainerComponent Инфраструктура. (Унаследовано от ContentControlBase.)
Открытое свойство Creator Возвращает 32-разрядное целое число, указывающее приложение, в котором был создан элемент управления GroupContentControl.
Открытое свойство DataBindings Получает коллекцию объектов привязки к данным для этого компонента IBindableComponent. (Унаследовано от IBindableComponent.)
Открытое свойство DefaultDataSourceUpdateMode Получает или задает значение DataSourceUpdateMode по умолчанию для ContentControlBase. (Унаследовано от ContentControlBase.)
Открытое свойство ID Возвращает уникальное число, идентифицирующее элемент управления содержимым. (Унаследовано от ContentControlBase.)
Открытое свойство InnerObject Получает базовый объект Microsoft.Office.Interop.Word.ContentControl для объекта Microsoft.Office.Tools.Word.ContentControlBase. (Унаследовано от ContentControlBase.)
Открытое свойство LockContentControl Возвращает или задает значение, указывающее, можно ли удалить из документа элемент управления GroupContentControl.
Открытое свойство Parent Возвращает родительский объект для элемента управления GroupContentControl.
Открытое свойство ParentContentControl Возвращает родительский элемент управления содержимым для элемента управления GroupContentControl, вложенного в другой элемент управления содержимым.
Открытое свойство Range Возвращает объект Range, представляющий содержимое элемента управления GroupContentControl.
Открытое свойство Site Получает или задает интерфейс ISite, связанный с интерфейсом IComponent. (Унаследовано от IComponent.)
Открытое свойство Tag Возвращает или задает строку, которую необходимо связать с элементом управления GroupContentControl.
Открытое свойство Text Возвращает текст из элемента управления GroupContentControl.
Открытое свойство Title Получает или задает заголовок GroupContentControl.

В начало страницы

Методы

  Имя Описание
Открытый метод BeginInit Подает сигнал объекту о начале инициализации. (Унаследовано от ISupportInitialize.)
Открытый метод Copy Копирует объект GroupContentControl из документа в буфер обмена.
Открытый метод Cut Удаляет из документа элемент управления GroupContentControl и заносит его в буфер обмена.
Открытый метод Delete Удаляет из документа и коллекции ControlCollection динамически созданный элемент управления содержимым. (Унаследовано от ContentControlBase.)
Открытый метод Dispose Выполняет определяемые приложением задачи, связанные с высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от IDisposable.)
Открытый метод EndInit Подает объекту сигнал о завершении инициализации. (Унаследовано от ISupportInitialize.)

В начало страницы

События

  Имя Описание
Открытое событие Added Происходит после добавления в документ элемента управления содержимым. (Унаследовано от ContentControlBase.)
Открытое событие BindingContextChanged Происходит при изменении значения свойства BindingContext объекта ContentControlBase. (Унаследовано от ContentControlBase.)
Открытое событие ContentUpdating Происходит непосредственно перед тем, как приложение Microsoft Office Word обновляет текст в элементе управления содержимым, если этот элемент управления привязан к настраиваемой XML-части. (Унаследовано от ContentControlBase.)
Открытое событие Deleting Происходит непосредственно перед удалением из документа элемента управления содержимым. (Унаследовано от ContentControlBase.)
Открытое событие Disposed Представляет метод, обрабатывающий событие Disposed компонента. (Унаследовано от IComponent.)
Открытое событие Entering Происходит, когда пользователь щелкает мышью внутри элемента управления содержимым, либо при программном перемещении курсора внутрь элемента управления содержимым. (Унаследовано от ContentControlBase.)
Открытое событие Exiting Происходит, когда пользователь щелкает мышью за пределами элемента управления содержимым, либо при программном перемещении курсора за пределы элемента управления содержимым. (Унаследовано от ContentControlBase.)
Открытое событие StoreUpdating Происходит непосредственно перед тем, как приложение Microsoft Office Word обновляет в пользовательской XML-части, связанной с элементом управления содержимым (то есть после того, как изменится текст в элементе управления содержимым). (Унаследовано от ContentControlBase.)
Открытое событие Validated Происходит после успешной проверки элемента управления содержимым. (Унаследовано от ContentControlBase.)
Открытое событие Validating Происходит при проверке содержимого элемента управления. (Унаследовано от ContentControlBase.)

В начало страницы

Заметки

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

Примечание

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

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

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

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

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

Примеры

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

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

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

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

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

См. также

Ссылки

Microsoft.Office.Tools.Word - пространство имен

Другие ресурсы

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

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

Практическое руководство. Защита частей документов с помощью элементов управления содержимым

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