Document.Controls Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает коллекцию управляемых элементов управления, содержащихся в документе.
public Microsoft.Office.Tools.Word.ControlCollection Controls { get; }
Значение свойства
Коллекция ControlCollection, содержащая все управляемые элементы управления для документа.
Примеры
В следующем примере кода текст добавляется в первый абзац и создается Bookmark элемент управления, охватывающий абзац. Затем в коде отображается окно сообщения, в котором отображается общее число элементов управления в документе. Этот пример предназначен для надстройки уровня приложения.
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());
}
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
Комментарии
Документ в решении Office может содержать элементы управления Windows Forms и элементы управления ведущего приложения. Дополнительные сведения см. в разделе элементы управления в документах Office.
Для управления элементами управления в документе во время выполнения используйте методы и свойства ControlCollection объекта, возвращаемого Controls свойством. Для получения дополнительной информации см. Adding Controls to Office Documents at Run Time.