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
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.
См. также
Ссылки
Microsoft.Office.Tools.Word - пространство имен
Другие ресурсы
Элементы управления в документах Office
Добавление элементов управления в документы Office во время выполнения