Поделиться через

Элемент OverriddenByRibbonApi

  • Статья

Указывает, будут ли скрыты элементы управления "Группа", "Кнопка", "Меню" или пункт меню в сочетаниях приложений и платформ, поддерживающих API (Office.ribbon.requestCreateControls), устанавливающий настраиваемые контекстные вкладки на ленте.

Тип надстройки: надстройки области задач

Допустимо только в следующих схемах VersionOverrides:

  • Область задач 1.0

Дополнительные сведения см. в разделе Переопределения версий в манифесте только надстройки.

Связаны с этими наборами требований:

  • Лента 1.2 (требуется для Excel, PowerPoint и Word).)

Если этот элемент опущен, по умолчанию используется значение false. Если он используется, он должен быть первым дочерним элементом родительского элемента.

Примечание.

Полное представление об этом элементе см. в статье Реализация альтернативного интерфейса пользовательского интерфейса, если пользовательские контекстные вкладки не поддерживаются.

Этот элемент предназначен для создания резервного интерфейса в надстройке, которая реализует пользовательские контекстные вкладки, когда надстройка запущена в приложении или на платформе, которая не поддерживает пользовательские контекстные вкладки. Основная стратегия заключается в дублировании некоторых или всех групп и элементов управления из пользовательской контекстной вкладки на настраиваемую базовую вкладку (т. е. неконтекстовую пользовательскую вкладку). Затем, чтобы эти группы и элементы управления отображались, когда пользовательские контекстные вкладки не поддерживаются, но не отображаются при поддержке пользовательских контекстных вкладок, добавьте <OverriddenByRibbonApi>true</OverriddenByRibbonApi> в качестве первого дочернего <элемента элементов group>, <control> или menu< Item>. Результатом этого является следующее:

  • Если надстройка выполняется в приложении и на платформе, которые поддерживают пользовательские контекстные вкладки, повторяющиеся группы и элементы управления не будут отображаться на ленте. Вместо этого настраиваемая контекстная вкладка будет установлена, когда надстройка вызывает requestCreateControls метод .
  • Если надстройка выполняется в приложении или на платформе, которая не поддерживает пользовательские контекстные вкладки, на ленте появятся дублированные группы и элементы управления.

Примеры

Переопределение группы

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso.TabCustom">
    <Group id="Contoso.CustomTab.group1">
      <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
      <Control  xsi:type="Button" id="Contoso.MyButton1">
        <!-- Child elements omitted. -->
      </Control>
    </Group>
    <Label resid="customTabLabel"/>
  </CustomTab>
</ExtensionPoint>

Переопределение элемента управления

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso.TabCustom">
    <Group id="Contoso.CustomTab.group2">
      <Control  xsi:type="Button" id="Contoso.MyButton2">
        <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
        <!-- Other child elements omitted. -->
      </Control>
    </Group>
    <Label resid="customTabLabel"/>
  </CustomTab>
</ExtensionPoint>

Переопределение элемента меню

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso.TabCustom">
    <Group id="Contoso.CustomTab.group3">
      <Control  xsi:type="Menu" id="Contoso.MyMenu">
        <!-- Other child elements omitted. -->
        <Items>
          <Item id="showGallery">
            <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
            <!-- Other child elements omitted. -->
          </Item>
        </Items>
      </Control>
    </Group>
    <Label resid="customTabLabel"/>
  </CustomTab>
</ExtensionPoint>