Создание команд надстроек в манифесте для Excel, PowerPoint и Word

Используйте VersionOverrides в манифесте, чтобы определить команды надстройки для Excel, PowerPoint и Word. Команды надстроек позволяют легко настроить пользовательский интерфейс Office по умолчанию, добавив конкретные элементы интерфейса, выполняющие действия. С помощью команд надстройки можно следующее:

  • Создавать элементы пользовательского интерфейса или точки входа, которые упрощают использование функций надстройки.
  • Добавлять кнопки или раскрывающийся список кнопок на ленту.
  • Добавлять отдельные элементы меню, каждый из которых может содержать необязательное подменю, к определенным контекстным меню.
  • Выполнять действия при выборе команды надстройки. Варианты действий:
    • Показать пользователю одну или несколько надстроек области задач. В надстройке области задач можно отобразить HTML, Fluent пользовательского интерфейса для создания пользовательского интерфейса.

      или

    • Запустить код JavaScript, который обычно выполняется без отображения пользовательского интерфейса.

В этой статье описывается, как отредактировать манифест, чтобы задать команды надстройки. На следующей схеме показана иерархия элементов, используемых для задания команд надстройки. Эти элементы подробнее рассматриваются в этой статье.

Примечание

В Outlook также поддерживаются команды надстроек. Дополнительные сведения см. в добавлении команд для Outlook

На приведенном ниже изображении представлен обзор элементов команд надстройки в манифесте.

Обзор элементов команд надстройки в манифесте. Верхний узел здесь — VersionOverrides с детскими узлами и ресурсами. В хостах размещены затем DesktopFormFactor. В DesktopFormFactor находятся FunctionFile и ExtensionPoint. В ExtensionPoint находятся CustomTab или OfficeTab и Office Меню. В CustomTab или Office Вкладка — группа, а затем Управление действием. В Office меню — управление и действие. В статье Ресурсы (дитя VersionOverrides) — изображения, URL-адреса, shortStrings и LongStrings.

Этап 1. Ознакомление с примером

Настоятельно рекомендуем сначала ознакомиться с одним из примеров, доступных на странице с примерами команд для надстроек Office. При необходимости вы можете создать свой манифест, следуя приведенным в руководстве инструкциям. Проверить манифест можно с использованием XSD-файла на сайте с примерами команд для надстроек Office. Прежде чем приступать к использованию команд надстроек, прочтите статью Команды надстроек для Excel, Word и PowerPoint.

Этап 2. Создание надстройки области задач

Чтобы начать использовать команды надстройки, сначала необходимо создать надстройку области задач, а затем изменить манифест надстройки, как описано в этой статье. Нельзя использовать команды надстройки с надстройки контента. При обновлении существующего манифеста необходимо добавить соответствующие пространства имен XML, а также добавить элемент VersionOverrides в манифест, описанный в шаге 3: добавить элемент VersionOverrides.

Ниже приведен пример манифеста надстройки Office 2013. В этом манифесте нет команд надстройки, так как здесь отсутствует элемент VersionOverrides. Office 2013 не поддерживает команды надстройки, но при добавлении элемента VersionOverrides в этот манифест надстройка будет работать как в Office 2013, так и в Office 2016. В Office 2013, надстройка не отображает команды и использует значение SourceLocation для запуска надстройки в виде единой области задач. В Office 2016, если элемент VersionOverrides не включен, для запуска надстройки используется элемент SourceLocation. Однако при включении элемента VersionOverrides надстройка отображает только команды, но не отображает надстройку в виде единой области задач.

<OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0" xmlns:ov="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="TaskPaneApp">
  <!--IMPORTANT! Id must be unique for each add-in. If you copy this manifest ensure that you change this id to your own GUID. -->
  <Id>657a32a9-ab8a-4579-ac9f-df1a11a64e52</Id>
  <Version>1.0.0.0</Version>
  <ProviderName>Contoso</ProviderName>
  <DefaultLocale>en-US</DefaultLocale>
  <DisplayName DefaultValue="Contoso Add-in Commands" />
  <Description DefaultValue="Contoso Add-in Commands"/>
  <IconUrl DefaultValue="~remoteAppUrl/Images/Icon_32.png" />
  <SupportUrl DefaultValue="[Insert the URL of a page that provides support information for the app]" />
  <AppDomains>
    <AppDomain>AppDomain1</AppDomain>
    <AppDomain>AppDomain2</AppDomain>
    <AppDomain>AppDomain3</AppDomain>
  </AppDomains>
  <Hosts>
    <Host Name="Workbook" />
  </Hosts>
  <DefaultSettings>
    <SourceLocation DefaultValue="https://www.contoso.com/Pages/Home.aspx" />
  </DefaultSettings>
  <Permissions>ReadWriteDocument</Permissions>

 <!-- The VersionOverrides element is inserted at this location in the manifest. -->

