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

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

Примечание.

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

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

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

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

• Почта 1.1

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

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

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

• Mailbox 1.5

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

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

Label

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

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

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

• Почта 1.1

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

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

• Mailbox 1.5

Примеры

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

<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>