Partager via


DocumentBase.CreateRibbonExtensibilityObject Méthode

Définition

Retourne un objet qui implémente l’interface Microsoft.Office.Core.IRibbonExtensibility.

protected:
 virtual Microsoft::Office::Core::IRibbonExtensibility ^ CreateRibbonExtensibilityObject();
protected virtual Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject ();
abstract member CreateRibbonExtensibilityObject : unit -> Microsoft.Office.Core.IRibbonExtensibility
override this.CreateRibbonExtensibilityObject : unit -> Microsoft.Office.Core.IRibbonExtensibility
Protected Overridable Function CreateRibbonExtensibilityObject () As IRibbonExtensibility

Retours

Objet qui implémente l’interface Microsoft.Office.Core.IRibbonExtensibility.

Exemples

L’exemple de code suivant remplace la CreateRibbonExtensibilityObject méthode dans la ThisAddin classe ou ThisDocument du projet et retourne le ruban que vous souhaitez afficher. L’exemple nécessite que vous ajoutiez deux rubans à votre projet appelé Ribbon1 et Ribbon2 à l’aide de l’élément Ribbon (Visual Designer). L’exemple vérifie la valeur d’un champ nommé myCondition et retourne le ruban approprié. Pour utiliser cet exemple, exécutez-le à partir de la ThisDocument classe dans un projet au niveau du document.

    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

Remplacez cette méthode pour retourner une implémentation de l’interface Microsoft.Office.Core.IRibbonExtensibility . Si votre projet comporte plusieurs rubans, vous pouvez spécifier les rubans à afficher au moment de l’exécution.

Vous n’avez pas besoin de remplacer cette méthode pour renvoyer les rubans que vous ajoutez au projet à l’aide du modèle d’élément Ruban (Visual Designer). Par défaut, cette méthode renvoie un RibbonManager objet qui représente tous les éléments du ruban (visual Designer) dans le projet. Pour plus d’informations, consultez Vue d’ensemble du ruban.

Vous devez remplacer la CreateRibbonExtensibilityObject méthode ou RequestService pour retourner les rubans dans votre projet que vous ajoutez à l’aide du modèle d’élément du ruban (XML). Pour plus d’informations sur la manière de substituer le CreateRibbonExtensibilityObject méthode, consultez ruban XML.

S’applique à