</OfficeApp>

Этап 3. Добавление элемента VersionOverrides

Элемент VersionOverrides — это корневой элемент, содержащий определение команды надстройки. Элемент манифеста VersionOverrides является дочерним для элемента OfficeApp. В приведенной ниже таблице перечислены атрибуты элемента VersionOverrides.

Атрибут Описание
xmlns
Обязательный. Расположение схемы. Необходимое значение — http://schemas.microsoft.com/office/taskpaneappversionoverrides.
xsi:type
Обязательный атрибут. Версия схемы. В этой статье описывается версия VersionOverridesV1_0.

В приведенной ниже таблице показаны дочерние элементы VersionOverrides.

Элемент Описание
Описание
Необязательный параметр. Описывает надстройку. Дочерний элемент Description переопределяет предыдущий элемент Description в родительской части манифеста. Атрибут resid для элемента Description задан как id элемента String. Элемент String содержит текст для элемента Description.
Requirements
Необязательный параметр. Задает минимальные набор требований и версию библиотеки Office.js, необходимые надстройке. Этот элемент требования к ребенку переопределяет элемент Requirements в родительской части манифеста. Дополнительные сведения см. в Office приложениях и требованиях API.
Hosts
Обязательный. Указывает коллекцию Office приложений. Дочерний элемент Hosts переопределяет элемент Hosts в родительской части манифеста. Необходимо включить атрибут xsi:type, для которого задано значение "Книга" или "Документ".
Resources
Определяет коллекцию ресурсов (строк, URL-адресов и изображений), на которые ссылаются другие элементы манифеста. Например, значение элемента Description ссылается на дочерний элемент в элементе Resources. Элемент Resources описан в разделе Этап 7. Добавление элемента Resources далее в этой статье.

В приведенном ниже примере показано, как использовать элемент VersionOverrides и его дочерние элементы.

<OfficeApp>
...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="VersionOverridesV1_0">
    <Description resid="residDescription" />
    <Requirements>
      <!-- add information about requirement sets -->
    </Requirements>
    <Hosts>
      <Host xsi:type="Workbook">
        <!-- add information about form factors -->
      </Host>
      <Host xsi:type="Document">
        <!-- add information about form factors -->
      </Host>
    </Hosts>
    <Resources> 
      <!-- add information about resources -->
    </Resources>
  </VersionOverrides>
...
</OfficeApp>

Этап 4. Добавление элементов Hosts, Host и DesktopFormFactor

Элемент Hosts содержит один или несколько элементов Host. Элемент Host указывает определенное Office приложение. Элемент Host содержит детские элементы, которые указывают команды надстройки, отображаемой после установки надстройки в этом Office приложении. Чтобы показать одинаковые команды надстройки в двух или более Office приложениях, необходимо дублировать детские элементы в каждом хосте.

Элемент DesktopFormFactor задает параметры надстройки, работающей в Office в Интернете (в браузере) и Windows.

Ниже приведены примеры элементов Hosts, Host и DesktopFormFactor.

<OfficeApp>
...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="VersionOverridesV1_0">
  ...
    <Hosts>
      <Host xsi:type="Workbook">
        <DesktopFormFactor>

              <!-- information about FunctionFile and ExtensionPoint -->

        </DesktopFormFactor>
      </Host>
    </Hosts>
  ...
  </VersionOverrides>
...
</OfficeApp>

Этап 5. Добавление элемента FunctionFile

Элемент FunctionFile задает файл, который содержит код JavaScript, выполняемый, когда команда надстройки использует действие ExecuteFunction (описание см. в разделе Элементы управления "Кнопка"). В атрибуте resid элемента FunctionFile указан HTML-файл, включающий все файлы JavaScript, необходимые командам надстройки. Ссылаться непосредственно на файл JavaScript невозможно. Вы можете сослаться только на HTML-файл. Имя файла задано в дочернем элементе Url элемента Resources.

Ниже приведен пример элемента FunctionFile.

<DesktopFormFactor>
    <FunctionFile resid="residDesktopFuncUrl" />
    <ExtensionPoint xsi:type="PrimaryCommandSurface">
      <!-- information about this extension point -->
    </ExtensionPoint>

    <!-- You can define more than one ExtensionPoint element as needed -->
