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

Статья
08/11/2011

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

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

Синтаксис

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

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

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