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

Определяет кнопку, которая выполняет действие или запускает область задач.

Примечание.

Эта статья предполагает знакомство с основной справочной статьей по Control , которая содержит важную информацию об атрибутах элемента.

Когда пользователь нажимает кнопку, она выполняет одно действие. Она может выполнять функцию или отображать область задач. Каждый элемент управления кнопки должен иметь id значение атрибута, уникальное среди всех <элементов управления> в манифесте.

Важно!

Элементы управления типа "Кнопка" игнорируются на мобильных платформах. Для поддержки мобильных платформ необходимо также иметь элемент управления типа "MobileButton" для каждого элемента управления типа "Кнопка".

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

Элемент	Обязательный	Описание
Label	Да	Текст для кнопки.
Supertip	Да	Суперподсказка для кнопки. Важно! Суперсоветы поддерживаются только в классических клиентах Office.
Icon	Да	Изображение для кнопки.
Action	Да	Указание действия, которое предстоит выполнить. У элемента Control может быть только один <дочерний элемент действия>>.<
Enabled	Нет	Указывает, включается ли элемент управления при запуске надстройки.
OverriddenByRibbonApi	Нет	Указывает, должна ли кнопка отображаться в сочетаниях приложений и платформ, поддерживающих настраиваемые контекстные вкладки. Если используется, это должен быть первый дочерний элемент.

Label

Определяет текст для кнопки с помощью ее единственного атрибута, resid, который может содержать не более 32 символов и должен быть установлен в значение атрибута <id элемента String> в <дочернем элементе ShortStrings> элемента Resources.

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

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

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

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

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

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

Примеры

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

<Control xsi:type="Button" id="Contoso.msgReadFunctionButton">
  <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
  <Label resid="funcReadButtonLabel" />
  <Supertip>
    <Title resid="funcReadSuperTipTitle" />
    <Description resid="funcReadSuperTipDescription" />
  </Supertip>
  <Icon>
    <bt:Image size="16" resid="blue-icon-16" />
    <bt:Image size="32" resid="blue-icon-32" />
    <bt:Image size="80" resid="blue-icon-80" />
  </Icon>
  <Action xsi:type="ExecuteFunction">
    <FunctionName>getSubject</FunctionName>
  </Action>
  <Enabled>false</Enabled>
</Control>

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

<Control xsi:type="Button" id="Contoso.msgReadOpenPaneButton">
  <Label resid="paneReadButtonLabel" />
  <Supertip>
    <Title resid="paneReadSuperTipTitle" />
    <Description resid="paneReadSuperTipDescription" />
  </Supertip>
  <Icon>
    <bt:Image size="16" resid="green-icon-16" />
    <bt:Image size="32" resid="green-icon-32" />
    <bt:Image size="80" resid="green-icon-80" />
  </Icon>
  <Action xsi:type="ShowTaskpane">
    <SourceLocation resid="readTaskPaneUrl" />
  </Action>
</Control>