Elemento host documento
Aggiornamento: Luglio 2008
Si applica a |
|---|
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Progetti a livello di documento
Progetti a livello di applicazione
Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione. |
L'elemento host Document rappresenta un documento di Word che espone eventi e agisce da contenitore per i controlli host e i controlli Windows Form. L'elemento host Document fornisce inoltre tutti gli stessi metodi, eventi e proprietà della classe Microsoft.Office.Interop.Word.Document dell'assembly di interoperabilità primario di Word.
Nei progetti a livello di documento è presente un elemento host Document che rappresenta il documento nel progetto. A partire da Visual Studio 2008 Service Pack 1 (SP1) è inoltre possibile generare in fase di esecuzione elementi host Document mediante componenti aggiuntivi a livello di applicazione per Word 2007.
Informazioni sull'elemento host Document dei progetti a livello di documento
Per accedere a livello di codice al documento contenuto nel progetto è possibile utilizzare la classe ThisDocument. Quando si crea un progetto a livello di documento, Visual Studio Tools per Office genera la classe ThisDocument per offrire il collegamento di comunicazione tra Word e il codice di personalizzazione. La classe ThisDocument deriva dalla classe dell'elemento host Document. Visual Studio Tools per Office crea automaticamente un'istanza della classe ThisDocument quando il documento viene aperto in fase di esecuzione. Evitare di creare un'istanza della classe Document direttamente nel codice
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.
La classe ThisDocument fornisce un punto di partenza da cui iniziare a scrivere il codice per il progetto. Poiché la classe fornisce tutte le stesse proprietà, metodi ed eventi della classe 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 Document
Un progetto a livello di documento può contenere un solo elemento host Document. Non è possibile aggiungere in fase di progettazione nuovi elementi host Document nel progetto né creare in fase di esecuzione a livello di codice 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
A partire da SP1 è possibile generare in fase di esecuzione un elemento host Document per qualsiasi documento aperto in Word. L'elemento host Document può essere utilizzato per aggiungere controlli e smart tag nel documento associato.
Per generare un elemento host Document, utilizzare il metodo GetVstoObject di qualsiasi oggetto Microsoft.Office.Interop.Word.Document. Per ulteriori informazioni, vedere la classe 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
Cenni preliminari sul modello a oggetti di Word
Limitazioni a livello di codice degli elementi e dei controlli host
Altre risorse
Cronologia delle modifiche
Date |
History |
Motivo |
|---|---|---|
|
Luglio 2008 |
Aggiunte informazioni sull'utilizzo di elementi host Document in progetti a livello di applicazione. |
Modifica di funzionalità in SP1. |