RibbonFactory.CreateRibbonManager(IRibbonExtension[]) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea un objeto IRibbonExtensibility que representa una personalización de la cinta.
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
Parámetros
- ribbons
- IRibbonExtension[]
Matriz de instancias de IRibbonExtension.
Devoluciones
Objeto que representa una personalización de la cinta.
Ejemplos
En el ejemplo siguiente se usa una condición para determinar qué cinta personalizada se va a mostrar. A continuación, en este ejemplo se usa el CreateRibbonManager método para crear y, a continuación, devolver un IRibbonExtension
objeto que representa la cinta personalizada.
Nota
La sintaxis usada en este ejemplo devuelve una cinta que se creó mediante el elemento Ribbon (Visual Designer). La sintaxis para devolver una cinta de opciones que se crea mediante un elemento de cinta de opciones (XML) es ligeramente diferente. Para obtener más información sobre cómo devolver un elemento de cinta de opciones (XML), vea XML de la cinta de opciones.
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
Comentarios
Devuelve el IRibbonExtensibility
objeto en el CreateRibbonExtensibilityObject
método de la ThisAddin
clase , ThisWorkbook
o ThisDocument
del proyecto para devolver la cinta de opciones que desea mostrar en la aplicación de Office.