Proprietà DocumentBase.Controls

Articolo
05/17/2013

Ottiene la raccolta di controlli gestiti contenuti nel documento.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
Public ReadOnly Property Controls As ControlCollection

public ControlCollection Controls { get; }

Valore proprietà

Tipo: Microsoft.Office.Tools.Word.ControlCollection
ControlCollection che contiene tutti i controlli gestiti del documento.

Note

In una soluzione Office un documento può contenere i controlli Windows Form e controlli host.Per ulteriori informazioni, vedere Controlli nei documenti di Office.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come aggiungere testo al primo paragrafo e come creare un controllo Bookmark che includa il paragrafo.Viene quindi illustrato come visualizzare una finestra di messaggio contenente il numero totale di controlli del documento.Per utilizzare questo esempio, eseguirlo dalla classe ThisDocument in un progetto a livello di documento.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.