Proprietà Document.Controls

Articolo
08/11/2011

Ottiene l'insieme di controlli gestiti contenuti nel documento.

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

Sintassi

'Dichiarazione
ReadOnly Property Controls As ControlCollection
    Get

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.

Per gestire i controlli su un documento in fase di esecuzione, utilizzare i metodi e le proprietà dell'oggetto ControlCollection restituito dalla proprietà Controls. Per ulteriori informazioni, vedere Aggiunta di controlli ai documenti di Office in fase di esecuzione.

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. Questo esempio è valido per un componente aggiuntivo a livello di applicazione.

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

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.