RibbonFactory.CreateRibbonManager - метод
Создает объект IRibbonExtensibility, представляющий настройку ленты.
Пространство имен: Microsoft.Office.Tools.Ribbon
Сборка: Microsoft.Office.Tools.Common (в Microsoft.Office.Tools.Common.dll)
Синтаксис
'Декларация
Function CreateRibbonManager ( _
ribbons As IRibbonExtension() _
) As IRibbonExtensibility
IRibbonExtensibility CreateRibbonManager(
IRibbonExtension[] ribbons
)
Параметры
- ribbons
Тип: array<Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
Массив экземпляров класса IRibbonExtension.
Возвращаемое значение
Тип: Microsoft.Office.Core.IRibbonExtensibility
Объект, представляющий настройку ленты.
Заметки
Верните объект IRibbonExtensibility в методе CreateRibbonExtensibilityObject класса ThisAddin, ThisWorkbook или ThisDocument вашего проекта, чтобы вернуть ленту, которую требуется отобразить в приложении Office.
Примеры
В следующем примере используется условие, определяющее, какую настраиваемую ленту следует отобразить. В этом примере метод CreateRibbonManager используется для создания и последующего возвращения объекта IRibbonExtension, представляющего пользовательскую ленту.
Примечание
Синтаксис, используемый в данном примере, возвращает ленту, созданную с помощью элемента Лента (визуальный конструктор).Синтаксис, возвращающий ленту, созданную с помощью элемента Лента (XML), отличается незначительно.Дополнительные сведения о возврате элемента Лента (XML) см. в разделе XML-ленты.
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() });
}
}
Безопасность платформы .NET Framework
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.