DocumentBase.CreateRibbonExtensibilityObject (Método)
Devuelve un objeto que implementa la interfaz Microsoft.Office.Core.IRibbonExtensibility.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word.v4.0.Utilities (en Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Sintaxis
'Declaración
Protected Overridable Function CreateRibbonExtensibilityObject As IRibbonExtensibility
protected virtual IRibbonExtensibility CreateRibbonExtensibilityObject()
Valor devuelto
Tipo: Microsoft.Office.Core.IRibbonExtensibility
Objeto que implementa la interfaz Microsoft.Office.Core.IRibbonExtensibility.
Comentarios
Invalide este método para devolver una implementación de la interfaz Microsoft.Office.Core.IRibbonExtensibility.Si hay varias cintas de opciones en el proyecto, puede especificar qué cintas de opciones deben mostrarse en tiempo de ejecución.
No necesita invalidar este método para que se devuelvan las cintas de opciones que agrega al proyecto mediante la plantilla de elementos Cinta (diseñador visual).De forma predeterminada, este método devuelve un objeto RibbonManager que representa todos los elementos Cinta (diseñador visual) del proyecto.Para obtener más información, vea Información general sobre la cinta de opciones.
Debe reemplazar el método CreateRibbonExtensibilityObject o RequestService para que se devuelvan las cintas de opciones que agrega al proyecto mediante la plantilla de elementos Cinta (XML).Para obtener más información sobre cómo invalidar el método CreateRibbonExtensibilityObject, vea XML de la cinta de opciones.
Ejemplos
En el ejemplo de código siguiente se invalida el método CreateRibbonExtensibilityObject de la clase ThisDocument o ThisAddin del proyecto y se devuelve la cinta de opciones que se desea mostrar.El ejemplo requiere que se agreguen dos cintas de opciones al proyecto llamadas Ribbon1 y Ribbon2 utilizando el elemento Cinta (Diseñador visual).Se comprueba el valor de un campo denominado myCondition y se devuelve la cinta de opciones adecuada.Para usar este ejemplo, ejecútelo desde la clase ThisDocument en un proyecto de nivel de documento.
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() });
}
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.