DocumentBase.CreateRibbonExtensibilityObject Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce un oggetto che implementa l'interfaccia 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
Restituisce
Un oggetto che implementa l'interfaccia Microsoft.Office.Core.IRibbonExtensibility.
Esempio
Nell'esempio di codice seguente viene eseguito l'override ThisAddin
del CreateRibbonExtensibilityObject
metodo nella classe o ThisDocument
del progetto e viene restituita la barra multifunzione che si desidera visualizzare. L'esempio richiede l'aggiunta di due barre multifunzione al progetto chiamato Ribbon1
e Ribbon2
l'elemento della barra multifunzione (Visual Designer). Nell'esempio viene controllato il valore di un campo denominato myCondition
e viene restituita la barra multifunzione appropriata. Per usare questo esempio, eseguirlo dalla ThisDocument
classe in un progetto a livello di documento.
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
Commenti
Eseguire l'override di questo metodo per restituire un'implementazione dell'interfaccia Microsoft.Office.Core.IRibbonExtensibility
. Se nel progetto sono presenti più barre multifunzione, è possibile specificare quali barre multifunzione visualizzare in fase di esecuzione.
Non è necessario eseguire l'override di questo metodo per restituire le barre multifunzione aggiunte al progetto usando il modello di elemento della barra multifunzione (Visual Designer). Per impostazione predefinita, questo metodo restituisce un RibbonManager oggetto che rappresenta tutti gli elementi della barra multifunzione (Visual Designer) nel progetto. Per altre informazioni, vedere Panoramica della barra multifunzione.
È necessario eseguire l'override del CreateRibbonExtensibilityObject metodo o RequestService per restituire le barre multifunzione nel progetto aggiunto usando il modello di elemento della barra multifunzione (XML). Per altre informazioni su come eseguire l'override del CreateRibbonExtensibilityObject metodo, vedere XML della barra multifunzione.