Compartir a través de

Elemento Control del tipo MobileButton

  • Artículo

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 da por hecho que está familiarizado con el artículo de referencia básica control , 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 id valor de atributo único entre todos los <elementos Control> del manifiesto.

Tipo de complemento: correo

Solo es válido 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.

Asociado 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 un <elemento secundario Action> de un <elemento Control> .

Etiqueta

Especifica el texto del botón por medio de 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

Solo es válido en estos esquemas VersionOverrides:

  • Correo 1.1

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

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