Condividi tramite


Procedura dettagliata: Creare una scheda personalizzata usando Progettazione barra multifunzione

Usando la finestra di progettazione della barra multifunzione è possibile creare una scheda personalizzata per aggiungervi e posizionarvi controlli.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento per Excel. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

In questa procedura dettagliata sono illustrati i task seguenti:

Nota

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, è necessario disporre dei componenti seguenti:

Creare un progetto di cartella di lavoro di Excel

I passaggi per l'utilizzo della finestra di progettazione della barra multifunzione sono quasi identici per tutte le applicazioni Office. In questo esempio viene usata una cartella di lavoro di Excel.

Per creare un progetto cartella di lavoro di Excel

  • Creare un progetto di cartella di lavoro di Excel con il nome MyExcelRibbon. Per altre informazioni, vedere How to: Create Office Projects in Visual Studio.

    Visual Studio apre la nuova cartella di lavoro nella finestra di progettazione e aggiunge il progetto MyExcelRibbon a Esplora soluzioni.

Creare riquadri azioni

Aggiungere due riquadri azioni personalizzati al progetto. Successivamente si aggiungeranno alcuni pulsanti che mostrano e nascondono questi riquadri azioni alla scheda personalizzata.

Per creare i riquadri azioni

  1. Scegliere Aggiungi nuovo elemento dal menu Progetto.

  2. Nella finestra di dialogo Aggiungi nuovo elemento selezionare ActionsPaneControl e quindi scegliere Aggiungi.

    Il file ActionsPaneControl1.cs o ActionsPaneControl1.vb viene aperto nella finestra di progettazione.

  3. Nella scheda Controlli comuni della casella degli strumenti aggiungere un'etichetta all'area di progettazione.

  4. Nella finestra Proprietà impostare la proprietà Text di label1 su Riquadro azioni 1.

  5. Ripetere i passaggi da 1 a 5 per creare un secondo riquadro azioni e una seconda etichetta. Impostare la proprietà Text della seconda etichetta su Riquadro azioni 2.

Creare una scheda personalizzata

Per la progettazione di applicazioni di Office, è necessario che gli utenti abbiano sempre il controllo dell'interfaccia utente dell'applicazione di Office. Per aggiungere questa funzionalità relativa ai riquadri azioni, è possibile aggiungere pulsanti che mostrano e nascondono ciascun riquadro azioni da una scheda personalizzata della barra multifunzione. Per creare una scheda personalizzata, aggiungere un elemento della barra multifunzione (Progettazione visiva) al progetto. La finestra di progettazione consente di aggiungere e posizionare controlli, impostarne le proprietà e gestirne gli eventi.

Per creare una scheda personalizzata

  1. Scegliere Aggiungi nuovo elemento dal menu Progetto.

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

  3. Modificare il nome della nuova barra multifunzione in MyRibbon e scegliere Aggiungi.

    Nella finestra di progettazione della barra multifunzione viene aperto un file MyRibbon.cs o MyRibbon.vb , che visualizza una scheda e un gruppo predefiniti.

  4. Nella finestra di progettazione della barra multifunzione scegliere la scheda predefinita.

  5. Nella finestra Proprietà espandere la proprietà ControlId e quindi impostare la proprietà ControlIdType su Custom.

  6. Impostare la proprietà Label su Scheda Personalizzata.

  7. Nella finestra di progettazione della barra multifunzione scegliere group1.

  8. Nella finestra Proprietà impostare Etichetta su Gestione riquadro azioni.

  9. Nella scheda Controlli barra multifunzione di Office della Casella degli strumenti trascinare un pulsante in group1.

  10. Selezionare button1.

  11. Nella finestra Proprietà impostare Etichetta su Mostra riquadro azioni 1.

  12. Aggiungere un secondo pulsante a group1 e impostare la proprietà Label su Mostra riquadro azioni 2.

  13. Dalla scheda Controlli della barra multifunzione di Office della Casella degli strumenti trascinare un controllo ToggleButton in group1.

  14. Impostare la proprietà Label su Nascondi riquadro azioni.

