Document.Controls – vlastnost

Článek
01/03/2014

Získá kolekci spravovaných ovládacích prvků, které jsou obsaženy v dokumentu.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word.v4.0.Utilities (v Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
ReadOnly Property Controls As ControlCollection

ControlCollection Controls { get; }

Hodnota vlastnosti

Typ: Microsoft.Office.Tools.Word.ControlCollection
A ControlCollection , který obsahuje všechny spravované ovládací prvky v dokumentu.

Poznámky

Dokument v řešení sady Office může obsahovat ovládací prvky model Windows Forms a hostitele.Další informace naleznete v tématu Ovládací prvky v dokumentech Office.

Pokud chcete spravovat ovládací prvky v dokumentu za běhu, použijte metody a vlastnosti ControlCollection objekt vrácený funkcí Controls vlastnost.Další informace naleznete v tématu Přidání ovládacích prvků do dokumentů Office za běhu.

Příklady

Následující příklad kódu přidá text prvního odstavce a vytvoří Bookmark ovládací prvek, který zahrnuje odstavce.Kód potom zobrazí okno se zprávou, která zobrazuje celkový počet ovládacích prvků v dokumentu.V tomto příkladu je aplikace úroveň doplněk.

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());
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.