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

Articolo
02/19/2013

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.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di applicazione per Outlook 2013 e Outlook 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

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.Questi elementi sono determinati dall'edizione di Visual Studio in uso e dalle impostazioni utilizzate.Per ulteriori informazioni, vedere Impostazioni di Visual Studio.

Prerequisiti

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

Una versione di Visual Studio 2012 che include gli strumenti per sviluppatori di Microsoft Office. Per ulteriori informazioni, vedere [Configurazione di un computer per sviluppare soluzioni Office](bb398242\(v=vs.110\).md).

Microsoft Excel 2010 o Microsoft Excel 2013.

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 per un componente aggiuntivo per Excel con il nome SynchronizeTaskPaneAndRibbon, utilizzando il modello di progetto per componente aggiuntivo di Excel.Per ulteriori informazioni, vedere Procedura: creare progetti di Office in Visual Studio.

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 Office, è necessario che gli utenti abbiano sempre il controllo dell'interfaccia utente dell'applicazione 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 controlli, impostarne le proprietà e gestirne gli eventi.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à Label 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à Label 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 nel 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à.

In Visual Studio viene automaticamente generato un gestore eventi denominato toggleButton1_Click che gestisce l'evento Click dell'interruttore.In Visual Studio viene inoltre aperto il file MyRibbon.cs o MyRibbon.vb nell'editor del codice.

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;
}

Test 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

Gli argomenti elencati di seguito contengono ulteriori informazioni sulla creazione di riquadri attività personalizzati:

Creare un riquadro attività personalizzato in un componente aggiuntivo per un'applicazione diversa.Per ulteriori informazioni sulle applicazioni che supportano i riquadri attività personalizzati, vedere 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 Procedura dettagliata: visualizzazione dei riquadri attività personalizzati con messaggi di posta elettronica in Outlook.