Элемент 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 | Да | Тип выполняемого действия |
xsi:type
Этот атрибут указывает действие, которое выполняется, когда пользователь нажимает кнопку. Допустимые значения:
ExecuteFunctionShowTaskpane
Когда пользователь нажимает кнопку, которая запускает ExecuteFunction действие, время ожидания надстройки истекает через 5 минут, если она не завершена к тому времени.
Важно!
Outlook: регистрация событий почтовых ящиков и элементов недоступна, если xsi:type имеет значение ExecuteFunction.
Дочерние элементы
Допустимые дочерние элементы зависят от значения xsi:type параметра.
xsi:type имеет значение ExecuteFunction.
| Элемент | Описание |
|---|---|
| FunctionName | Указывает имя выполняемой функции. |
FunctionName
Обязательный элемент, если xsi:type имеет значение ExecuteFunction. Указывает имя выполняемой функции. Функция содержится в файле, указанном в элементе FunctionFile.
<Action xsi:type="ExecuteFunction">
<FunctionName>getSubject</FunctionName>
</Action>
xsi:type — ShowTaskpane
| Элемент | Описание |
|---|---|
| SourceLocation | Указывает расположение исходного файла для этого действия. |
| TaskpaneId | Определяет идентификатор для контейнера области задач. Не поддерживается в надстройках Outlook. |
| Title | Определяет заголовок области задач. Не поддерживается в надстройках Outlook. |
| SupportsPinning | Указывает, что область задач поддерживает закрепление (область задач остается открытой, когда пользователь выбирает другой элемент). Поддерживается только в Outlook. |
| SupportsMultiselect | Указывает, что надстройка Outlook может активироваться для нескольких выбранных сообщений. Поддерживается только в Outlook. |
| SupportsNoItemContext | Указывает, что надстройка Outlook может активироваться без включения области чтения или выбранного сообщения. Поддерживается только в классических клиентах Outlook. |
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
Дополнительные сведения см. в разделе Переопределения версий в манифесте.
Связаны с этими наборами требований:
Примечание.
Этот элемент не поддерживается в Outlook.
В следующем примере показаны два действия, которые совместно используют один и тот же <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
Дополнительные сведения см. в разделе Переопределения версий в манифесте.
Связаны с этими наборами требований:
Примечание.
Этот дочерний элемент не поддерживается в надстройках Outlook.
В следующем примере показано действие, использующее <элемент 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
Дополнительные сведения см. в разделе Переопределения версий в манифесте.
Связаны с этими наборами требований:
Важно!
Хотя элемент SupportsPinning появился в наборе требований 1.5, в настоящее время он поддерживается только для подписчиков Microsoft 365, используя следующее:
- Outlook 2016 или более поздней версии в Windows (сборка 7628.1000 или более поздняя версия)
- Outlook 2016 или более поздней версии на Mac (сборка 16.13.503 или более поздняя версия)
- Современная версия Outlook в Интернете
- новый Outlook в Windows (предварительная версия)
<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
Дополнительные сведения см. в разделе Переопределения версий в манифесте.
Связаны с этими наборами требований:
<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
Дополнительные сведения см. в разделе Переопределения версий в манифесте.
Связаны с этими наборами требований:
Примечание.
Хотя Outlook в Интернете и новый Outlook в Windows (предварительная версия) поддерживают набор обязательных почтовых ящиков 1.13, надстройка не активируется, если область чтения скрыта или сообщение не выбрано. Дополнительные сведения см. в разделах Поддержка функций в Outlook в Интернете и новый Outlook в Windows (предварительная версия).
<Action xsi:type="ShowTaskpane">
<SourceLocation resid="Taskpane.Url"/>
<SupportsNoItemContext>true</SupportsNoItemContext>
</Action>
Office Add-ins
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по