</DesktopFormFactor>

Важно!

Убедитесь, что код JavaScript вызывает Office.initialize.

JavaScript должен вызывать Office.initialize в HTML-файле, на который ссылается элемент FunctionFile. Элемент FunctionName (описание см. в разделе Элементы управления "Кнопка") использует функции в элементе FunctionFile.

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

<script>
    // The initialize function must be run each time a new page is loaded.
    (function () {
        Office.initialize = function (reason) {
            // If you need to initialize something you can do so here.
        };
    })();

    // Your function must be in the global namespace.
    function writeText(event) {

        // Implement your custom code here. The following code is a simple example.  
        Office.context.document.setSelectedDataAsync("ExecuteFunction works. Button ID=" + event.source.id,
            function (asyncResult) {
                var error = asyncResult.error;
                if (asyncResult.status === Office.AsyncResultStatus.Failed) {
                    // Show error message.
                }
                else {
                    // Show success message.
                }
            });

        // Calling event.completed is required. event.completed lets the platform know that processing has completed.
        event.completed();
    }
</script>

Важно!

Вызов event.completed свидетельствует, что событие успешно обработано. Если функция вызывается несколько раз, например при выборе одной команды надстройки несколько раз, все события автоматически помещаются в очередь. Первое событие запускается автоматически, тогда как остальные ожидают в очереди. Как только функция вызывает event.completed, для нее запускается следующий вызов из очереди. Если объект event.completed не реализован, функция не запускается.

Этап 6. Добавление элементов ExtensionPoint

Элемент ExtensionPoint определяет, где в пользовательском интерфейсе Office должны появиться команды надстройки. Элементы ExtensionPoint можно определить с помощью этих значений xsi:type.

  • PrimaryCommandSurface, которое обозначает ленту в Office.

  • ContextMenu — контекстное меню, которое появляется при нажатии правой кнопкой мыши в пользовательском интерфейсе Office.

В приведенных ниже примерах показано, как применять элемент ExtensionPoint со значениями атрибута PrimaryCommandSurface и ContextMenu, и какие дочерние элементы использовать с каждым из них.

Важно!

Для элементов, содержащих атрибут идентификатора, необходимо предоставить уникальный идентификатор. Рекомендуем указать название компании с идентификатором. Используйте, например, формат <CustomTab id="mycompanyname.mygroupname">.

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso Tab">
  <!-- If you want to use a default tab that comes with Office, remove the above CustomTab element, and then uncomment the following OfficeTab element -->
  <!-- <OfficeTab id="TabData"> -->
    <Label resid="residLabel4" />
    <Group id="Group1Id12">
      <Label resid="residLabel4" />
      <Icon>
        <bt:Image size="16" resid="icon1_32x32" />
        <bt:Image size="32" resid="icon1_32x32" />
        <bt:Image size="80" resid="icon1_32x32" />
      </Icon>
      <Tooltip resid="residToolTip" />
      <Control xsi:type="Button" id="Button1Id1">

        <!-- information about the control -->
      </Control>
      <!-- other controls, as needed -->
    </Group>
  </CustomTab>
</ExtensionPoint>
<ExtensionPoint xsi:type="ContextMenu">
  <OfficeMenu id="ContextMenuCell">
    <Control xsi:type="Menu" id="ContextMenu2">
            <!-- information about the control -->
    </Control>
    <!-- other controls, as needed -->
  </OfficeMenu>
