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

Статья
11/16/2008

Обновлен: Июль 2008

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

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

Синтаксис

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

value = instance.Controls

[BrowsableAttribute(false)]
public virtual ControlCollection Controls { get; }

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

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

Заметки

Документ, который является частью настройки на уровне документа в Visual Studio Tools for Office, может отображать элементы управления Windows Forms и ведущие элементы управления. Дополнительные сведения см. в разделе Элементы управления в документах Office.

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

Можно добавлять элементы управления к ControlCollection или удалять их с помощью методов, доступных в классе ControlCollection. Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.

Примеры

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

Эта версия предназначена для настройки уровня документа.

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

Эта версия предназначена для надстройки уровня приложения.

Private Sub DocumentControls()
    Dim vstoDoc As Document = Me.Application.ActiveDocument.GetVstoObject()
    vstoDoc.Paragraphs(1).Range.InsertParagraphAfter()
    vstoDoc.Paragraphs(1).Range.Text = "This is some sample text."
    vstoDoc.Controls.AddBookmark(vstoDoc.Paragraphs(1).Range, "Bookmark1")
    System.Windows.Forms.MessageBox.Show("Total number of controls: " & _
                                         vstoDoc.Controls.Count.ToString())
End Sub

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

Разрешения

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

См. также

Ссылки

Document Класс

Document - члены

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

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

Элементы управления в документах Office

Добавление элементов управления в документы Office во время выполнения

Журнал изменений

Дата	Журнал событий	Причина
Июль 2008	Добавлена версия кода для надстройки уровня приложения.	Изменение функции SP1.

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