Elemento de control de tipo MobileButton

Define un botón que ejecuta una acción o inicia un panel de tareas y que aparece solo en plataformas móviles.

Nota:

En este artículo se supone que está familiarizado con el artículo de referencia de control básico que contiene información importante sobre los atributos del elemento.

Un botón móvil realiza una sola acción cuando el usuario lo selecciona. Puede ejecutar una función o mostrar un panel de tareas. Cada control de botón debe tener un valor de id atributo único entre todos los <elementos de control> del manifiesto.

Tipo de complemento: correo

Válido solo en estos esquemas VersionOverrides:

  • Correo 1.1

El valor MobileButton de xsi:type se define en el esquema VersionOverrides 1.1. El elemento que contenga VersionOverrides debe tener un xsi:typevalor de atributo de VersionOverridesV1_1.

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Asociados a estos conjuntos de requisitos:

Elementos secundarios

Elemento Obligatorio Descripción
Label Sí El texto del botón.
Icon Sí Una imagen del botón.
Action Sí Especifica la acción que se va a llevar a cabo. Solo puede haber una <acción> secundaria de un <elemento de control> .

Etiqueta

Especifica el texto del botón mediante su único atributo, resid, que no puede tener más de 32 caracteres y debe establecerse en el valor del atributo id de un <elemento String> en el <elemento secundario ShortStrings> del elemento Resources .

Tipo de complemento: correo

Válido solo en estos esquemas VersionOverrides:

  • Correo 1.1

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Asociados a estos conjuntos de requisitos:

Ejemplos

En el ejemplo siguiente, el botón ejecuta una función.

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

En el ejemplo siguiente, el botón muestra un panel de tareas.

<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