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

Статья
05/19/2013

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

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

Синтаксис

'Декларация
Public ReadOnly Property Controls As ControlCollection

public ControlCollection Controls { get; }

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

Тип: Microsoft.Office.Tools.Word.ControlCollection
Объект ControlCollection, содержащий все управляемые элементы управления в документе.

Заметки

Документ в решении Office может содержать элементы управления Windows Forms и элементы управления ведущего приложения.Для получения дополнительной информации см. Элементы управления в документах Office.

Примеры

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

Private Sub DocumentControls()
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(1).Range.Text = "This is some sample text."
    Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    MessageBox.Show("Total number of controls: " & Me.Controls.Count.ToString())
End Sub

private void DocumentControls()
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[1].Range.Text = "This is some sample text.";
    this.Controls.AddBookmark(this.Paragraphs[1].Range, "Bookmark1");
    MessageBox.Show("Total number of controls: " +
        this.Controls.Count.ToString());
}

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

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