Accesso alla barra multifunzione in fase di esecuzione

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.

È 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 Outlook, è possibile accedere alle barre multifunzione che sono visualizzate in specifiche finestre di controllo di Outlook.

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 agli oggetti nei progetti Visual Studio Tools per 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 in 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";
}