DocumentBase.CreateRibbonExtensibilityObject Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca obiekt implementujący interfejs 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
Zwraca
Obiekt implementujący interfejs Microsoft.Office.Core.IRibbonExtensibility.
Przykłady
Poniższy przykład kodu zastępuje metodę CreateRibbonExtensibilityObject
w ThisAddin
klasie lub ThisDocument
projektu i zwraca wstążkę, którą chcesz wyświetlić. Przykład wymaga dodania dwóch wstążek do projektu o nazwie Ribbon1
i Ribbon2
przy użyciu elementu Wstążki (Visual Projektant). Przykład sprawdza wartość pola o nazwie myCondition
i zwraca odpowiednią wstążkę. Aby użyć tego przykładu ThisDocument
, uruchom go z klasy w projekcie na poziomie dokumentu.
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
Uwagi
Zastąpij tę metodę, aby zwrócić implementację interfejsu Microsoft.Office.Core.IRibbonExtensibility
. Jeśli masz wiele wstążek w projekcie, możesz określić, które wstążki mają być wyświetlane w czasie wykonywania.
Nie trzeba zastępować tej metody, aby zwracać wstążki dodawane do projektu przy użyciu szablonu elementu Wstążka (Visual Projektant). Domyślnie ta metoda zwraca RibbonManager obiekt reprezentujący wszystkie elementy wstążki (Visual Projektant) w projekcie. Aby uzyskać więcej informacji, zobacz Omówienie wstążki.
Aby zwrócić wstążki w projekcie, należy zastąpić metodę CreateRibbonExtensibilityObject or RequestService przy użyciu szablonu elementu Wstążki (XML). Aby uzyskać więcej informacji na temat zastępowania CreateRibbonExtensibilityObject metody, zobacz Plik XML wstążki.