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

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

  • Статья

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

Примечание.

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

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

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

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

  • Почта 1.1

Значение MobileButton для xsi:type определено в схеме 1.1 VersionOverrides. В соответствующем элементе VersionOverrides для атрибута xsi:type должно быть задано значение VersionOverridesV1_1.

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

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

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

Элемент Обязательный Описание
Label Да Текст для кнопки.
Icon Да Изображение для кнопки.
Action Да Указание действия, которое предстоит выполнить. Для элемента Control> может быть только один дочерний<элемент Action>.<

Label

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

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

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

  • Почта 1.1

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

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

Примеры

В следующем примере кнопка выполняет функцию.

<Control xsi:type="MobileButton" id="Contoso.msgReadFunctionButton">
  <Label resid="funcReadButtonLabel" />
  <Icon>
    <bt:Image resid="blue-icon-16-1" size="25" scale="1" />
    <bt:Image resid="blue-icon-16-2" size="25" scale="2" />
    <bt:Image resid="blue-icon-16-3" size="25" scale="3" />
    <bt:Image resid="blue-icon-32-1" size="32" scale="1" />
    <bt:Image resid="blue-icon-32-2" size="32" scale="2" />
    <bt:Image resid="blue-icon-32-3" size="32" scale="3" />
    <bt:Image resid="blue-icon-80-1" size="48" scale="1" />
    <bt:Image resid="blue-icon-80-2" size="48" scale="2" />
    <bt:Image resid="blue-icon-80-3" size="48" scale="3" />
  </Icon>
  <Action xsi:type="ExecuteFunction">
    <FunctionName>getSubject</FunctionName>
  </Action>
</Control>

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

<Control xsi:type="MobileButton" id="Contoso.msgReadOpenPaneButton">
  <Label resid="paneReadButtonLabel" />
  <Icon>
    <bt:Image resid="blue-icon-16-1" size="25" scale="1" />
    <bt:Image resid="blue-icon-16-2" size="25" scale="2" />
    <bt:Image resid="blue-icon-16-3" size="25" scale="3" />
    <bt:Image resid="blue-icon-32-1" size="32" scale="1" />
    <bt:Image resid="blue-icon-32-2" size="32" scale="2" />
    <bt:Image resid="blue-icon-32-3" size="32" scale="3" />
    <bt:Image resid="blue-icon-80-1" size="48" scale="1" />
    <bt:Image resid="blue-icon-80-2" size="48" scale="2" />
    <bt:Image resid="blue-icon-80-3" size="48" scale="3" />
  </Icon>
  <Action xsi:type="ShowTaskpane">
    <SourceLocation resid="readTaskPaneUrl" />
  </Action>
</Control>