Compartilhar via

Elemento de controlo do tipo MobileButton

  • Artigo

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 estar familiarizado com o artigo de referência de Controlo 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 controlo de botão tem de ter um id valor de atributo exclusivo entre todos os <elementos de Controlo> no manifesto.

Tipo de suplemento: Email

Válido apenas 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, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

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 existir um <elemento Subordinado de ação> de um <elemento Controlo> .

Rótulo

Especifica o texto para o botão através do seu único atributo, residir, que não pode ter mais de 32 carateres e tem de ser definido para o valor do atributo id de um <elemento String> no <subordinado ShortStrings> do elemento Resources .

Tipo de suplemento: Email

Válido apenas nestes esquemas VersionOverrides:

  • Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

Exemplos

No exemplo seguinte, 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 seguinte, o botão apresenta 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>