Procedura dettagliata: creazione di una scheda personalizzata utilizzando la finestra di progettazione della barra multifunzione

In questa procedura dettagliata viene illustrato come creare una scheda personalizzata della barra multifunzione utilizzando la finestra di progettazione della barra multifunzione. Questa finestra di progettazione può essere utilizzata per aggiungere e posizionare controlli sulla scheda personalizzata.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento e di applicazione per Excel 2007, Excel 2010, InfoPath 2010, Outlook 2007, Outlook 2010, PowerPoint 2007, PowerPoint 2010, Project 2010, Visio 2010, Word 2007 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

In questa procedura dettagliata vengono illustrate le seguenti attività:

• Creazione dei riquadri azioni.

• Creazione di una scheda personalizzata.

• Attivazione e disattivazione della visualizzazione dei riquadri azioni mediante i pulsanti della scheda personalizzata.

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 Gestione delle impostazioni.

Prerequisiti

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

-

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

• Microsoft Office Excel 2007 o Excel 2010. 

Per una versione video di questo argomento, vedere Video How to: Creating a Custom Tab by Using the Ribbon Designer (la pagina potrebbe essere in inglese). Per una dimostrazione video correlata, vedere la procedura relativa all'utilizzo della finestra di progettazione per personalizzare la barra multifunzione in Excel.

Creazione di un progetto 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 utilizzata una cartella di lavoro di Excel.

Per creare un progetto cartella di lavoro di Excel

• Creare un progetto cartella di lavoro di Excel con il nome MyExcelRibbon. Per ulteriori informazioni, vedere Procedura: creare progetti di Office in Visual Studio.

  In Visual Studio la nuova cartella di lavoro viene aperta nella finestra di progettazione e il progetto MyExcelRibbon viene aggiunto a Esplora soluzioni.

Creazione dei riquadri azioni

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

Per creare i riquadri azioni

1. Scegliere Aggiungi nuovo elemento dal menu Progetto.

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

   Nella finestra di progettazione viene aperto il file ActionsPaneControl1.cs o ActionsPaneControl1.vb.

3. Dalla 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 Actions Pane 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 Actions Pane 2.

Creazione di una scheda personalizzata

Per la progettazione di applicazioni Office, è necessario che gli utenti abbiano sempre il controllo dell'interfaccia utente dell'applicazione 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 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 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 dell'elemento in MyRibbon, quindi fare clic su 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, fare clic sulla scheda predefinita.

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

6. Impostare la proprietà ControlId su My Custom Tab.

7. Fare clic su group1 nella finestra di progettazione della barra multifunzione.

8. Nella finestra Proprietà impostare Label su Actions Pane Manager.

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

10. Fare clic su button1 per selezionare questa opzione.

11. Nella finestra Proprietà impostare Label su Show Actions Pane 1.

12. Aggiungere un secondo pulsante a group1, quindi impostare la proprietà Label su Show Actions Pane 2.

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

14. Impostare la proprietà Label su Hide Actions Pane.

Attivazione e disattivazione della visualizzazione dei riquadri azioni mediante i pulsanti della 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 che nascondono e mostrano i riquadri azioni.

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

1. In Esplora soluzioni fare clic con il pulsante destro del mouse su MyRibbon.cs o MyRibbon.vb, 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.

   Dim actionsPane1 As New ActionsPaneControl1()
   Dim actionsPane2 As New ActionsPaneControl2()
   

   ActionsPaneControl1 actionsPane1 = new ActionsPaneControl1();
   ActionsPaneControl2 actionsPane2 = new ActionsPaneControl2();
   

3. Sostituire il metodo MyRibbon_Load con il codice seguente. Mediante questo codice vengono aggiunti all'insieme ActionsPane.Controls oggetti riquadro azioni, che vengono nascosti. Il codice Visual C# associa inoltre delegati a vari eventi del controllo della barra multifunzione.

   Private Sub MyRibbon_Load(ByVal sender As System.Object, ByVal e As RibbonUIEventArgs) Handles MyBase.Load
       Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1)
       Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2)
       actionsPane1.Hide()
       actionsPane2.Hide()
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
   End Sub
   

   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;
   
       // Use the following code in projects that target the .NET Framework 4.
       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);
   
       // For .NET Framework 3.5 projects, use the following code instead.
       // this.button1.Click += new EventHandler<RibbonControlEventArgs>(button1_Click);
       // this.button2.Click += new EventHandler<RibbonControlEventArgs>(button2_Click);
       // this.toggleButton1.Click += new EventHandler<RibbonControlEventArgs>(toggleButton1_Click);
   }
   

   Per ulteriori informazioni sulle differenze nell'esempio di codice Visual C# per progetti destinati a .NET Framework 4 e .NET Framework 3.5, vedere Aggiornamento delle personalizzazioni della barra multifunzione nei progetti di Office di cui si esegue la migrazione a .NET Framework 4.

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 Sub Button1_Click(ByVal sender As System.Object, _
       ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
           Handles Button1.Click
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
       actionsPane2.Hide()
       actionsPane1.Show()
       ToggleButton1.Checked = False
   End Sub
   
   Private Sub Button2_Click(ByVal sender As System.Object, _
       ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
           Handles Button2.Click
   
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
       actionsPane1.Hide()
       actionsPane2.Show()
       ToggleButton1.Checked = False
   
   End Sub
   
   
   Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
       ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
           Handles ToggleButton1.Click
   
       If ToggleButton1.Checked Then
           Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
       Else
           Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
       End If
   
   End Sub
   

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

Verifica della scheda personalizzata

Quando si esegue il progetto, viene avviato Excel e sulla barra multifunzione viene visualizzata la scheda My Custom Tab. Fare clic sui pulsanti di My Custom Tab per mostrare e nascondere i riquadri azioni.

Per verificare la scheda personalizzata

1. Premere F5 per eseguire il progetto.

2. Fare clic sulla scheda My Custom Tab.

3. Nel gruppo Custom Actions Pane Manager fare clic su Show Actions Pane 1.

   Viene visualizzato il riquadro azioni con l'etichetta Actions Pane 1.

4. Fare clic su Show Actions Pane 2.

   Viene visualizzato il riquadro azioni con l'etichetta Actions Pane 2.

5. Fare clic su Hide Actions Pane.

   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 ulteriori informazioni, vedere Cenni preliminari sul riquadro delle azioni.

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

Vedere anche

Attività

Procedura: iniziare a personalizzare la barra multifunzione

Procedura: modificare la posizione di una scheda nella barra multifunzione

Procedura: personalizzare una scheda incorporata

Procedura: personalizzare il menu Microsoft Office

Concetti

Accesso alla barra multifunzione in fase di esecuzione

Finestra di progettazione della barra multifunzione

Personalizzazione di una barra multifunzione per Outlook

Cenni preliminari sul modello a oggetti della barra multifunzione

Altre risorse

Cenni preliminari sulla barra multifunzione

Cronologia delle modifiche

Data	Cronologia	Motivo
Settembre 2010	Aggiunto esempio di codice di .NET Framework 3.5.	Correzione di bug nel contenuto.
Settembre 2010	Aggiunti passaggi per assicurare che la procedura guidata consenta di creare una scheda personalizzata. Prima di questa modifica, erano presenti controlli solo nella scheda Componenti aggiuntivi.	Correzione di bug nel contenuto.