DocumentBase.ContentControls - свойство

Статья
08/11/2011

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

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

Синтаксис

'Декларация
Public ReadOnly Property ContentControls As ContentControls
    Get

public ContentControls ContentControls { get; }

Значение свойства

Тип: Microsoft.Office.Interop.Word.ContentControls
Коллекция ContentControls, в которой хранятся все элементы управления содержимым в документе.

Заметки

Данное свойство возвращает коллекцию исходных элементов управления содержимым в документе (то есть, объектов Microsoft.Office.Interop.Word.ContentControl в документе).

Чтобы получить доступ к расширенным элементам управления содержимым в документе, используйте свойство Controls.

Дополнительные сведения о расширенных элементах управления содержимым см. в разделе Элементы управления содержимым.

Примеры

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

Private Sub IterateContentControls()
    Dim textControl1 As Word.ContentControl = _
        Me.ContentControls.Add( _
            Word.WdContentControlType.wdContentControlText, _
            Me.Paragraphs(1).Range)
    textControl1.Title = "First Name"

    For Each cc As Word.ContentControl In Me.ContentControls
        MessageBox.Show("Content control type: " + cc.Type.ToString() _
                        + ", title: " + cc.Title)
    Next
End Sub

private void IterateContentControls()
{
    object _range = this.Paragraphs[1].Range;
    Word.ContentControl textControl1 = this.ContentControls.Add(
            Word.WdContentControlType.wdContentControlText,
            ref _range);
    textControl1.Title = "First Name";

    foreach (Word.ContentControl cc in this.ContentControls)
    {
        MessageBox.Show("Content control  type: " 
            + cc.Type.ToString() + ", title: " + cc.Title);
    }
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.