RibbonFactory.CreateRibbonManager, méthode
Crée un objet IRibbonExtensibility représentant une personnalisation de ruban.
Espace de noms : Microsoft.Office.Tools.Ribbon
Assembly : Microsoft.Office.Tools.Common (dans Microsoft.Office.Tools.Common.dll)
Syntaxe
'Déclaration
Function CreateRibbonManager ( _
ribbons As IRibbonExtension() _
) As IRibbonExtensibility
IRibbonExtensibility CreateRibbonManager(
IRibbonExtension[] ribbons
)
Paramètres
- ribbons
Type : array<Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
Tableau d'instances IRibbonExtension.
Valeur de retour
Type : Microsoft.Office.Core.IRibbonExtensibility
Objet représentant une personnalisation de ruban.
Notes
Retournez l'objet IRibbonExtensibility dans la méthode CreateRibbonExtensibilityObject du ThisAddin, ThisWorkbook ou la classe ThisDocument de votre projet pour retourner le Ruban que vous souhaitez afficher dans l'application Office.
Exemples
L'exemple suivant utilise une condition pour déterminer le Ruban personnalisé à afficher. Cet exemple utilise ensuite la méthode CreateRibbonManager pour créer puis retourner un objet IRibbonExtension 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 Ruban (Concepteur visuel).La syntaxe de retour d'un ruban créé à l'aide d'un élément Ruban (XML) est légèrement différente.Pour plus d'informations sur le retour d'un élément Ruban (XML), consultez Élément XML Ribbon.
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
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.