Condividi tramite


Proprietà Document.Controls

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

Vedere anche

Riferimenti

Document Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Altre risorse

Controlli nei documenti di Office

Aggiunta di controlli ai documenti di Office in fase di esecuzione