Metodo DocumentBase.CreateRibbonExtensibilityObject
Restituisce un oggetto che implementa l'interfaccia Microsoft.Office.Core.IRibbonExtensibility.
Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Sintassi
'Dichiarazione
Protected Overridable Function CreateRibbonExtensibilityObject As IRibbonExtensibility
protected virtual IRibbonExtensibility CreateRibbonExtensibilityObject()
Valore restituito
Tipo: Microsoft.Office.Core.IRibbonExtensibility
Oggetto che implementa l'interfaccia Microsoft.Office.Core.IRibbonExtensibility.
Note
Eseguire l'override di questo metodo per restituire un'implementazione dell'interfaccia Microsoft.Office.Core.IRibbonExtensibility. Se il progetto prevede 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 mediante il modello dell'elemento Barra multifunzione (finestra di progettazione visiva). Per impostazione predefinita, il metodo restituisce un oggetto RibbonManager che rappresenta tutti gli elementi Barra multifunzione (finestra di progettazione visiva) del progetto. Per ulteriori informazioni, vedere Cenni preliminari sulla barra multifunzione.
Per restituire le barre multifunzione del progetto aggiunte mediante il modello dell'elemento Barra multifunzione (XML), eseguire l'override del metodo CreateRibbonExtensibilityObject or RequestService. Per ulteriori informazioni sull'override del metodo CreateRibbonExtensibilityObject, vedere Elemento XML della barra multifunzione.
Esempi
Nell'esempio di codice riportato di seguito viene eseguito l'override del metodo CreateRibbonExtensibilityObject nella classe ThisAddin o ThisDocument del progetto e viene restituita la barra multifunzione che si desidera visualizzare. È necessario aggiungere due barre multifunzione al progetto denominate Ribbon1 e Ribbon2 tramite la voce Barra multifunzione (finestra di progettazione visiva). Nell'esempio viene controllato il valore di un campo denominato myCondition e viene restituita la barra multifunzione appropriata. Per utilizzare questo esempio, eseguirlo dalla classe ThisDocument in un progetto a livello di 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() });
}
}
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.