Элемент OverriddenByRibbonApi

Указывает, будут ли скрыты элементы управленияGroup, Button, Menu или menu в сочетаниях приложений и платформ, поддерживающих 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>