Elemento de controle do tipo MobileButton

Define um botão que executa uma ação ou inicia um painel de tarefas e que aparece somente 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 valor de id 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 somente do suplemento.

Associado 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. Pode haver apenas um<> filho Action de um <elemento Control>.

Rótulo

Especifica o texto do 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 somente do suplemento.

Associado a estes conjuntos de requisitos:

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>
  • Last updated on