Элемент Action

Указывает действие, выполняемое при выборе пользователем элемента управления Кнопка или Меню .

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

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

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

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

• AddinCommands 1.1 , если родительская <версияOverrides> имеет тип Taskpane 1.0.
• Почтовый ящик 1.3 , если родительская <версияOverrides> имеет тип Mail 1.0.
• Почтовый ящик 1.5 , если родительская <версияOverrides> имеет тип Почта 1.1.

Атрибуты

xsi:type

Этот атрибут указывает действие, которое выполняется, когда пользователь нажимает кнопку. Допустимые значения:

• ExecuteFunction
• ShowTaskpane

Когда пользователь нажимает кнопку, которая запускает ExecuteFunction действие, время ожидания надстройки истекает через 5 минут, если она не завершена к тому времени.

Дочерние элементы

Допустимые дочерние элементы зависят от значения xsi:type параметра.

xsi:type имеет значение ExecuteFunction.

FunctionName

Обязательный элемент, если xsi:type имеет значение ExecuteFunction. Указывает имя выполняемой функции. Функция содержится в файле, указанном в элементе FunctionFile.

<Action xsi:type="ExecuteFunction">
  <FunctionName>getSubject</FunctionName>
</Action>

xsi:type — ShowTaskpane

SourceLocation

Обязательный элемент, если xsi:type имеет значение ShowTaskpane. Указывает расположение исходного файла для этого действия. Атрибут resid может содержать не более 32 символов и должен иметь значение атрибута <id элемента Url> в элементе< Urls> элемента Resources.

<Action xsi:type="ShowTaskpane">
  <SourceLocation resid="readTaskPaneUrl" />
</Action>

TaskpaneId

Необязательный элемент, если xsi:type имеет значение ShowTaskpane. Определяет идентификатор для контейнера области задач. Если у вас есть несколько ShowTaskpane действий, используйте разные <taskpaneId> , если требуется независимая область для каждого из них. Используйте один и тот же <TaskpaneId> для разных действий, которые используют одну и ту же область. Когда пользователи выбирают команды, которые совместно используют один и тот же <TaskpaneId>, контейнер области останется открытым, но содержимое панели будет заменено соответствующим действием SourceLocation.

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

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

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

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

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

• AddinCommands 1.1

В следующем примере показаны два действия, которые совместно используют один и тот же <TaskpaneId>.

<Action xsi:type="ShowTaskpane">
  <TaskpaneId>MyPane</TaskpaneId>
  <SourceLocation resid="aTaskPaneUrl" />
</Action>

<Action xsi:type="ShowTaskpane">
  <TaskpaneId>MyPane</TaskpaneId>
  <SourceLocation resid="anotherTaskPaneUrl" />
</Action>

В следующих примерах показаны два действия, использующие другой <TaskpaneId>. Чтобы просмотреть эти примеры в контексте, см. пример простых команд надстроек.

<Action xsi:type="ShowTaskpane">
   <TaskpaneId>MyTaskPaneID1</TaskpaneId>
   <SourceLocation resid="Contoso.Taskpane1.Url" />
</Action>

<Action xsi:type="ShowTaskpane">
   <TaskpaneId>MyTaskPaneID2</TaskpaneId>
   <SourceLocation resid="Contoso.Taskpane2.Url" />
</Action>

<bt:Urls>
   <bt:Url id="Contoso.Taskpane1.Url" DefaultValue="https://commandsimple.azurewebsites.net/Taskpane.html" />
   <bt:Url id="Contoso.Taskpane2.Url" DefaultValue="https://commandsimple.azurewebsites.net/Taskpane2.html" />
</bt:Urls>

Название

Необязательный элемент, если xsi:type имеет значение ShowTaskpane. Определяет заголовок области задач для этого действия.

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

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

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

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

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

• AddinCommands 1.1

В следующем примере показано действие, использующее <элемент Title> . Обратите внимание, что заголовок> не назначается< строке напрямую. Вместо этого ему назначается идентификатор ресурса (resid), который определен в <разделе Ресурсы> манифеста и может содержать не более 32 символов.

<Action xsi:type="ShowTaskpane">
    <TaskpaneId>Office.AutoShowTaskpaneWithDocument</TaskpaneId>
    <SourceLocation resid="PG.Code.Url" />
    <Title resid="PG.CodeCommand.Title" />
</Action>

 ... Other markup omitted ...
<Resources>
    <bt:Images> ...
    </bt:Images>
    <bt:Urls>
        <bt:Url id="PG.Code.Url" DefaultValue="https://localhost:3000?commands=1" />
    </bt:Urls>
    <bt:ShortStrings>
        <bt:String id="PG.CodeCommand.Title" DefaultValue="Code" />
    </bt:ShortStrings>
 ... Other markup omitted ...
</Resources>

SupportsPinning

Необязательный элемент, если xsi:type имеет значение ShowTaskpane. Элементы, содержащие VersionOverrides , должны иметь значение атрибута xsi:type , равное VersionOverridesV1_1. Включите этот элемент со значением true для поддержки закрепления области задач. Пользователь сможет закрепить область задач, после чего она будет оставаться открытой при выборе другого элемента. Дополнительные сведения см. в статье Реализация закрепляемой области задач в Outlook.

Тип надстройки: почтовая

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

• Почта 1.1

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

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

• Mailbox 1.5

<Action xsi:type="ShowTaskpane">
  <SourceLocation resid="readTaskPaneUrl" />
  <SupportsPinning>true</SupportsPinning>
</Action>

SupportsMultiselect

Необязательный элемент в надстройках Outlook, если xsi:type имеет значение ShowTaskpane. Включите значение true , чтобы разрешить надстройке активировать и выполнять определенные операции с несколькими выбранными сообщениями. Так как элемент с несколькими выборами применяется только к сообщениям, значение атрибута xsi:type элемента ExtensionPoint должно иметь значение MessageReadCommandSurface или MessageComposeCommandSurface. Дополнительные сведения о множественном выборе элементов см. в статье Активация надстройки Outlook для нескольких сообщений.

Тип надстройки: почтовая

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

• Почта 1.1

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

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

• Почтовый ящик 1.13

<Action xsi:type="ShowTaskpane">
    <SourceLocation resid="readTaskpaneUrl" />
    <SupportsMultiSelect>true</SupportsMultiSelect>
</Action>

SupportsNoItemContext

Необязательный элемент в надстройках Outlook, если xsi:type имеет значение ShowTaskpane. Включите значение true , чтобы разрешить активацию надстройки без включения области чтения или выбранного сообщения. Если <параметр SupportsNoItemContext> имеет значение true, значение атрибута xsi:type элемента ExtensionPoint должно иметь значение MessageReadCommandSurface. Дополнительные сведения см. в статье Активация надстройки Outlook без включения области чтения или выбранного сообщения.

Тип надстройки: почтовая

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

• Почта 1.1

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

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

• Почтовый ящик 1.13

<Action xsi:type="ShowTaskpane">
    <SourceLocation resid="Taskpane.Url"/>
    <SupportsNoItemContext>true</SupportsNoItemContext>
</Action>