Właściwość DocumentBase.Controls —

Artykuł
01/08/2014

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

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

Składnia

'Deklaracja
Public ReadOnly Property Controls As ControlCollection

public 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.

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.Aby wykorzystać ten przykład, należy uruchomić go z klasy ThisDocument w projekcie na poziomie dokumentu.

Private Sub DocumentControls()
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(1).Range.Text = "This is some sample text."
    Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    MessageBox.Show("Total number of controls: " & Me.Controls.Count.ToString())
End Sub

private void DocumentControls()
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[1].Range.Text = "This is some sample text.";
    this.Controls.AddBookmark(this.Paragraphs[1].Range, "Bookmark1");
    MessageBox.Show("Total number of controls: " +
        this.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.