Procedura dettagliata: sincronizzazione di un riquadro attività personalizzato con una barra multifunzione

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 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
Outlook 2007
PowerPoint 2007
Word 2007

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

In questa procedura dettagliata viene illustrato come creare un riquadro attività personalizzato che gli utenti possono nascondere o visualizzare facendo clic su un interruttore della barra multifunzione. È necessario creare un elemento dell'interfaccia utente (UI), ad esempio un pulsante, che gli utenti possono utilizzare per visualizzare o nascondere il riquadro attività personalizzato, perché le applicazioni di Microsoft Office non forniscono una modalità predefinita affinché gli utenti possano visualizzare o nascondere i riquadri attività personalizzati.

Sebbene in questa procedura dettagliata si utilizza specificamente Excel, i concetti illustrati sono applicabili a qualsiasi applicazione elencata precedentemente.

In questa procedura dettagliata vengono illustrate le attività seguenti:

Progettazione dell'interfaccia utente del riquadro attività personalizzato.
Aggiunta di un interruttore alla barra multifunzione.
Sincronizzazione dell'interruttore con il riquadro attività personalizzato.

Nota:
Il computer potrebbe mostrare nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. L'edizione di Visual Studio in uso e le impostazioni utilizzate determinano questi elementi. Per ulteriori informazioni, vedere Impostazioni di Visual Studio.

Prerequisiti

Per completare questa procedura dettagliata, è necessario disporre dei seguenti componenti:

Visual Studio Tools per Office (componente facoltativo di Visual Studio 2008 Professional e Visual Studio Team System).
Microsoft Office Excel 2007.

Visual Studio Tools per Office viene installato per impostazione predefinita con le versioni di Visual Studio elencate. Per controllare se è installato, vedere Installazione di Visual Studio Tools per Office.

Creazione del progetto per un componente aggiuntivo

In questo passaggio, verrà creato un progetto componente aggiuntivo per Excel.

Per creare un nuovo progetto

Creare un progetto componente aggiuntivo di Excel con il nome SynchronizeTaskPaneAndRibbon, utilizzando il modello di progetto componente aggiuntivo di Excel per Microsoft Office System 2007. Per ulteriori informazioni, vedere Procedura: creare progetti Visual Studio Tools per Office.

Tramite Visual Studio verrà aperto il file di codice ThisAddIn.cs o ThisAddIn.vb e il progetto SynchronizeTaskPaneAndRibbon verrà aggiunto in Esplora soluzioni.

Aggiunta di un interruttore alla barra multifunzione

Per la progettazione di applicazioni di Office, è necessario che gli utenti abbiano sempre il controllo dell'interfaccia utente dell'applicazione di Office. Per permettere agli utenti di controllare il riquadro attività personalizzato, è possibile aggiungere un interruttore della barra multifunzione che consente di visualizzare e nascondere il riquadro attività. Per creare un interruttore, aggiungere un elemento Barra multifunzione (finestra di progettazione visiva) al progetto. La finestra di progettazione consente di aggiungere e posizionare i controlli, impostare le proprietà del controllo e gestire gli eventi del controllo. Per ulteriori informazioni, vedere Finestra di progettazione della barra multifunzione.

Per aggiungere un interruttore alla barra multifunzione

Scegliere Aggiungi nuovo elemento dal menu Progetto.
Nella finestra di dialogo Aggiungi nuovo elemento selezionare Barra multifunzione (finestra di progettazione visiva).
Modificare il nome della nuova barra multifunzione in ManageTaskPaneRibbon, quindi fare clic su Aggiungi.

Viene visualizzato il file ManageTaskPaneRibbon.cs o ManageTaskPaneRibbon.vb nella finestra di progettazione della barra multifunzione con una scheda e un gruppo predefiniti.
Fare clic su group1 nella finestra di progettazione della barra multifunzione.
Nella finestra Proprietà, impostare la proprietà Etichetta su Gestione riquadro attività.
Dalla scheda Controlli barra multifunzione di Office di Casella degli strumenti, trascinare un ToggleButton sul gruppo Gestione riquadro attività.
Fare clic su toggleButton1.
Nella finestra Proprietà, impostare la proprietà Etichetta su Mostra riquadro attività.

Progettazione dell'interfaccia utente del riquadro attività personalizzato

Non è disponibile alcuna finestra di progettazione visiva per i riquadri attività personalizzati, ma è possibile progettare un controllo utente con il layout desiderato. Più avanti nella procedura dettagliata tale controllo utente verrà aggiunto al riquadro attività personalizzato.

Per progettare l'interfaccia utente del riquadro attività personalizzato

Scegliere Aggiungi controllo utente dal menu Progetto.
Nella finestra di dialogo Aggiungi nuovo elemento modificare il nome del controllo utente in TaskPaneControl e scegliere Aggiungi.

Il controllo utente verrà visualizzato nella finestra di progettazione.
Trascinare un controllo TextBox sul controllo utente dalla scheda Controlli comuni della Casella degli strumenti.

Creazione del riquadro attività personalizzato

Per creare il riquadro attività personalizzato all'avvio del componente aggiuntivo, aggiungere il controllo utente al riquadro nel gestore eventi Startup del componente aggiuntivo. Per impostazione predefinita, il riquadro attività personalizzato non è visibile. Più avanti nella procedura dettagliata verrà aggiunto il codice che consente dei visualizzare o nascondere il riquadro attività quando l'utente fa clic sull'interruttore aggiunto alla barra multifunzione.

Per creare il riquadro attività personalizzato

In Esplora soluzioni espandere Excel.
Fare clic con il pulsante destro del mouse su ThisAddIn.cs o su ThisAddIn.vb e scegliere Visualizza codice.

