RibbonFactory.CreateRibbonManager(IRibbonExtension[]) Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Ribbon

Assemblys:: Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée un objet IRibbonExtensibility qui représente une personnalisation de ruban.

public:
 Microsoft::Office::Core::IRibbonExtensibility ^ CreateRibbonManager(cli::array <Microsoft::Office::Tools::Ribbon::IRibbonExtension ^> ^ ribbons);

public Microsoft.Office.Core.IRibbonExtensibility CreateRibbonManager (Microsoft.Office.Tools.Ribbon.IRibbonExtension[] ribbons);

abstract member CreateRibbonManager : Microsoft.Office.Tools.Ribbon.IRibbonExtension[] -> Microsoft.Office.Core.IRibbonExtensibility

Public Function CreateRibbonManager (ribbons As IRibbonExtension()) As IRibbonExtensibility

Paramètres

ribbons: IRibbonExtension[]

Tableau d’instances IRibbonExtension.

Retours

IRibbonExtensibility

Objet représentant une personnalisation de ruban.

Exemples

L’exemple suivant utilise une condition pour déterminer le ruban personnalisé à afficher. Cet exemple utilise ensuite la CreateRibbonManager méthode pour créer et retourner un IRibbonExtension objet qui représente le ruban personnalisé.

Notes

La syntaxe utilisée dans cet exemple retourne un ruban qui a été créé à l’aide de l’élément Ribbon (Visual Designer). La syntaxe de renvoi d’un ruban créé à l’aide d’un élément de ruban (XML) est légèrement différente. Pour plus d'informations sur le retour d'un élément Ruban (XML), consultez Ruban XML.

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

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

Remarques

Retourne l’objet IRibbonExtensibility dans la CreateRibbonExtensibilityObject méthode de la ThisAddinclasse , ThisWorkbookou ThisDocument de votre projet pour renvoyer le ruban que vous souhaitez afficher dans l’application Office.

S’applique à

Partager via