Поделиться через

Элемент управления типа Button

  • Статья

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

Примечание.

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

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

Важно!

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

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

Элемент Обязательный Описание
Label Да Текст для кнопки.
Supertip Да Суперподсказка для кнопки.

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

Label

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

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

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

  • Область задач 1.0
  • Почта 1.0
  • Почта 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>