Condividi tramite


Elemento host documento

L'elemento host Document è un tipo che estende il tipo Document dall'assembly di interoperabilità primario per Word. L'elemento host Document offre tutte le stesse proprietà, gli stessi metodi ed eventi di un oggetto Document , ma espone anche eventi aggiuntivi e funge da contenitore per i controlli host e quelli Windows Form.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento e ai progetti di componente aggiuntivo VSTO per Word. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

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

Informazioni sull'elemento host del documento nei progetti a livello di documento

Per accedere al documento nel progetto, usare la classe ThisDocument . Quando si crea un progetto a livello di documento, Visual Studio genera la classe ThisDocument che funge da collegamento per la comunicazione tra Word e il codice di personalizzazione. La classe ThisDocument consente l'accesso ai membri dell'elemento host Document per eseguire attività di base nella personalizzazione, ad esempio eseguire codice quando il documento è aperto o chiuso. La classe può essere usata anche per aggiungere controlli al documento. Con la combinazione di set di controlli diversi e con la scrittura di codice, è possibile associare i controlli ai dati, raccogliere le informazioni relative all'utente e rispondere alle azioni utente. Per altre informazioni, vedere Programmare personalizzazioni a livello di documento.

La classe ThisDocument offre un punto di partenza per iniziare a scrivere codice nel progetto. Dal momento che la classe offre tutte le stesse proprietà, gli stessi metodi ed eventi dell'oggetto Document nell'assembly di interoperabilità primario per Word, è possibile usare anche ThisDocument per accedere al modello a oggetti di Word. Per altre informazioni, vedere Panoramica del modello a oggetti di Word.

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

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

Se si crea un nuovo documento Word in fase di esecuzione, sarà di tipo Document. Dal momento che non si tratta di un elemento host, non può contenere alcun controllo host o controllo Windows Form. Per altre informazioni sulla creazione di documenti in fase di esecuzione, vedere Procedura: Creare nuovi documenti a livello di codice.

Informazioni sugli elementi host dei documenti nei progetti a livello di applicazione

Nei progetti di componente aggiuntivo VSTO è possibile generare un elemento host Document in fase di esecuzione per qualsiasi documento aperto in Word. È possibile usare l'elemento host Document per aggiungere controlli al documento associato oppure per gestire eventi che non sono disponibili in oggetti Document .

Per generare un elemento host Document, usare il metodo GetVstoObject. Per altre informazioni, vedere Estendere documenti di Word e cartelle di lavoro di Excel nei componenti aggiuntivi VSTO in fase di esecuzione.