Document.Controls Свойство

Определение

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

public Microsoft.Office.Tools.Word.ControlCollection Controls { get; }

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

ControlCollection

Коллекция 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.

Применяется к