Condividi tramite

Procedura dettagliata: Sincronizzare un riquadro attività personalizzato con un pulsante del Ribbon

Questa procedura dettagliata illustra come creare un riquadro attività personalizzato che gli utenti possono nascondere o visualizzare facendo clic su un pulsante di attivazione/disattivazione sulla barra multifunzione. È consigliabile creare sempre un elemento dell'interfaccia utente, ad esempio un pulsante, che gli utenti possono fare clic per visualizzare o nascondere il riquadro attività personalizzato, perché le applicazioni di Microsoft Office non forniscono un modo predefinito per consentire agli utenti di visualizzare o nascondere riquadri attività personalizzati.

Si applica a: Le informazioni contenute in questo argomento si applicano ai progetti di componente aggiuntivo VSTO per Outlook. Per altre informazioni, vedere Funzionalità disponibili per l'applicazione e il tipo di progetto di Office.

Anche se questa procedura dettagliata usa Excel in modo specifico, i concetti illustrati nella procedura dettagliata sono applicabili a tutte le applicazioni elencate in precedenza.

In questa procedura dettagliata sono illustrati i task seguenti:

  • Progettazione dell'interfaccia utente del riquadro attività personalizzato.

  • Aggiunta di un pulsante di attivazione/disattivazione alla barra multifunzione.

  • Sincronizzare il pulsante di attivazione con il riquadro attività personalizzato.

Annotazioni

I nomi o i percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni, vedere Personalizzare l'IDE di Visual Studio.

Prerequisiti

Per completare questa procedura dettagliata sono necessari i componenti seguenti:

Creare il progetto di componente aggiuntivo

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

Per creare un nuovo progetto

  1. Creare un progetto di componente aggiuntivo di Excel con il nome SynchronizeTaskPaneAndRibbon usando il modello di progetto componente aggiuntivo di Excel. Per altre informazioni, vedere Procedura: Creare progetti di Office in Visual Studio.

    Visual Studio apre il file di codice ThisAddIn.cs o ThisAddIn.vb e aggiunge il progetto SynchronizeTaskPaneAndRibbon a Esplora soluzioni.

Aggiungere un pulsante di attivazione/disattivazione alla barra multifunzione

Una delle linee guida per la progettazione di applicazioni di Office è che gli utenti devono sempre avere il controllo dell'interfaccia utente dell'applicazione di Office. Per consentire agli utenti di controllare il riquadro attività personalizzato, è possibile aggiungere un interruttore della barra multifunzione che mostra e nasconde il riquadro attività. Per creare un pulsante di attivazione/disattivazione, aggiungere un elemento della barra multifunzione (Progettazione visiva) al progetto. La finestra di progettazione consente di aggiungere e posizionare controlli, impostare le proprietà del controllo e gestire gli eventi di controllo. Per altre informazioni, vedere Ribbon Designer.

Per aggiungere un interruttore alla barra multifunzione

  1. Scegliere Aggiungi nuovo elemento dal menu Progetto.

  2. Nella finestra di dialogo Aggiungi nuovo elemento selezionare Barra multifunzione (Progettazione visiva).

  3. Modificare il nome della nuova barra multifunzione in ManageTaskPaneRibbon e fare clic su Aggiungi.

    Il file ManageTaskPaneRibbon.cs o ManageTaskPaneRibbon.vb viene aperto nella finestra di progettazione della barra multifunzione e visualizza una scheda e un gruppo predefiniti.

  4. Nel progettista della barra multifunzione, fare clic su group1.

  5. Nella finestra Proprietà impostare la proprietà Label su Gestione riquadro attività.

  6. Dalla scheda Controlli della barra multifunzione di Office della Casella degli strumenti, trascina un ToggleButton nel gruppo Gestione riquadro attività.

  7. Fare clic su ToggleButton1.

  8. Nella finestra Proprietà impostare la proprietà Etichetta su Mostra riquadro attività.

Progettare l'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 in questa procedura dettagliata si aggiungerà il controllo utente al riquadro attività personalizzato.

Per progettare l'interfaccia utente del riquadro attività personalizzato

  1. Scegliere Aggiungi controllo utente dal menu Progetto.

  2. Nella finestra di dialogo Aggiungi nuovo elemento modificare il nome del controllo utente in TaskPaneControl e fare clic su Aggiungi.

    Il controllo utente viene aperto nella finestra di progettazione.

  3. Dalla scheda Controlli comuni della casella degli strumenti trascinare un controllo TextBox nel controllo utente.

Creare il riquadro attività personalizzato

Per creare il riquadro attività personalizzato all'avvio del componente aggiuntivo VSTO, aggiungere il controllo utente al riquadro attività nel Startup gestore eventi del componente aggiuntivo VSTO. Per impostazione predefinita, il riquadro attività personalizzato non sarà visibile. Più avanti in questa procedura dettagliata si aggiungerà il codice che visualizzerà o nasconderà il riquadro attività quando l'utente fa clic sul pulsante di attivazione/disattivazione aggiunto alla barra multifunzione.

Per creare il riquadro attività personalizzato

  1. In Esplora soluzioni, espandere Excel.

  2. Fare clic con il pulsante destro del mouse su ThisAddIn.cs o ThisAddIn.vb e scegliere Visualizza codice.

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

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

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

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

  5. 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 del pulsante di attivazione/disattivazione sulla barra multifunzione.

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

  6. Aggiungere la proprietà seguente alla ThisAddIn classe . Questa proprietà espone l'oggetto privato taskPaneValue ad altre classi. Più avanti in questa procedura dettagliata si aggiungerà codice MyRibbon alla classe che usa questa proprietà.

    public Microsoft.Office.Tools.CustomTaskPane TaskPane
{
    get
    {
        return taskPaneValue;
    }
}

Nascondere e visualizzare il riquadro attività personalizzato usando il pulsante di attivazione/disattivazione

L'ultimo passaggio consiste nell'aggiungere 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 usando il pulsante di attivazione/disattivazione

  1. Nella Progettazione della barra multifunzione, fare doppio clic sul pulsante Mostra riquadro attività.

    Visual Studio genera automaticamente un gestore eventi denominato toggleButton1_Click, che gestisce l'evento dell'interruttore Click . Visual Studio apre anche il file MyRibbon.cs o MyRibbon.vb nell'editor di codice.

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

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

Testare il componente aggiuntivo

Quando si esegue il progetto, Excel viene aperto senza visualizzare il riquadro attività personalizzato. Fare clic sul pulsante toggle sulla barra multifunzione per testare il codice.

Per testare il componente aggiuntivo VSTO

  1. Premere F5 per eseguire il progetto.

    Verificare che Excel venga aperto e che la scheda Componenti aggiuntivi venga visualizzata sulla barra multifunzione.

  2. Fare clic sulla scheda Componenti aggiuntivi sulla barra multifunzione.

  3. Nel gruppo Gestione riquadro attività fare clic sull'interruttore Mostra riquadro attività .

    Verificare che il riquadro attività venga visualizzato e nascosto in alternativa quando si fa clic sul pulsante di attivazione/disattivazione.

  4. Quando il riquadro attività è visibile, fare clic sul pulsante Chiudi (X) nell'angolo del riquadro attività.

    Verificare che il pulsante sembri non essere premuto.

Passaggi successivi

Per altre informazioni su come creare riquadri attività personalizzati, vedere gli argomenti seguenti:

Contenuti correlati

  • Last updated on