Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Document.Controls-Eigenschaft

 

Veröffentlicht: Oktober 2016

Ruft die Auflistung von verwalteten Steuerelementen ab, die im Dokument enthalten sind.

Namespace:   Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

ControlCollection Controls { get; }

Eigenschaftswert

Type: Microsoft.Office.Tools.Word.ControlCollection

Ein ControlCollection, das alle verwalteten Steuerelemente im Dokument enthält.

A document in an Office solution can contain Windows Forms controls and host controls. For more information, see Controls on Office Documents.

To manage the controls on a document at run time, use the methods and properties of the T:Microsoft.Office.Tools.Word.ControlCollection object returned by the P:Microsoft.Office.Tools.Word.Document.Controls property. For more information, see Adding Controls to Office Documents at Run Time.

The following code example adds text to the first paragraph and creates a T:Microsoft.Office.Tools.Word.Bookmark control that encompasses the paragraph. The code then shows a message box that displays the total number of controls on the document. This example is for an application-level add-in.

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());
}
Zurück zum Anfang
Anzeigen: