Właściwość Document.Controls —

Artykuł
01/08/2014

Pobiera kolekcja zarządzane formanty, które są zawarte w dokumencie.

Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestawy: Microsoft.Office.Tools.Word.v4.0.Utilities (w Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)

Składnia

'Deklaracja
ReadOnly Property Controls As ControlCollection

ControlCollection Controls { get; }

Wartość właściwości

Typ: Microsoft.Office.Tools.Word.ControlCollection
A ControlCollection zawierający wszystkie zarządzane formanty w dokumencie.

Uwagi

Dokument w roztworze pakietu Office może zawierać formanty Windows Forms i hosta.Aby uzyskać więcej informacji, zobacz Formanty w dokumentach pakietu Office.

Aby zarządzać kontroli nad dokumentem w czasie wykonywania, należy użyć metody i właściwości ControlCollection obiektu zwróconego przez Controls właściwość.Aby uzyskać więcej informacji, zobacz Dodawanie formantów do dokumentów pakietu Office w czasie wykonywania.

Przykłady

Poniższy kod dodaje tekst w pierwszym akapicie i tworzy Bookmark kontroli, obejmujący akapitu.Następnie kod wyświetla okno komunikatu, który wyświetla całkowitą liczbę formantów w dokumencie.W tym przykładzie jest na poziomie aplikacji dodatek.

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

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.