Élément de contrôle de type MobileButton

Définit un bouton qui exécute une action ou lance un volet Office et qui apparaît uniquement sur les plateformes mobiles.

Remarque

Cet article suppose une familiarité avec l’article de référence de base sur le contrôle 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 de bouton doit avoir une id valeur d’attribut unique parmi tous les <éléments de contrôle> du manifeste.

Type de complément : messagerie

Valide uniquement dans ces schémas VersionOverrides :

  • 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> d’action d’un <élément de contrôle> .

Étiquette

Spécifie le texte du bouton au moyen de son seul attribut, resid, qui ne peut pas dépasser 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 ces schémas VersionOverrides :

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