DocumentBase.CreateRibbonExtensibilityObject Метод

Определение

Пространство имен:

Microsoft.Office.Tools.Word

Сборка:

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

Возвращает объект, реализующий интерфейс 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

Возвращаемое значение

IRibbonExtensibility

Объект, реализующий интерфейс Microsoft.Office.Core.IRibbonExtensibility.

Примеры

В следующем примере кода переопределяется CreateRibbonExtensibilityObject метод в ThisAddin классе или ThisDocument проекта и возвращается лента, которую вы хотите отобразить. В этом примере требуется добавить в проект две ленты с именем Ribbon1 и Ribbon2 с помощью элемента Лента (visual Designer). В примере проверяется значение поля с именем myCondition и возвращается соответствующая лента. Чтобы использовать этот пример, запустите его из ThisDocument класса в проекте уровня документа.

    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

Комментарии

Переопределите этот метод, чтобы вернуть реализацию Microsoft.Office.Core.IRibbonExtensibility интерфейса. Если в проекте несколько лент, можно указать, какие ленты будут отображаться во время выполнения.

Вам не нужно переопределять этот метод, чтобы возвращать ленты, добавленные в проект с помощью шаблона элемента Лента (visual Designer). По умолчанию этот метод возвращает RibbonManager объект , представляющий все элементы ленты (visual Designer) в проекте. Дополнительные сведения см. в разделе Общие сведения о ленте.

Необходимо переопределить CreateRibbonExtensibilityObject метод или RequestService , чтобы вернуть ленты в проекте, который вы добавляете с помощью шаблона элемента ленты (XML). Дополнительные сведения о переопределении метода см. в CreateRibbonExtensibilityObject разделе Xml ленты.