Élément Control de type MobileButton

  • Article

Définit un bouton qui exécute une action ou lance un volet Office et qui s’affiche uniquement sur les plateformes mobiles.

Remarque

Cet article suppose que vous êtes familiarisé avec l’article de référence Control de base qui contient des informations importantes sur les attributs de l’élément.

Un bouton mobile effectue une action unique lorsque l’utilisateur le sélectionne. Il peut exécuter une fonction ou afficher un volet Office. Chaque contrôle bouton doit avoir une valeur d’attribut id unique parmi tous les <éléments Control> du manifeste.

Type de complément : messagerie

Valide uniquement dans les schémas VersionOverrides suivants :

  • Courrier 1.1

La valeur MobileButton de xsi:type est définie dans le schéma VersionOverrides 1.1. Pour les éléments VersionOverrides la contenant, xsi:typel’attribut doit avoir la valeur VersionOverridesV1_1.

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

Éléments enfants

Élément Obligatoire Description
Label Oui Texte du bouton.
Icon Oui Image du bouton.
Action Oui Spécifie l’action à effectuer. Il ne peut y avoir qu’un <seul enfant Action> d’un <élément Control> .

Étiquette

Spécifie le texte du bouton au moyen de son seul attribut, resid, qui ne peut pas comporter plus de 32 caractères et doit être défini sur la valeur de l’attribut id d’un <élément String> dans l’enfant< ShortStrings> de l’élément Resources.

Type de complément : messagerie

Valide uniquement dans les schémas VersionOverrides suivants :

  • Courrier 1.1

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

Exemples

Dans l’exemple suivant, le bouton exécute une fonction .

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

Dans l’exemple suivant, le bouton affiche un volet Office.

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