Aggiungere il codice seguente alla classe ThisAddIn. Tale codice dichiara un'istanza di TaskPaneControl come membro di ThisAddIn.

Private taskPaneControl1 As TaskPaneControl
Private WithEvents taskPaneValue As Microsoft.Office.Tools.CustomTaskPane

private TaskPaneControl taskPaneControl1;
private Microsoft.Office.Tools.CustomTaskPane taskPaneValue;

Sostituire il gestore eventi ThisAddIn_Startup con il codice riportato di seguito. Questo codice aggiunge l'oggetto TaskPaneControl al campo CustomTaskPanes, ma non visualizza il riquadro attività personalizzato (per impostazione predefinita, la proprietà Visible della classe CustomTaskPane è false). Il codice Visual C# connette anche un gestore eventi all'evento VisibleChanged.

Private Sub ThisAddIn_Startup(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Me.Startup

    taskPaneControl1 = New TaskPaneControl()
    taskPaneValue = Me.CustomTaskPanes.Add( _
        taskPaneControl1, "MyCustomTaskPane")
End Sub

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    taskPaneControl1 = new TaskPaneControl();
    taskPaneValue = this.CustomTaskPanes.Add(
        taskPaneControl1, "MyCustomTaskPane");
    taskPaneValue.VisibleChanged +=
        new EventHandler(taskPaneValue_VisibleChanged);
}

Aggiungere il seguente metodo alla classe ThisAddIn. Questo metodo gestisce l'evento VisibleChanged. Quando l'utente chiude il riquadro attività facendo clic sul pulsante Chiudi (X), questo metodo aggiorna lo stato dell'interruttore sulla barra multifunzione.

Private Sub taskPaneValue_VisibleChanged(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles taskPaneValue.VisibleChanged

    Globals.Ribbons.ManageTaskPaneRibbon.ToggleButton1.Checked = taskPaneValue.Visible
End Sub

private void taskPaneValue_VisibleChanged(object sender, System.EventArgs e)
{
    Globals.Ribbons.ManageTaskPaneRibbon.toggleButton1.Checked = 
        taskPaneValue.Visible;
}

Aggiungere la seguente proprietà alla classe ThisAddIn. Questa proprietà espone l'oggetto myCustomTaskPane1 privato alle altre classi. Più avanti nella procedura dettagliata verrà aggiunto il codice alla classe MyRibbon che utilizza questa proprietà.
```
Public ReadOnly Property TaskPane() As Microsoft.Office.Tools.CustomTaskPane
    Get
        Return taskPaneValue
    End Get
End Property
```
```
public Microsoft.Office.Tools.CustomTaskPane TaskPane
{
    get
    {
        return taskPaneValue;
    }
}
```

Nascondere e visualizzare il riquadro attività personalizzato utilizzando l'interruttore

L'ultimo passaggio consiste nell'aggiungere il codice che visualizza o nasconde il riquadro attività personalizzato quando l'utente fa clic sull'interruttore sulla barra multifunzione.

Per visualizzare e nascondere il riquadro attività personalizzato utilizzando l'interruttore

Nella finestra di progettazione della barra multifunzione, fare doppio clic sull'interruttore Mostra riquadro attività.

Visual Studio Tools per Office genera automaticamente un gestore eventi denominato toggleButton1_Click che gestisce l'evento Click dell'interruttore. Viene aperto il file MyRibbon.cs o MyRibbon.vb nell'editor di codice di Visual Studio Tools per Office.

Sostituire il gestore eventi toggleButton1_Click con il codice riportato di seguito. Quando l'utente fa clic sull'interruttore, il codice visualizza o nasconde il riquadro attività personalizzato a seconda che l'interruttore sia premuto o meno.

Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles ToggleButton1.Click

    Globals.ThisAddIn.TaskPane.Visible = _
        TryCast(sender, Microsoft.Office.Tools.Ribbon.RibbonToggleButton).Checked
End Sub

private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisAddIn.TaskPane.Visible = ((RibbonToggleButton)sender).Checked;
}

Verifica del componente aggiuntivo

Quando si esegue il progetto, Excel viene aperto senza visualizzare il riquadro attività personalizzato. Fare clic sull'interruttore nella barra multifunzione per testare il codice.

Per verificare il componente aggiuntivo

Premere F5 per eseguire il progetto.

Verificare che Excel sia aperto e la scheda Componenti aggiuntivi sia visualizzata sulla barra multifunzione.
Fare clic sulla scheda Componenti aggiuntivi sulla barra multifunzione.
Nel gruppo Gestione riquadro attività, fare clic sull'interruttore Mostra riquadro attività.

Verificare che il riquadro attività venga in alternanza visualizzato e nascosto quando si fa clic sull'interruttore.
Quando il riquadro attività è visibile, fare clic sul pulsanteChiudi (X) nell'angolo del riquadro attività.

Verificare che l'interruttore non sia premuto.

Passaggi successivi

È possibile trovare ulteriori informazioni sulla creazione di riquadri attività personalizzati nei seguenti argomenti:

Creare un riquadro attività personalizzato in un componente aggiuntivo per un'applicazione differente nella versione 2007 di Microsoft Office. Per ulteriori informazioni sulle applicazioni che supportano i riquadri attività personalizzati, vedere Cenni preliminari sui riquadri attività personalizzati.
Automatizzare un'applicazione da un riquadro attività personalizzato. Per ulteriori informazioni, vedere Procedura dettagliata: automazione di un'applicazione da un riquadro attività personalizzato.
Creare un riquadro attività personalizzato per ogni messaggio di posta elettronica aperto in Outlook. Per ulteriori informazioni, vedere la classe Procedura dettagliata: visualizzazione dei riquadri attività personalizzati con messaggi di posta elettronica in Outlook.