Condividi tramite


Guida introduttiva alla programmazione delle personalizzazioni a livello di documento per Word

Aggiornamento: novembre 2007

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.

Tipo di progetto

  • Progetti a livello di documento

Versione Microsoft Office

  • Word 2003

  • Word 2007

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

Le informazioni riportate di seguito sono utili se ancora non si è acquisita dimestichezza con la procedura di creazione di personalizzazioni a livello di documento per Microsoft Office Word con Visual Studio Tools per Office.

Modello di applicazione a documento singolo

Ogni personalizzazione per Word creata è basata su un singolo documento. Per iniziare a utilizzare la personalizzazione, l'utente finale apre il documento o lo crea da un modello di Word. Gli eventi presenti nel documento, ad esempio lo spostamento del cursore in aree specifiche o la scelta di pulsanti e voci di menu, possono chiamare metodi di gestione degli eventi nell'assembly. Per ulteriori informazioni, vedere Architettura delle personalizzazioni a livello di documento.

Programmazione di documenti di Word utilizzando controlli host di 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 inoltre funzionare da contenitori per determinati tipi di controlli, ad esempio i controlli host e i controlli Windows Form. Le personalizzazioni di Word utilizzano l'elemento host Microsoft.Office.Tools.Word.Document. Questo elemento host ha una finestra di progettazione che è la rappresentazione visiva del documento di Word nel progetto, come una finestra di progettazione Windows Form. Nel progetto, questo elemento host è rappresentato dalla classe ThisDocument che deriva dall'elemento host Microsoft.Office.Tools.Word.Document. Per ulteriori informazioni, vedere Cenni preliminari sugli elementi e sui controlli host e Elemento host documento.

I controlli host sono basati su oggetti Word nativi, ad esempio controlli del contenuto, segnalibri e nodi XML. I controlli host, oltre a presentare funzionalità analoghe a quelle degli oggetti Word nativi, forniscono anche il supporto della finestra di progettazione nonché nuovi eventi e funzionalità di associazione dati. Tali controlli vengono visualizzati come oggetti di primaria importanza nel modello di programmazione di Visual Studio Tools per Office e in IntelliSense, il che rende più semplice fare riferimento a oggetti specifici direttamente nel codice senza dover ricorrere al modello a oggetti di Word. Per ulteriori informazioni, vedere Cenni preliminari sugli elementi e sui controlli host e Controlli host di Word.

Ci sono diversi controlli host disponibili nei progetti a livello di documento per Word 2003 e Word 2007. In entrambi gli insiemi di progetti, è possibile utilizzare i controlli Bookmark e XMLNode. Nei progetti Word 2007, è anche possibile utilizzare i controlli del contenuto. Per ulteriori informazioni, vedere Controlli contenuto, Controllo Bookmark e Controllo XMLNode.

Associazione dei controlli ai dati

I controlli del contenuto e il controllo Bookmark sono nell'elenco dei controlli trascinabili dalla finestra Origini dati. Aggiungendo controlli del contenuto e segnalibri in questo modo, li si associa automaticamente all'origine dati impostata utilizzando la finestra. È possibile visualizzare dati da database, servizi Web e oggetti del documento senza scrivere alcun codice. Per ulteriori informazioni, vedere la classe Associazione di dati ai controlli.

Personalizzazione dell'interfaccia utente di Word

Nella maggior parte delle soluzioni Microsoft Office, l'interfaccia utente (UI) dell'applicazione di Office viene modificata allo scopo di consentire agli utenti di interagire con la soluzione. Una personalizzazione a livello di documento consente di modificare vari aspetti dell'interfaccia utente di Word. Ad esempio, è possibile aggiungere controlli alla barra multifunzione, visualizzare un riquadro delle azioni e creare smart tag che rispondono a stringhe specifiche digitate dagli utenti nel documento. Per ulteriori informazioni, vedere Personalizzazione dell'interfaccia utente di Office.

Passaggi successivi

Per un elenco degli argomenti in cui vengono analizzate alcune delle attività più comuni relative all'automazione di Word, vedere Attività comuni nella programmazione con Office.

Vedere anche

Attività

Procedura dettagliata: creazione della prima personalizzazione a livello di documento per Word

Concetti

Procedure dettagliate con Word

Soluzioni Word

Cenni preliminari sul modello a oggetti di Word

Guida introduttiva alla scrittura di codice

Guida introduttiva alla programmazione di personalizzazioni a livello di documento per Excel

Altre risorse

Guida introduttiva (Visual Studio Tools per Office)