Elemento de controle do tipo MobileButton

Define um botão que executa uma ação ou inicia um painel de tarefas e que aparece apenas em plataformas móveis.

Observação

Este artigo pressupõe familiaridade com o artigo de referência de controle básico que contém informações importantes sobre os atributos do elemento.

Um botão móvel executa uma única ação quando o usuário o seleciona. Pode ser a execução de uma função ou a exibição de um painel de tarefas. Cada controle de botão deve ter um id valor de atributo exclusivo entre todos os <elementos control> no manifesto.

Tipo de suplemento: Email

Válido somente nestes esquemas VersionOverrides:

• Email 1.1

O valor MobileButton de xsi:type é definido no esquema VersionOverrides 1.1. O elemento VersionOverrides incluído deve ter um valor de atributo xsi:type de VersionOverridesV1_1.

Para obter mais informações, consulte Substituições de versão no manifesto.

Associado a esses conjuntos de requisitos:

• Caixa de correio 1.5

Elementos filho

Elemento	Obrigatório	Descrição
Label	Sim	O texto do botão.
Icon	Sim	Uma imagem para o botão.
Action	Sim	Especifica a ação a ser executada. Só pode haver uma <ação> filho de um <elemento Control> .

Rótulo

Especifica o texto para o botão por meio de seu único atributo, resid, que não pode ter mais de 32 caracteres e deve ser definido como o valor do atributo id de um <elemento String> no <filho shortstrings> do elemento Resources .

Tipo de suplemento: Email

Válido somente nestes esquemas VersionOverrides:

• Email 1.1

Para obter mais informações, consulte Substituições de versão no manifesto.

Associado a esses conjuntos de requisitos:

• Caixa de correio 1.5

Exemplos

No exemplo a seguir, o botão executa uma função.

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

No exemplo a seguir, o botão exibe um painel de tarefas.

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