Procedura dettagliata: creazione di una scheda personalizzata utilizzando la finestra di progettazione della 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 versioni di Microsoft Office specificati. Tipo di progetto Progetti a livello di documento Progetti a livello di applicazione Versione Microsoft Office Excel 2007 Word 2007 Outlook 2007 PowerPoint 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 versioni di Microsoft Office specificati.

Tipo di progetto

Progetti a livello di documento
Progetti a livello di applicazione

Versione Microsoft Office

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

In questa procedura dettagliata vengono illustrate le attività seguenti:

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 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.

Per una dimostrazione video, vedere Video How to: Creating a Custom Tab by Using the Ribbon Designer.

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 2007 con il nome MyExcelRibbon. Per ulteriori informazioni, vedere la classe Procedura: creare progetti Visual Studio Tools per Office.

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

Scegliere Aggiungi nuovo elemento dal menu Progetto.
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.
Dalla scheda Controlli comuni della Casella degli strumenti aggiungere un'etichetta all'area di progettazione.
Nella finestra Proprietà impostare la proprietà Text di label1 su Actions Pane 1.
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

Scegliere Aggiungi nuovo elemento dal menu Progetto.
Nella finestra di dialogo Aggiungi nuovo elemento selezionare Barra multifunzione (finestra di progettazione visiva).
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.
Fare clic su group1 nella finestra di progettazione della barra multifunzione.
Nella finestra Proprietà impostare Label su Actions Pane Manager.
Dalla scheda Controlli barra multifunzione di Office della Casella degli strumenti trascinare un pulsante in group1.
Fare clic su button1 per selezionare questa opzione.
Nella finestra Proprietà impostare Label su Show Actions Pane 1.
Aggiungere un secondo pulsante a group1, quindi impostare la proprietà Label su Show Actions Pane 2.
Dalla scheda Controlli barra multifunzione di Office della Casella degli strumenti trascinare un controllo ToggleButton in group1.
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

In Esplora soluzioni fare clic con il pulsante destro del mouse su MyRibbon.cs o MyRibbon.vb, quindi scegliere Visualizza codice.

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();

In C# è necessario aggiungere i gestori eventi riportati di seguito al costruttore. Per ulteriori informazioni sulla creazione di gestori eventi, vedere Procedura: creare gestori eventi in Visual Studio Tools per Office.

this.button1.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.button1_Click);
this.button2.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.button2_Click);
this.toggleButton1.Click += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>
        (this.toggleButton1_Click);
this.Load += new System.EventHandler
    <Microsoft.Office.Tools.Ribbon.RibbonUIEventArgs>
        (this.MyRibbon_Load);

Aggiungere il codice riportato di seguito all'evento MyRibbon_Load. Mediante questo codice vengono aggiunti all'insieme Microsoft.Office.Tools.ActionsPane.Controls del riquadro azioni gli oggetti riquadro azioni, che vengono nascosti.

Private Sub MyRibbon_Load(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.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;
}

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()
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()

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

private void button2_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane1.Hide();
    actionsPane2.Show();

}

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

}

Test della scheda personalizzata

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

Per testare la scheda personalizzata

Premere F5 per eseguire il progetto.
Fare clic sulla scheda Componenti aggiuntivi.
Nel gruppo Custom Actions Pane Manager fare clic su Show Actions Pane 1.

Viene visualizzato il riquadro azioni con l'etichetta Actions Pane 1.
Fare clic su Show Actions Pane 2.

Viene visualizzato il riquadro azioni con l'etichetta Actions Pane 2.
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 la classe Procedura dettagliata: progettazione di un'area di modulo di Outlook.