Partager via


DocumentBase.CreateRibbonExtensibilityObject, méthode

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

Espace de noms :  Microsoft.Office.Tools.Word
Assembly :  Microsoft.Office.Tools.Word.v4.0.Utilities (dans Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntaxe

'Déclaration
Protected Overridable Function CreateRibbonExtensibilityObject As IRibbonExtensibility
protected virtual IRibbonExtensibility CreateRibbonExtensibilityObject()

Valeur de retour

Type : Microsoft.Office.Core.IRibbonExtensibility
Objet qui implémente l'interface Microsoft.Office.Core.IRibbonExtensibility.

Notes

Substituez cette méthode pour retourner l'implémentation de l'interface Microsoft.Office.Core.IRibbonExtensibility.Si vous avez plusieurs rubans dans votre projet, vous pouvez spécifier quels rubans doivent s'afficher au moment de l'exécution.

Vous n'avez pas à substituer cette méthode pour retourner des rubans que vous ajoutez au projet en utilisant le modèle d'élément Ruban (Concepteur visuel).Par défaut, cette méthode retourne un objet RibbonManager qui représente tous les éléments Ruban (Concepteur visuel) dans le projet.Pour plus d'informations, consultez Vue d'ensemble du ruban.

Vous devez substituer la méthode CreateRibbonExtensibilityObject ou RequestService pour retourner les rubans dans votre projet que vous ajoutez en utilisant le modèle d'élément Ruban (XML).Pour plus d'informations sur la substitution de la méthode CreateRibbonExtensibilityObject, consultez Élément XML Ribbon.

Exemples

L'exemple de code suivant remplace la méthode CreateRibbonExtensibilityObject dans la classe ThisAddin ou ThisDocument du projet et retourne le ruban que vous souhaitez afficher.L'exemple nécessite que vous ajoutiez deux rubans à votre projet appelés Ribbon1 et Ribbon2 via l'élément Ruban (Concepteur visuel).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 classe ThisDocument dans un projet au niveau du document.

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

Sécurité .NET Framework

Voir aussi

Référence

DocumentBase Classe

Microsoft.Office.Tools.Word, espace de noms