Elemento di hosting del documento

L'elemento host Document è un tipo che estende il tipo Document dall'assembly di interoperabilità primario per Word. L'elemento Document host fornisce tutte le stesse proprietà, metodi ed eventi di un Document oggetto, ma espone anche eventi aggiuntivi e funge da contenitore per i controlli host e i controlli 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 l'applicazione e il tipo di progetto di Office.

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

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

Per accedere al documento nel progetto, usare la ThisDocument classe . Quando si crea un progetto a livello di documento, Visual Studio genera la ThisDocument classe da usare come collegamento di comunicazione tra Word e il codice di personalizzazione. La ThisDocument classe consente di accedere ai membri dell'elemento Document host per eseguire attività di base nella personalizzazione, ad esempio l'esecuzione del codice quando il documento viene aperto o chiuso. È anche possibile utilizzare la classe per aggiungere controlli al documento. Combinando diversi set di controlli e scrivendo codice, è possibile associare i controlli ai dati, raccogliere informazioni dall'utente e rispondere alle azioni dell'utente. Per altre informazioni, vedere Programmare personalizzazioni a livello di documento.

La ThisDocument classe fornisce una posizione in cui è possibile iniziare a scrivere codice nel progetto. Poiché la classe fornisce tutte le stesse proprietà, metodi ed eventi dell'oggetto nell'assembly Document di interoperabilità primario per Word, è anche possibile usare 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 un Document solo elemento host, ovvero la ThisDocument classe . Non è possibile aggiungere nuovi Document elementi host al progetto in fase di progettazione e non è possibile creare nuovi Document elementi host in fase di esecuzione da una personalizzazione a livello di documento.

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

Comprendere gli elementi host dei documenti nei progetti a livello di applicazione

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

Per generare un Document elemento host, usare il GetVstoObject metodo . Per ulteriori informazioni, vedere Come estendere documenti Word e cartelle di lavoro Excel nei componenti aggiuntivi VSTO durante l'esecuzione.

Contenuti correlati

• Panoramica degli elementi host e dei controlli host
• Automatizzare Word usando oggetti estesi
• Panoramica del modello a oggetti di Word
• Limitazioni a livello di codice degli elementi host e dei controlli host
• Estendere i documenti di Word e le cartelle di lavoro di Excel nei componenti aggiuntivi VSTO in fase di esecuzione