DocumentBase.CreateRibbonExtensibilityObject Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.v4.0.Utilities.dll

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

IRibbonExtensibility

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.

Si applica a

Condividi tramite