Размещение настраиваемой вкладки на ленте
Вы можете указать, где пользовательская вкладка надстройки будет отображаться на ленте приложения Office, используя разметку в манифесте надстройки.
Примечание.
В этой статье предполагается, что вы знакомы со статьей Основные понятия для команд надстроек. Если вы не сделали этого в последнее время, ознакомьтесь с ним.
Важно!
- Функция надстройки и разметка, описанные в этой статье, доступны только в PowerPoint в Интернете.
- Разметка, описанная в этой статье, работает только на платформах, поддерживающих набор требований AddinCommands 1.3. См. статью Поведение на неподдерживаемых платформах ниже.
По умолчанию настраиваемая вкладка добавляется в конец ленты. Однако можно указать, где должна отображаться пользовательская вкладка, определив, какая встроенная вкладка Office должна находиться рядом с ней, и указав, должна ли она находиться слева или справа от встроенной вкладки. Откройте вкладку с типом манифеста, используемого вашей надстройкой, для получения сведений о разметке манифеста.
Примечание.
Унифицированный манифест для Microsoft 365 можно использовать в рабочих надстройках Outlook. Он доступен только в качестве предварительной версии для надстроек Excel, PowerPoint и Word.
Чтобы разместить настраиваемую вкладку, добавьте свойство position в объект extensions.ribbons.tabs. Задайте для свойства position.builtInTabId идентификатор встроенной вкладки, рядом с которой должна находиться пользовательская вкладка. (См . раздел Поиск идентификаторов встроенных вкладок ленты Office.) Задайте для свойства "position.align" значение "before" (слева) или "after" (справа).
В следующем примере настраиваемая вкладка настроена так, чтобы она отображалась сразу после вкладки Рецензирование .
"extensions": [
...
{
...
"ribbons": [
...
{
...
"tabs": [
{
"id": "MyTab",
...
"position": {
"builtInTabId": "TabReview",
"align": "after"
}
}
]
}
]
}
]
Как действия пользователя могут повлиять на настраиваемое расположение вкладок
- Если пользователь устанавливает несколько надстроек, настраиваемая вкладка которых настроена для одного и того же места( например, после вкладки Рецензирование ), вкладка для последней установленной надстройки будет расположена в этом месте. Вкладки ранее установленных надстроек будут перемещаться в одном месте. Например, пользователь устанавливает надстройки A, B и C в этом порядке, и все они настроены для вставки вкладки после вкладки Рецензирование . Затем вкладки будут отображаться в следующем порядке: Review, AddinCTab, AddinBTab, AddinATab.
- Пользователи могут настраивать ленту в приложении Office. Например, пользователь может перемещать или скрывать вкладку надстройки. Вы не можете предотвратить это или обнаружить, что это произошло.
- Если пользователь перемещает одну из встроенных вкладок, Office интерпретирует разметку расположения в манифесте с точки зрения расположения встроенной вкладки по умолчанию. Например, если пользователь переместит вкладку Рецензирование в правый конец ленты, Office будет интерпретировать разметку в предыдущем примере как "поместить настраиваемую вкладку справа от того места, где по умолчанию будет находиться вкладка "Проверка".
Укажите, какая вкладка будет фокусироваться при открытии документа
Office всегда выделяет фокус по умолчанию на вкладке, которая находится справа от вкладки Файл . По умолчанию это вкладка Главная . Если настроить настраиваемую вкладку так, чтобы она была перед вкладкой Главная , то при открытии документа фокус будет отображаться на настраиваемой вкладке.
Важно!
Чрезмерное выделение вашей надстройки создает неудобства и раздражает пользователей и администраторов. Не расположите настраиваемую вкладку перед вкладкой Главная , если только надстройка не является основным способом взаимодействия пользователей с документом.
Поведение на неподдерживаемых платформах
Если надстройка установлена на платформе, которая не поддерживает набор требований AddinCommands 1.3, то разметка, описанная в этой статье, игнорируется, а пользовательская вкладка будет отображаться как самая правая вкладка на ленте. Чтобы предотвратить установку надстройки на платформах, не поддерживающих разметку, необходимо указать AddinCommands 1.3 в манифесте в качестве требования для установки. Инструкции см . в разделе Указание версий и платформ Office, которые могут размещать надстройку. Кроме того, создайте надстройку так, чтобы она была альтернативной, если AddinCommands 1.3 не поддерживается, как описано в разделе Проектирование альтернативных интерфейсов. Например, если надстройка содержит инструкции, предполагающие, что настраиваемая вкладка находится на нужном месте, вы можете использовать альтернативную версию, предполагающую, что вкладка является самой правой.
Office Add-ins