Document.ContentControls Свойство (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

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

Синтаксис

'Декларация
<BrowsableAttribute(False)> _
Public ReadOnly Property ContentControls As ContentControls
'Применение
Dim instance As Document
Dim value As ContentControls

value = instance.ContentControls

[BrowsableAttribute(false)]
public ContentControls ContentControls { get; }

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

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

Заметки

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

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

Дополнительные сведения об элементах управления содержимым Visual Studio Tools for Office см. в разделе Элементы управления содержимым.

Примеры

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

В этом примере демонстрируется настройка уровня документа.

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

Разрешения

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