Proprietà Document.Controls (System 2007)

Articolo
09/12/2008

Aggiornamento: Luglio 2008

Ottiene l'insieme di tutti i controlli Windows Form e i controlli host presenti nel documento.

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

Sintassi

<BrowsableAttribute(False)> _
Public Overridable ReadOnly Property Controls As ControlCollection

Dim instance As Document
Dim value As ControlCollection

value = instance.Controls

[BrowsableAttribute(false)]
public virtual ControlCollection Controls { get; }

Valore proprietà

Tipo: Microsoft.Office.Tools.Word.ControlCollection

Oggetto ControlCollection contenente tutti i controlli Windows Form e i controlli host presenti nel documento.

Note

I controlli Windows Form e host possono essere visualizzati in un documento facente parte di una personalizzazione a livello di documento in Visual Studio Tools per Office. Per ulteriori informazioni, vedere Controlli nei documenti di Office.

Quando si aggiungono diversi controlli a un documento, ciascuno di essi è membro dell'oggetto ControlCollection del documento.

È possibile aggiungere controlli a ControlCollection oppure rimuoverli utilizzando i metodi disponibili nella classe ControlCollection. 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.

Questa versione è per una personalizzazione 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());
}

Questa versione è per un componente aggiuntivo a livello di applicazione.

Private Sub DocumentControls()
    Dim vstoDoc As Document = Me.Application.ActiveDocument.GetVstoObject()
    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 = this.Application.ActiveDocument.GetVstoObject();
    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());
}

Autorizzazioni

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.