Размещение настраиваемой вкладки на ленте

Вы можете указать, где пользовательская вкладка надстройки будет отображаться на ленте приложения Office, используя разметку в манифесте надстройки.

Примечание.

В этой статье предполагается, что вы знакомы со статьей Основные понятия для команд надстроек. Если вы не сделали этого в последнее время, ознакомьтесь с ним.

Важно!

• Функция надстройки и разметка, описанные в этой статье, доступны только в PowerPoint в Интернете.
• Разметка, описанная в этой статье, работает только на платформах, поддерживающих набор требований AddinCommands 1.3. См. статью Поведение на неподдерживаемых платформах ниже.

Укажите, где должна отображаться настраиваемая вкладка, определив, какая встроенная вкладка Office должна находиться рядом с ней, и укажите, должна ли она находиться слева или справа от встроенной вкладки. Создайте эти спецификации, включив элемент InsertBefore (слева) или InsertAfter (справа) в элемент CustomTab манифеста надстройки. (Вы не можете иметь оба элемента.)

В следующем примере настраиваемая вкладка настроена так, чтобы она отображалась сразу после вкладки Рецензирование . Обратите внимание, что значение <элемента InsertAfter> — это идентификатор встроенной вкладки Office.

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom2">
    <Group id="Contoso.TabCustom2.group2">
       <!-- additional markup omitted -->
    </Group>
    <Label resid="customTabLabel1" />
    <InsertAfter>TabReview</InsertAfter>
  </CustomTab>
</ExtensionPoint>

Помните о следующих моментах.

• Элементы <InsertBefore> и <InsertAfter> являются необязательными. Если вы не используете ни один из вариантов, пользовательская вкладка будет отображаться как самая правая вкладка на ленте.
• Элементы <InsertBefore> и <InsertAfter> являются взаимоисключающими. Вы не можете использовать оба варианта.
• Если пользователь устанавливает несколько надстроек, настраиваемая вкладка которых настроена для одного и того же места( например, после вкладки Рецензирование ), вкладка для последней установленной надстройки будет расположена в этом месте. Вкладки ранее установленных надстроек будут перемещаться в одном месте. Например, пользователь устанавливает надстройки A, B и C в этом порядке, и все они настроены для вставки вкладки после вкладки Рецензирование . Затем вкладки будут отображаться в следующем порядке: Review, AddinCTab, AddinBTab, AddinATab.
• Пользователи могут настраивать ленту в приложении Office. Например, пользователь может перемещать или скрывать вкладку надстройки. Вы не можете предотвратить это или обнаружить, что это произошло.
• Если пользователь перемещает одну из встроенных вкладок, Office интерпретирует <элементы InsertBefore> и <InsertAfter> с точки зрения расположения встроенной вкладки по умолчанию. Например, если пользователь переместит вкладку Рецензирование в правый конец ленты, Office будет интерпретировать разметку в предыдущем примере как "поместить настраиваемую вкладку справа от того места, где по умолчанию будет находиться вкладка "Проверка".

Укажите, какая вкладка будет фокусироваться при открытии документа

Office всегда выделяет фокус по умолчанию на вкладке, которая находится справа от вкладки Файл . По умолчанию это вкладка Главная . Если настроить настраиваемую вкладку так, чтобы она была перед вкладкой Главная с <InsertBefore>TabHome</InsertBefore>помощью , то при открытии документа ваша настраиваемая вкладка будет иметь фокус.

Важно!

Чрезмерное выделение вашей надстройки создает неудобства и раздражает пользователей и администраторов. Не расположите настраиваемую вкладку перед вкладкой Главная , если только надстройка не является основным способом взаимодействия пользователей с документом.

Поведение на неподдерживаемых платформах

Если надстройка установлена на платформе, которая не поддерживает набор требований AddinCommands 1.3, то разметка, описанная в этой статье, игнорируется, а пользовательская вкладка будет отображаться как самая правая вкладка на ленте. Чтобы предотвратить установку надстройки на платформах, которые не поддерживают разметку, добавьте ссылку на набор требований в <разделе Требования> манифеста. Инструкции см . в разделе Указание версий и платформ Office, которые могут размещать надстройку. Кроме того, создайте надстройку так, чтобы она была альтернативной, если AddinCommands 1.3 не поддерживается, как описано в разделе Проектирование альтернативных интерфейсов. Например, если надстройка содержит инструкции, предполагающие, что настраиваемая вкладка находится на нужном месте, вы можете использовать альтернативную версию, предполагающую, что вкладка является самой правой.