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


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

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

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

Синтаксис

'Декларация
ReadOnly Property Controls As ControlCollection
ControlCollection Controls { get; }

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

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

Заметки

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

Чтобы управлять элементами управления в документе во время выполнения, используйте методы и свойства объекта ControlCollection, возвращаемого свойством Controls.Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.

Примеры

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

Private Sub DocumentControls()
    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    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 = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    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());
}

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

См. также

Ссылки

Document Интерфейс

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

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

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

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