Nascondere e visualizzare i riquadri azioni usando i pulsanti nella scheda personalizzata

L'ultimo passaggio consiste nell'aggiungere codice che risponde all'utente. Aggiungere gestori eventi per gli eventi Click dei due pulsanti e per l'evento Click dell'interruttore. Aggiungere codice a questi gestori eventi per abilitare e disabilitare la visualizzazione dei riquadri azioni.

Per nascondere e mostrare i riquadri azioni mediante i pulsanti della scheda personalizzata

  1. In Esplora soluzioni aprire il menu di scelta rapida per MyRibbon.cs o MyRibbon.vb e quindi scegliere Visualizza codice.

  2. Aggiungere il codice riportato di seguito all'inizio della classe MyRibbon. Mediante questo codice vengono creati due oggetti riquadro azioni.

    ActionsPaneControl1 actionsPane1 = new ActionsPaneControl1();
    ActionsPaneControl2 actionsPane2 = new ActionsPaneControl2();
    
  3. Sostituire il metodo MyRibbon_Load con il codice seguente. Mediante questo codice vengono aggiunti alla raccolta Controls oggetti riquadro azioni, che vengono nascosti. Il codice Visual C# associa inoltre delegati a vari eventi del controllo della barra multifunzione.

    private void MyRibbon_Load(object sender, RibbonUIEventArgs e)
    {
        Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1);
        Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2);
        actionsPane1.Hide();
        actionsPane2.Hide();
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
    
        this.button1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
            this.button1_Click);
        this.button2.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
            this.button2_Click);
        this.toggleButton1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
            this.toggleButton1_Click);
    
    
    }
    
  4. Aggiungere i tre metodi per la gestione eventi riportati di seguito alla classe MyRibbon. Questi metodi gestiscono gli eventi Click dei due pulsanti e l'evento Click dell'interruttore. I gestori eventi per button1 e button2 mostrano riquadri azioni alternativi. Il gestore eventi per toggleButton1 mostra e nasconde il riquadro azioni attivo.

    private void button1_Click(object sender, RibbonControlEventArgs e)
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
        actionsPane2.Hide();
        actionsPane1.Show();
        toggleButton1.Checked = false;
    }
    
    private void button2_Click(object sender, RibbonControlEventArgs e)
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
        actionsPane1.Hide();
        actionsPane2.Show();
        toggleButton1.Checked = false;
    
    }
    
    private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
    {
        if (toggleButton1.Checked == true)
        {
            Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
        }
        else
        {
            Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
        }
    
    }
    

Testare la scheda personalizzata

Quando si esegue il progetto, Viene avviata excel e la scheda Scheda Personalizzata viene visualizzata sulla barra multifunzione. Scegliere i pulsanti nella scheda Personalizzata per visualizzare e nascondere i riquadri azioni.

Per verificare la scheda personalizzata

  1. Premere F5 per eseguire il progetto.

  2. Scegliere la scheda My Custom (Scheda personalizzata personale).

  3. Nel gruppo Gestione riquadro azioni personalizzate scegliere Mostra riquadro azioni 1.

    Viene visualizzato il riquadro azioni e viene visualizzata l'etichetta Riquadro azioni 1.

  4. Scegliere Mostra riquadro azioni 2.

    Viene visualizzato il riquadro azioni e viene visualizzata l'etichetta Riquadro azioni 2.

  5. Scegliere Nascondi riquadro azioni.

    I riquadri azioni non sono più visibili.

Passaggi successivi

È possibile trovare ulteriori informazioni sulla personalizzazione dell'interfaccia utente di Office nei seguenti argomenti:

  • Aggiunta di un'interfaccia utente basata sul contesto a una personalizzazione a livello di documento. Per altre informazioni, vedere Panoramica del riquadro Azioni.

  • Estensione di un modulo standard o personalizzato di Microsoft Office Outlook. Per altre informazioni, vedere Procedura dettagliata: Progettare un'area del modulo di Outlook.