</ExtensionPoint>
Элемент Описание
CustomTab
Обязательный, если требуется добавить пользовательскую вкладку в ленту (с помощью элемента PrimaryCommandSurface). Невозможно использовать элементы CustomTab и OfficeTab одновременно. Атрибут id является обязательным.
OfficeTab
Требуется, если вы хотите расширить вкладку ленты Приложение Office по умолчанию (с помощью PrimaryCommandSurface). Невозможно использовать элементы OfficeTab и CustomTab одновременно.
Дополнительные значения вкладок, которые можно использовать с атрибутом id Приложение Office,см. в этой ссылке.
OfficeMenu
Обязательный при добавлении команд надстройки в контекстное меню по умолчанию (с помощью элемента ContextMenu). Для атрибута id необходимо задать следующее значение:
ContextMenuText для Excel или Word. Отображает элемент в контекстном меню, когда пользователь щелкает выделенный текст правой кнопкой мыши.
ContextMenuCell для Excel. Отображает элемент в контекстном меню, когда пользователь щелкает ячейку электронной таблицы правой кнопкой мыши.
Group
Группа точек расширения интерфейса пользователя на вкладке. В группе может быть до шести элементов управления. Атрибут id является обязательным. Это строка длиной до 125 символов.
Label
Обязательный. Метка группы. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу String. String — это дочерний элемент ShortStrings, который в свою очередь является дочерним для элемента Resources.
Icon
Обязательный. Определяет значок группы для использования на устройствах с малым форм-фактором или в случаях, когда отображается слишком много кнопок. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу Image. Image — это дочерний элемент Images, который в свою очередь является дочерним для элемента Resources. Атрибут size определяет размер изображения в пикселях. Обязательными являются три размера изображения: 16, 32 и 80. Кроме того, поддерживаются пять необязательных размеров: 20, 24, 40, 48 и 64.
Tooltip
Необязательный параметр. Всплывающая подсказка группы. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу String. String — это дочерний элемент LongStrings, который в свою очередь является дочерним для элемента Resources.
Control
Для каждой группы требуется хотя бы один элемент управления. Элемент Control может иметь значение Button или Menu. Укажите Menu, чтобы задать раскрывающийся список элементов управления "Кнопка". В настоящий момент поддерживаются только кнопки и меню. Дополнительные сведения см. в разделах Элементы управления "Кнопка" и Элементы управления "Меню".
Примечание. Чтобы упростить устранение неполадок, рекомендуем добавлять элемент Control и соответствующие дочерние элементы Resources по одному.

Элементы управления "Кнопка"

Когда пользователь нажимает кнопку, она выполняет одно действие. Она может выполнять функцию JavaScript или отображать область задач. В приведенном ниже примере показано, как определить две кнопки. Первая кнопка выполняет функцию JavaScript без отображения пользовательского интерфейса, а вторая отображает область задач. В элементе Control:

  • атрибут type является обязательным и должен иметь значение Button;

  • атрибут id элемента Control — это строка длиной до 125 символов.

<!-- Define a control that calls a JavaScript function. -->
<Control xsi:type="Button" id="Button1Id1">
  <Label resid="residLabel" />
  <Tooltip resid="residToolTip" />
  <Supertip>
    <Title resid="residLabel" />
    <Description resid="residToolTip" />
  </Supertip>
  <Icon>
    <bt:Image size="16" resid="icon1_32x32" />
    <bt:Image size="32" resid="icon1_32x32" />
    <bt:Image size="80" resid="icon1_32x32" />
  </Icon>
  <Action xsi:type="ExecuteFunction">
    <FunctionName>getData</FunctionName>
  </Action>
</Control>

<!-- Define a control that shows a task pane. -->
<Control xsi:type="Button" id="Button2Id1">
  <Label resid="residLabel2" />
  <Tooltip resid="residToolTip" />
  <Supertip>
    <Title resid="residLabel" />
    <Description resid="residToolTip" />
  </Supertip>
  <Icon>
    <bt:Image size="16" resid="icon2_32x32" />
    <bt:Image size="32" resid="icon2_32x32" />
    <bt:Image size="80" resid="icon2_32x32" />
  </Icon>
  <Action xsi:type="ShowTaskpane">
    <SourceLocation resid="residUnitConverterUrl" />
  </Action>
</Control>
Элементы Описание
Label
Обязательный. Текст для кнопки. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу String. String — это дочерний элемент ShortStrings, который в свою очередь является дочерним для элемента Resources.
Tooltip
Необязательный параметр. Всплывающая подсказка для кнопки. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу String. String — это дочерний элемент LongStrings, который в свою очередь является дочерним для элемента Resources.
Supertip
Обязательный элемент. Суперподсказка для кнопки, определяемая указанными ниже элементами.
Title
Обязательный. Текст суперподсказки. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу String. String — это дочерний элемент ShortStrings, который в свою очередь является дочерним для элемента Resources.
Описание
Обязательный. Описание суперподсказки. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу String. String — это дочерний элемент LongStrings, который в свою очередь является дочерним для элемента Resources.
Icon
Обязательный. Содержит элементы Image для кнопки. Файлы изображений должны быть в формате PNG.
Image
Определяет изображение для кнопки. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу Image. Image — это дочерний элемент Images, который в свою очередь является дочерним для элемента Resources. Атрибут size определяет размер изображения в пикселях. Обязательными являются три размера изображения: 16, 32 и 80. Кроме того, поддерживаются пять необязательных размеров: 20, 24, 40, 48 и 64.
Действие
Обязательный. Указывает действие, которое необходимо выполнить, когда пользователь нажимает кнопку. Для этого атрибута xsi:type можно указать следующие значения:
ExecuteFunction. Вызывает функцию JavaScript, расположенную в файле, на который ссылается элемент FunctionFile. ExecuteFunction не отображает пользовательский интерфейс. Дочерний элемент FunctionName задает имя выполняемой функции.
ShowTaskPane. Отображает надстройку области задач. Дочерний элемент SourceLocation задает расположение исходного файла отображаемой надстройки области задач. Для атрибута resid должно быть задано значение атрибута id элемента Url в элементе Urls, включенном в элемент Resources.

