Proprietà Document.Controls (System 2007)

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)

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

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.

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


Date

History

Motivo

Luglio 2008

Aggiunta una versione dell'esempio di codice per un componente aggiuntivo a livello di applicazione.

Modifica di funzionalità in SP1.

Aggiunte alla community

Mostra: