Cenni preliminari sui riquadri attività personalizzati

Articolo
04/28/2010

Aggiornamento: novembre 2007

Si applica a
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le applicazioni di Microsoft Office specificati. Tipo di progetto Progetti a livello di applicazione Applicazione di Microsoft Office Excel 2007 InfoPath 2007 Outlook 2007 PowerPoint 2007 Word 2007 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le applicazioni di Microsoft Office specificati.

Tipo di progetto

Progetti a livello di applicazione

Applicazione di Microsoft Office

Excel 2007
InfoPath 2007
Outlook 2007
PowerPoint 2007
Word 2007

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

I riquadri attività sono pannelli dell'interfaccia utente generalmente ancorati a un lato di una finestra in un'applicazione di Microsoft Office. Tali riquadri consentono di creare un riquadro attività basato sulle proprie esigenze specifiche e offrono agli utenti un'interfaccia utente per l'accesso alle funzionalità della soluzione. L'interfaccia può, ad esempio, contenere controlli che consentono di eseguire codice per la modifica dei documenti o per la visualizzazione dei dati di un'origine dati.

È possibile creare un riquadro attività personalizzato soltanto in un componente aggiuntivo a livello di applicazione di una delle applicazioni di Microsoft Office System 2007 appena elencate. Non è possibile creare un riquadro attività personalizzato in una personalizzazione a livello di documento. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione.

Nota:
Un riquadro attività personalizzato è diverso da un riquadro azioni. Il riquadro azioni è parte delle personalizzazioni a livello di documento per Microsoft Office Word e Microsoft Office Excel. Per ulteriori informazioni, vedere Cenni preliminari sul riquadro delle azioni.

Vantaggi dei riquadri attività personalizzati

I riquadri attività personalizzati consentono di integrare le funzionalità in un'interfaccia utente dall'aspetto familiare. È infatti possibile creare rapidamente un riquadro attività personalizzato utilizzando gli strumenti di Visual Studio.

Interfaccia utente familiare

Gli utenti delle applicazioni di Microsoft Office hanno già acquisito familiarità con l'utilizzo dei riquadri attività, ad esempio il riquadro Stili e formattazione di Word. I riquadri attività personalizzati presentano un funzionamento simile a quello di altri riquadri attività di Microsoft Office. Gli utenti possono ancorare i riquadri attività personalizzati ai diversi lati della finestra dell'applicazione oppure possono trascinare i riquadri attività personalizzati in qualsiasi posizione all'interno della finestra. È possibile creare un componente aggiuntivo che visualizzi più riquadri attività personalizzati contemporaneamente, garantendo agli utenti la possibilità di controllare ogni riquadro singolarmente.

Supporto per Windows Form

L'interfaccia utente di un riquadro attività personalizzato creato mediante Visual Studio Tools per Office si basa sui controlli Windows Form. È possibile utilizzare il noto strumento Progettazione Windows Form per progettare l'interfaccia utente per un riquadro attività personalizzato, nonché il supporto per l'associazione dati dei Windows Form per associare un'origine dati ai controlli del riquadro attività.

Creazione di un riquadro attività personalizzato

Per creare un riquadro attività personalizzato di base è sufficiente effettuare i due passaggi seguenti:

Creare un'interfaccia utente per il riquadro attività personalizzato aggiungendo controlli Windows Form a un oggetto UserControl.
Creare un'istanza del riquadro attività personalizzato passando il controllo utente all'oggetto CustomTaskPaneCollection nel componente aggiuntivo. Tale insieme restituisce un nuovo oggetto CustomTaskPane utilizzabile per modificare l'aspetto del riquadro attività e rispondere agli eventi utente.

Per una procedura dettagliata, vedere Procedura: aggiungere un riquadro attività personalizzato a un'applicazione.

Creazione dell'interfaccia utente

Tutti i riquadri attività personalizzati creati utilizzando Visual Studio Tools per Office contengono un oggetto UserControl. Tale controllo utente fornisce l'interfaccia utente del riquadro attività personalizzato e può essere creato in fase di progettazione o di esecuzione. Se viene creato in fase di progettazione, è possibile utilizzare Progettazione Windows Form per costruire l'interfaccia utente del riquadro attività.

Creazione di un'istanza del riquadro attività personalizzato

Dopo aver creato un controllo utente contenente l'interfaccia utente del riquadro attività personalizzato, è necessario creare un'istanza di un oggetto CustomTaskPane. A questo scopo, passare il controllo utente all'insieme CustomTaskPaneCollection nel componente aggiuntivo chiamando uno dei metodi Add. Tale insieme viene esposto come campo CustomTaskPanes della classe ThisAddIn. Per utilizzare l'esempio di codice seguente è necessario eseguirlo dalla classe ThisAddIn.

myUserControl1 = New MyUserControl
myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "My Task Pane")
myCustomTaskPane.Visible = True

myUserControl1 = new MyUserControl();
myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, "My Task Pane");
myCustomTaskPane.Visible = true;

I metodi Add restituiscono un nuovo oggetto CustomTaskPane utilizzabile per modificare l'aspetto del riquadro attività e per rispondere agli eventi utente.

Controllo del riquadro attività in più finestre

I riquadri attività personalizzati sono associati a una finestra cornice di documento che presenta all'utente una visualizzazione di un documento o di un elemento. Il riquadro attività è visibile solo quando la finestra associata è visibile.

Per determinare quale finestra visualizza il riquadro attività personalizzato, utilizzare l'overload del metodo Add appropriato per creare il riquadro attività:

Per associare il riquadro attività alla finestra attiva, utilizzare il metodo CustomTaskPaneCollection.Add(UserControl, String).
Per associare il riquadro attività a un documento ospitato da una finestra specifica, utilizzare il metodo CustomTaskPaneCollection.Add(UserControl, String, Object).

Outlook, Word e InfoPath richiedono istruzioni esplicite su quando creare o visualizzare il riquadro attività nei casi in cui sono aperte più finestre. In questi casi, pertanto, occorre prendere in considerazione il punto del codice in cui creare un'istanza del riquadro attività personalizzato per garantire che il riquadro attività visualizzato contenga i documenti o gli elementi appropriati dell'applicazione. Per ulteriori informazioni, vedere la classe Gestione dei riquadri attività personalizzati in più finestre dell'applicazione.

Accesso all'applicazione dal riquadro attività

Se si desidera automatizzare l'applicazione dal controllo utente, è possibile accedere direttamente al modello a oggetti utilizzando la classe Globals.ThisAddIn.Application nel codice. La classe statica Globals consente di accedere all'oggetto ThisAddIn. Il campo Application di questo oggetto rappresenta il punto di ingresso nel modello a oggetti dell'applicazione.

Per ulteriori informazioni sul campo Application dell'oggetto ThisAddIn, vedere Programmazione di componenti aggiuntivi a livello di applicazione. Per una procedura dettagliata che illustri come automatizzare un'applicazione da un riquadro attività personalizzato, vedere Procedura dettagliata: automazione di un'applicazione da un riquadro attività personalizzato. Per ulteriori informazioni sulla classe Globals, vedere Accesso globale agli oggetti nei progetti Visual Studio Tools per Office.

Gestione dell'interfaccia utente del riquadro attività

Dopo aver creato il riquadro attività è possibile utilizzare le proprietà e gli eventi dell'oggetto CustomTaskPane per controllare l'interfaccia utente del riquadro attività e per definire il comportamento in risposta alle modifiche apportate dall'utente al riquadro attività.

Rendere visibile il riquadro attività personalizzato

Per impostazione predefinita, il riquadro attività non è visibile. Per visualizzarlo, è necessario impostare la proprietà Visible su true.

Gli utenti possono chiudere un riquadro attività in qualsiasi momento. A tale scopo è sufficiente fare clic sul pulsante Chiudi (X) nell'angolo del riquadro attività. Non esiste, tuttavia, una modalità predefinita per riaprire il riquadro attività personalizzato. Se un utente chiude un riquadro attività personalizzato, potrà rivisualizzarlo solo se viene fornito lo strumento atto a eseguire tale operazione.

Se si crea un riquadro attività personalizzato nel componente aggiuntivo, è consigliabile creare anche un elemento dell'interfaccia utente, ad esempio un pulsante, selezionabile dagli utenti per visualizzare o nascondere il riquadro stesso. Se il riquadro attività personalizzato viene creato in un'applicazione di Microsoft Office che supporta la personalizzazione della barra multifunzione, è possibile aggiungere un gruppo di controlli alla barra multifunzione contenente un pulsante che consente di visualizzare o nascondere il riquadro attività personalizzato. Per la relativa procedura dettagliata, vedere Procedura dettagliata: sincronizzazione di un riquadro attività personalizzato con una barra multifunzione.

Se si crea un riquadro attività personalizzato in un'applicazione di Microsoft Office che non supporta la personalizzazione della barra multifunzione, è possibile aggiungere un oggetto CommandBarButton che consenta di visualizzare o nascondere tale riquadro.

Modifica dell'aspetto del riquadro attività

È possibile controllare le dimensioni e la posizione di un riquadro attività personalizzato utilizzando le proprietà dell'oggetto CustomTaskPane, nonché apportare molte altre modifiche all'aspetto del riquadro utilizzando le proprietà dell'oggetto UserControl contenuto nel riquadro stesso. È, ad esempio, possibile specificare un'immagine di sfondo per un riquadro attività personalizzato utilizzando la proprietà BackgroundImage del controllo utente.

Nella tabella seguente sono elencate le modifiche che è possibile apportare a un riquadro attività personalizzato mediante le proprietà CustomTaskPane.

Attività	Proprietà
Per modificare le dimensioni del riquadro attività	Height Width
Per modificare la posizione del riquadro attività	DockPosition
Per nascondere il riquadro attività o renderlo visibile	Visible
Per impedire che l'utente modifichi la posizione del riquadro attività	DockPositionRestrict

Programmazione degli eventi del riquadro attività personalizzato

È possibile che si desideri impostare il componente aggiuntivo in modo che risponda alle modifiche apportate dall'utente al riquadro attività personalizzato. Se, ad esempio, l'utente modifica l'orientamento del riquadro da verticale a orizzontale, potrebbe essere necessario riposizionare i controlli.

Nella tabella seguente sono elencati gli eventi che è possibile gestire per rispondere alle modifiche apportate dall'utente al riquadro attività personalizzato.

Attività	Evento
Per definire il comportamento quando l'utente modifica la posizione del riquadro attività	DockPositionChanged
Per definire il comportamento quando l'utente nasconde o rende visibile il riquadro attività	VisibleChanged

Eliminazione delle risorse utilizzate dal riquadro attività

Dopo aver creato un riquadro attività personalizzato, l'oggetto CustomTaskPane rimane in memoria finché il componente aggiuntivo è in esecuzione. L'oggetto rimane in memoria persino dopo che l'utente fa clic sul pulsante Chiudi (X) nell'angolo del riquadro attività.

Per liberare le risorse utilizzate dal riquadro attività mentre il componente aggiuntivo è ancora in esecuzione, utilizzare i metodi Remove o RemoveAt. Tali metodi rimuovono l'oggetto CustomTaskPane specificato dall'insieme CustomTaskPanes ed effettuano quindi la chiamata al metodo Dispose dell'oggetto.

Nel runtime di Visual Studio Tools per Office le risorse utilizzate dal riquadro attività personalizzato vengono liberate automaticamente quando il componente aggiuntivo viene scaricato. Non chiamare i metodi Remove o RemoveAt nel gestore eventi ThisAddIn_Shutdown del progetto. Tali metodi generano un'eccezione ObjectDisposedException, perché nel runtime di Visual Studio Tools per Office le risorse utilizzate dall'oggetto CustomTaskPane vengono liberate prima della chiamata a ThisAddIn_Shutdown. Per ulteriori informazioni su ThisAddIn_Shutdown, vedere Eventi di progetti Visual Studio Tools per Office.