Introduzione alla programmazione delle personalizzazioni a livello di documento per Word

Articolo
10/10/2023

Se si sta appena iniziando a creare personalizzazioni a livello di documento per Microsoft Office Word usando Visual Studio, ecco ciò che è necessario sapere.

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

Informazioni sul funzionamento delle personalizzazioni a livello di documento per Word

Ogni personalizzazione di Word creata si basa su un singolo documento. Per iniziare a usare la personalizzazione, l'utente finale apre il documento o crea il documento da un modello di Word. Gli eventi nel documento, ad esempio lo spostamento del cursore in aree specifiche o la selezione di pulsanti e voci di menu, possono chiamare metodi di gestione degli eventi nell'assembly. Quando il documento viene chiuso, le funzionalità fornite dalla personalizzazione non sono più disponibili in Word.

Per altre informazioni, vedere Architettura delle personalizzazioni a livello di documento.

Creare progetti a livello di documento per Word

Per creare una personalizzazione a livello di documento per Word, utilizzare il modello di progetto Documento di Word o Modello di Word nella finestra di dialogo Nuovo progetto . Questi modelli includono riferimenti dell'assembly e file di progetto necessari.

Per altre informazioni su come creare un progetto a livello di documento per Word, vedere Procedura: Creare progetti di Office in Visual Studio. Per altre informazioni sui modelli di progetto, vedere Panoramica dei modelli di progetto di Office.

Programmare i documenti di Word usando i controlli host degli elementi host

Gli elementi host e i controlli host sono classi che forniscono il modello di programmazione per le personalizzazioni a livello di documento.

Gli elementi host forniscono un punto di ingresso per il codice e possono anche fungere da contenitori per i controlli host e i controlli Windows Form. Nei progetti a livello di documento per Word, l'elemento host è rappresentato dalla ThisDocument classe .

I controlli host sono basati su oggetti word nativi, ad esempio controlli contenuto, segnalibri e nodi XML. I controlli host offrono funzionalità simili agli oggetti nativi di Word, ma hanno anche nuovi eventi, supporto della finestra di progettazione e funzionalità di data binding. Vengono visualizzati come oggetti di prima classe nel codice del progetto e in IntelliSense, che semplificano il riferimento a oggetti specifici direttamente nel codice senza dover esplorare il modello a oggetti di Word.

Per ulteriori informazioni, vedi gli argomenti seguenti:

Personalizzare l'interfaccia utente di Word

La maggior parte delle soluzioni di Microsoft Office modifica l'interfaccia utente della app Office lication per consentire agli utenti di interagire con la soluzione. Esistono molti modi in cui è possibile modificare l'interfaccia utente di Word usando una personalizzazione a livello di documento. Ad esempio, è possibile aggiungere controlli alla barra multifunzione ed è possibile visualizzare un riquadro azioni. Per altre informazioni, vedere Personalizzazione dell'interfaccia utente di Office.

È anche possibile aprire il documento associato al progetto direttamente in Visual Studio. Quando il documento è aperto in Visual Studio, è possibile modificare il documento usando l'interfaccia utente di Word. È anche possibile usare il documento come area di progettazione, che consente di trascinare i controlli su di esso. Per altre informazioni, vedere Progetti di Office nell'ambiente Visual Studio.

Associare controlli ai dati

I controlli contenuto e il Bookmark controllo si trovano nell'elenco dei controlli che è possibile trascinare dalla finestra Origini dati. L'aggiunta di controlli contenuto e segnalibri in questo modo li associa automaticamente all'origine dati configurata tramite la finestra. Senza scrivere codice, è possibile visualizzare dati da database, servizi e oggetti business. Per altre informazioni, vedere Associare i dati ai controlli nelle soluzioni Office.

Passaggi successivi

Per informazioni su come creare una personalizzazione a livello di documento per Word, vedere Procedura dettagliata: Creare la prima personalizzazione a livello di documento per Word. Questa procedura dettagliata presenta gli strumenti di sviluppo di Office in Visual Studio e il modello di programmazione per le personalizzazioni a livello di documento di Word.

Per un elenco di argomenti che illustrano alcune delle attività comuni nei progetti di Word, vedere Attività comuni nella programmazione di Office.

Condividi tramite