DocumentBase.CreateRibbonExtensibilityObject Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí objekt, který implementuje Microsoft.Office.Core.IRibbonExtensibility rozhraní.
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
Návraty
Objekt, který implementuje rozhraní Microsoft.Office.Core.IRibbonExtensibility.
Příklady
Následující příklad kódu přepíše metodu CreateRibbonExtensibilityObject
ThisAddin
ve třídě nebo ThisDocument
projektu a vrátí pás karet, který chcete zobrazit. Příklad vyžaduje, abyste do projektu přidali dva pásy karet s názvem Ribbon1
a Ribbon2
pomocí položky pásu karet (Vizuální Designer). Příklad zkontroluje hodnotu pole s názvem myCondition
a vrátí příslušný pás karet. Pokud chcete použít tento příklad, spusťte ho ThisDocument
ze třídy v projektu na úrovni 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
Poznámky
Přepsat tuto metodu vrátit implementace Microsoft.Office.Core.IRibbonExtensibility
rozhraní. Pokud máte v projektu více pásů karet, můžete určit, které pásy karet se mají zobrazit za běhu.
Tuto metodu není nutné přepsat, chcete-li vrátit pásy karet, které přidáte do projektu pomocí šablony položky pásu karet (vizuální Designer). Ve výchozím nastavení tato metoda vrátí RibbonManager objekt, který představuje všechny položky pásu karet (Vizuální Designer) v projektu. Další informace najdete v tématu Přehled pásu karet.
Pokud chcete v projektu vrátit pásy karet, které přidáte pomocí šablony položky pásu CreateRibbonExtensibilityObjectkaret (XML), musíte přepsat metodu nebo RequestService . Další informace o přepsání metody najdete v tématu Xml pásuCreateRibbonExtensibilityObject karet.