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

Articolo
02/19/2013

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 2013, Excel 2010, InfoPath 2013, InfoPath 2010, Outlook 2013, Outlook 2010, PowerPoint 2013, PowerPoint 2010, Project 2013, Project 2010, Visio 2013, Visio 2010, Word 2013, 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 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.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).

Excel 2010 o Excel 2013.

Collegamento a video 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.

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

Creazione dei riquadri azioni

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

Per creare i riquadri azioni

Scegliere Aggiungi nuovo elemento dal menu Progetto.
Nella finestra di dialogo Aggiungi nuovo elemento, ActionsPaneControlquindi 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à per i 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 della nuova barra multifunzione a MyRibbone 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.
Nella finestra di progettazione della barra multifunzione, scegliere la scheda predefinita.
Nella finestra Proprietà espandere la proprietà ControlId, quindi impostare la proprietà ControlIdType su Custom.
Impostare la proprietà ControlId su My Custom Tab.
Nella finestra di progettazione della barra multifunzione, scegliere group1.
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.
Selezionare button1.
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 per abilitare nascondere o visualizzare i riquadri azioni.

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

In Esplora soluzioni, aprire il menu di scelta rapida per 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();

Sostituire il metodo MyRibbon_Load con il codice seguente.Mediante questo codice vengono aggiunti alla raccolta 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 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;

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


}

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 e la scheda Scheda Personalizza viene visualizzato nella barra multifunzione.Selezionare i pulsanti Scheda Personalizza per mostrare e nascondere i riquadri azioni.

Per verificare la scheda personalizzata

Premere F5 per eseguire il progetto.
Scegliere la scheda Scheda Personalizza.
Nel gruppo Amministratore del riquadro delle azioni personalizzate, scegliere Mostra riquadro azioni 1.

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

Viene visualizzato il riquadro azioni con l'etichetta Actions Pane 2.
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 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

Condividi tramite