Elemento host documento

Articolo
02/19/2013

L'elemento host Document è un tipo che consente di estendere il tipo Microsoft.Office.Interop.Word.Document dall'assembly di interoperabilità primario per Word.L'elemento host Document fornisce tutte le proprietà, i metodi e gli eventi come un oggetto Microsoft.Office.Interop.Word.Document, ma espone anche eventi aggiuntivi e agisce come un contenitore di controlli host e controlli Windows Form.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento e di applicazione per Word 2013 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Nei progetti a livello di documento è presente un elemento host Document predefinito che rappresenta il documento nel progetto.Nei progetti a livello di applicazione è possibile generare elementi host Document in fase di esecuzione.

Informazioni sull'elemento host Document dei progetti a livello di documento

Per accedere al documento nel progetto, utilizzare la classe ThisDocument.Quando si crea un progetto a livello di documento, Visual Studio genera la classe ThisDocument che funge da collegamento di comunicazione tra Word e il codice di personalizzazione.La classe ThisDocument consente l'accesso dell'utente ai membri dell'elemento host Document per eseguire attività di base nella personalizzazione, ad esempio l'esecuzione di codice quando il documento viene aperto o chiuso.È inoltre possibile utilizzare la classe per aggiungere controlli al documento.Combinando opportunamente codice e diversi gruppi di controlli è possibile associare i controlli a dati, ottenere informazioni dall'utente e rispondere alle azioni dell'utente.Per ulteriori informazioni, vedere Programmazione delle personalizzazioni a livello di documento.

La classe ThisDocument fornisce un punto di partenza da cui iniziare a scrivere il codice per il progetto.Poiché la classe fornisce le stesse proprietà, gli stessi metodi e gli stessi eventi dell'oggetto Microsoft.Office.Interop.Word.Document nell'assembly di interoperabilità primario per Word, è anche possibile utilizzare ThisDocument per accedere al modello a oggetti di Word.Per ulteriori informazioni, vedere Cenni preliminari sul modello a oggetti di Word.

Limitazioni dell'elemento host documento nei progetti a livello di documento

Un progetto a livello di documento può contenere un solo elemento host Document (ovvero la classe ThisDocument ).Non è possibile aggiungere in fase di progettazione nuovi elementi host Document al progetto, né creare in fase di esecuzione nuovi elementi host Document a partire da una personalizzazione a livello di documento.

Se si crea in fase di esecuzione un nuovo documento di Word, il tipo corrispondente sarà Microsoft.Office.Interop.Word.Document.Poiché non è un elemento host, non può contenere controlli host o controlli Windows Form.Per ulteriori informazioni sulla creazione di documenti in fase di esecuzione, vedere Procedura: creare nuovi documenti a livello di codice.

Informazioni sugli elementi host Document nei progetti a livello di applicazione

Nei progetti a livello di applicazione è possibile generare un elemento host Document in fase di esecuzione per qualsiasi documento aperto in Word.È possibile utilizzare l'elemento host Document per aggiungere controlli al documento collegato, o per gestire eventi non disponibili in Microsoft.Office.Interop.Word.Document oggetti.

Per generare un elemento host Document, utilizzare il metodo GetVstoObject.Per ulteriori informazioni, vedere Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.