Elemento host documento
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 2007 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. Questa classe può inoltre essere utilizzata per aggiungere controlli e smart tag nel 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.
Nota
Gli smart tag sono deprecati in Excel 2010 e Word 2010. Per ulteriori informazioni, vedere Cenni preliminari sugli smart tag.
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.
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 e smart tag al documento associato o per gestire eventi non disponibili negli oggetti Microsoft.Office.Interop.Word.Document.
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.
Vedere anche
Concetti
Cenni preliminari sugli elementi e sui controlli host
Automazione di Word utilizzando oggetti estesi
Limitazioni a livello di codice degli elementi e dei controlli host