Элемент управления Меню можно использовать с элементом PrimaryCommandSurface или ContextMenu. Он определяет следующее:

  • элемент меню корневого уровня;
  • список элементов подменю.

При использовании совместно с элементом PrimaryCommandSurface, корневой элемент меню отображается в виде кнопки на ленте. При выборе кнопки отображается подменю в виде раскрывающегося списка. При использовании совместно с элементом ContextMenu, элемент меню с подменю вставляется в контекстное меню. В обоих случаях индивидуальные элементы подменю могут выполнять функцию JavaScript или отображать область задач. В настоящее время поддерживается только один уровень подменю.

В приведенном ниже примере показано, как определить элемент меню с двумя элементами подменю. Первый элемент подменю показывает область задач, а второй запускает функцию JavaScript. В элементе Control:

  • атрибут xsi:type является обязательным и должен иметь значение Menu;
  • атрибут id — это строка длиной до 125 символов.
<Control xsi:type="Menu" id="TestMenu2">
  <Label resid="residLabel3" />
  <Tooltip resid="residToolTip" />
  <Supertip>
    <Title resid="residLabel" />
    <Description resid="residToolTip" />
  </Supertip>
  <Icon>
    <bt:Image size="16" resid="icon1_32x32" />
    <bt:Image size="32" resid="icon1_32x32" />
    <bt:Image size="80" resid="icon1_32x32" />
  </Icon>
  <Items>
    <Item id="showGallery2">
      <Label resid="residLabel3"/>
      <Supertip>
        <Title resid="residLabel" />
        <Description resid="residToolTip" />
      </Supertip>
      <Icon>
        <bt:Image size="16" resid="icon1_32x32" />
        <bt:Image size="32" resid="icon1_32x32" />
        <bt:Image size="80" resid="icon1_32x32" />
      </Icon>
      <Action xsi:type="ShowTaskpane">
        <TaskpaneId>MyTaskPaneID1</TaskpaneId>
        <SourceLocation resid="residUnitConverterUrl" />
      </Action>
    </Item>
    <Item id="showGallery3">
      <Label resid="residLabel5"/>
      <Supertip>
        <Title resid="residLabel" />
        <Description resid="residToolTip" />
      </Supertip>
      <Icon>
        <bt:Image size="16" resid="icon4_32x32" />
        <bt:Image size="32" resid="icon4_32x32" />
        <bt:Image size="80" resid="icon4_32x32" />
      </Icon>
      <Action xsi:type="ExecuteFunction">
        <FunctionName>getButton</FunctionName>
      </Action>
    </Item>
  </Items>
</Control>
Элементы Описание
Label
Обязательный. Текст корневого элемента меню. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу String. String — это дочерний элемент ShortStrings, который в свою очередь является дочерним для элемента Resources.
Tooltip
Необязательный параметр. Всплывающая подсказка для меню. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу String. String — это дочерний элемент LongStrings, который в свою очередь является дочерним для элемента Resources.
SuperTip
Обязательный элемент. Суперподсказка для меню, определяемая указанными ниже элементами.
Title
Обязательный. Текст суперподсказки. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу String. String — это дочерний элемент ShortStrings, который в свою очередь является дочерним для элемента Resources.
Описание
Обязательный. Описание суперподсказки. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу String. String — это дочерний элемент LongStrings, который в свою очередь является дочерним для элемента Resources.
Icon
Обязательный. Содержит элементы Image для меню. Файлы изображений должны быть в формате PNG.
Image
Изображение для меню. Для атрибута resid должно быть задано значение атрибута id, принадлежащего элементу Image. Image — это дочерний элемент Images, который в свою очередь является дочерним для элемента Resources. Атрибут size определяет размер изображения в пикселях. Обязательными являются три размера изображения в пикселях: 16, 32 и 80. Кроме того, поддерживаются пять необязательных размеров в пикселях: 20, 24, 40, 48 и 64.
Items
Обязательный. Содержит элементы Item для каждого элемента подменю. Каждый элемент Item содержит те же дочерние элементы, что и Элементы управления ''Кнопка''.

Этап 7. Добавление элемента Resources

Элемент Resources содержит ресурсы, используемые различными дочерними элементами элемента VersionOverrides. Ресурсы включают значки, строки и URL-адреса. Элемент манифеста может использовать ресурс, ссылаясь на его id. Использование id помогает упорядочить манифест, особенно если для разных языковых стандартов используются разные версии ресурса. id может содержать до 32 знаков.

Ниже приведен пример использования элемента Resources. Каждый ресурс может иметь один или несколько дочерних элементов Override, позволяющих указать другой ресурс для определенного языкового стандарта.

<Resources>
  <bt:Images>
    <bt:Image id="icon1_16x16" DefaultValue="https://www.contoso.com/Images/icon_default.png">
      <bt:Override Locale="ja-jp" Value="https://www.contoso.com/Images/ja-jp16-icon_default.png" />
    </bt:Image>
    <bt:Image id="icon1_32x32" DefaultValue="https://www.contoso.com/Images/icon_default.png">
      <bt:Override Locale="ja-jp" Value="https://www.contoso.com/Images/ja-jp32-icon_default.png" />
    </bt:Image>
    <bt:Image id="icon1_80x80" DefaultValue="https://www.contoso.com/Images/icon_default.png">
      <bt:Override Locale="ja-jp" Value="https://www.contoso.com/Images/ja-jp80-icon_default.png" />
    </bt:Image>
  </bt:Images>
  <bt:Urls>
    <bt:Url id="residDesktopFuncUrl" DefaultValue="https://www.contoso.com/Pages/Home.aspx">
      <bt:Override Locale="ja-jp" Value="https://www.contoso.com/Pages/Home.aspx" />
    </bt:Url>
  </bt:Urls>
  <bt:ShortStrings>
    <bt:String id="residLabel" DefaultValue="GetData">
      <bt:Override Locale="ja-jp" Value="JA-JP-GetData" />
    </bt:String>
  </bt:ShortStrings>
  <bt:LongStrings>
    <bt:String id="residToolTip" DefaultValue="Get data for your document.">
      <bt:Override Locale="ja-jp" Value="JA-JP - Get data for your document." />
    </bt:String>
  </bt:LongStrings>
</Resources>
Ресурс Описание
Images/ Image
Предоставляет URL-адрес файла изображения по протоколу HTTPS. Каждое изображение должно быть определено в трех обязательных размерах:
16×16
32×32
80×80
Кроме того, поддерживаются следующие необязательные размеры:
20×20
24×24
40×40
48×48
64×64
Urls/ Url
Предоставляет URL-адрес с префиксом HTTPS. URL-адрес может включать до 2048 символов.
ShortStrings/ String
Текст для элементов Label и Title. Каждая строка содержит не более 125 символов.
LongStrings/ String
Текст для элементов Tooltip и Description. Каждый элемент String содержит не более 250 символов.

Примечание

Для всех URL-адресов в элементах Image и Url необходимо использовать протокол SSL.

Значения tab для вкладок Приложение Office ленты

В Excel и Word вы можете добавить команды надстройки на ленту с помощью стандартных вкладок пользовательского интерфейса Office. В приведенной ниже таблице перечислены значения, которые можно использовать для атрибута id элемента OfficeTab. Значения вкладок указываются с учетом регистра.

Office клиентского приложения Значения вкладок
Excel
TabHome TabInsert TabPageLayoutExcel TabFormulas TabData TabReview TabView TabDeveloper TabAddIns TabPrintPreview TabBackgroundRemoval
Word
TabHome TabInsert TabWordDesign TabPageLayoutWord TabReferences TabMailings TabReviewWord TabView TabDeveloper TabAddIns TabBlogPost TabBlogInsert TabPrintPreview TabOutlining TabConflicts TabBackgroundRemoval TabBroadcastPresentation
PowerPoint
TabHome TabInsert TabDesign TabTransitions TabAnimations TabSlideShow TabReview TabView TabDeveloper TabAddIns TabPrintPreview TabMerge TabGrayscale TabBlackAndWhite TabBroadcastPresentation TabSlideMaster TabHandoutMaster TabNotesMaster TabBackgroundRemoval TabSlideMasterHome

См. также