Condividi tramite


Accesso alla barra multifunzione in fase di esecuzione

È possibile scrivere codice per mostrare, nascondere o modificare la barra multifunzione e consentire agli utenti di eseguire il codice dai controlli in un riquadro attività personalizzato, un riquadro azioni o un'area di modulo di Outlook.

È possibile accedere alla barra multifunzione utilizzando la classe Globals. Per i progetti di Outlook, è possibile accedere alle barre multifunzione che vengono visualizzate in una specifica finestra di controllo o di esplorazione di Outlook.

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.

Accesso alla barra multifunzione utilizzando la classe Globals

È possibile utilizzare la classe Globals per accedere alla barra multifunzione in un progetto a livello di documento o a livello di applicazione da qualsiasi punto nel progetto.

Per ulteriori informazioni sulla classe Globals, vedere Accesso globale a oggetti nei progetti di Office.

Nell'esempio seguente è utilizzata la classe Globals per accedere a una barra multifunzione personalizzata denominata Ribbon1 e impostare il testo che viene visualizzato in una casella combinata della barra multifunzione su Hello World.

Private Sub Access_All_Ribbons_Globals()
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World"
End Sub
private void Access_All_Ribbons_Globals()
{
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World";
}

Accesso a un insieme di barre multifunzione visualizzate in una specifica finestra di controllo di Outlook

È possibile accedere a un insieme di barre multifunzione che vengono visualizzate nei controlli di Outlook. Un controllo rappresenta una finestra che viene aperta in Outlook quando gli utenti eseguono determinate attività, ad esempio la creazione di messaggi di posta elettronica. Per accedere alla barra multifunzione di una finestra di controllo, chiamare la proprietà Ribbons della classe Globals e passare un oggetto Inspector che rappresenta il controllo.

Nell'esempio riportato di seguito viene recuperato l'insieme della barra multifunzione del controllo che ha attualmente lo stato attivo. Viene quindi effettuato l'accesso a una barra multifunzione denominata Ribbon1 e impostato il testo che viene visualizzato in una casella di testo della barra multifunzione su Hello World.

Private Sub Access_Ribbons_By_Inspector()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveInspector())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Inspector()
{
    ThisRibbonCollection ribbonCollection = 
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveInspector()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Accesso a un insieme di barre multifunzione visualizzate per una specifica finestra di esplorazione di Outlook

È possibile accedere a un insieme di barre multifunzione che vengono visualizzate in una finestra di esplorazione di Outlook. Una finestra di esplorazione è la principale interfaccia utente dell'applicazione per un'istanza di Outlook. Per accedere alla barra multifunzione di una finestra di esplorazione, chiamare la proprietà Ribbons della classe Globals e passare un oggetto Explorer che rappresenta la finestra di esplorazione.

Nell'esempio riportato di seguito viene recuperato l'insieme di barre multifunzione della finestra di esplorazione che ha attualmente lo stato attivo. Viene quindi effettuato l'accesso a una barra multifunzione denominata Ribbon1 e impostato il testo che viene visualizzato in una casella di testo della barra multifunzione su Hello World.

Private Sub Access_Ribbons_By_Explorer()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveExplorer())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Vedere anche

Attività

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

Procedura dettagliata: aggiornamento dei controlli di una barra multifunzione in fase di esecuzione

Concetti

Finestra di progettazione della barra multifunzione

Elemento XML della barra multifunzione

Cenni preliminari sul modello a oggetti della barra multifunzione

Personalizzazione di una barra multifunzione per Outlook

Accesso a un'area del modulo in fase di esecuzione

Altre risorse

Cenni preliminari sulla barra multifunzione