Metodo RibbonFactory.CreateRibbonManager

Articolo
08/11/2011

Crea un oggetto IRibbonExtensibility che rappresenta una personalizzazione della Barra multifunzione.

Spazio dei nomi: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Sintassi

'Dichiarazione
Function CreateRibbonManager ( _
    ribbons As IRibbonExtension() _
) As IRibbonExtensibility

IRibbonExtensibility CreateRibbonManager(
    IRibbonExtension[] ribbons
)

Parametri

ribbons
Tipo: array<Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
Matrice di istanze di IRibbonExtension.

Valore restituito

Tipo: Microsoft.Office.Core.IRibbonExtensibility
Oggetto che rappresenta una personalizzazione della Barra multifunzione.

Note

Restituire l'oggetto IRibbonExtensibility nel metodo CreateRibbonExtensibilityObject della classe ThisAddin, ThisWorkbook o ThisDocument del progetto al fine di restituire la barra multifunzione da visualizzare nell'applicazione di Office.

Esempi

Nell'esempio riportato di seguito viene utilizzata una condizione per determinare quale barra multifunzione personalizzata visualizzare. In questo esempio viene utilizzato quindi il metodo CreateRibbonManager per creare e restituire quindi un oggetto IRibbonExtension che rappresenta la Barra multifunzione personalizzata.

Nota

La sintassi utilizzata in questo esempio restituisce una barra multifunzione creata mediante l'elemento Barra multifunzione (finestra di progettazione visiva). La sintassi per la restituzione di una barra multifunzione creata mediante un elemento Barra multifunzione (XML) è leggermente diversa. Per ulteriori informazioni sulla restituzione di un elemento Barra multifunzione (XML), vedere Elemento XML della barra multifunzione.

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
    If myCondition = True Then
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon1()})
    Else
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon2()})
    End If
End Function

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon1() });
        }
        else
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon2() });
        }
    }

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

RibbonFactory Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Ribbon

Condividi tramite