Steuerelementelement vom Typ MobileButton

  • Artikel

Definiert eine Schaltfläche, die eine Aktion ausführt oder einen Aufgabenbereich startet und nur auf mobilen Plattformen angezeigt wird.

Hinweis

In diesem Artikel wird vorausgesetzt, dass Sie mit dem grundlegenden Referenzartikel zu Steuerelementen vertraut sind, der wichtige Informationen zu den Attributen des Elements enthält.

Eine mobile Schaltfläche führt bei Auswahl durch den Benutzer eine einzelne Aktion aus. Sie kann entweder eine Funktion ausführen oder einen Aufgabengereich anzeigen. Jedes Schaltflächensteuerelement muss über einen id Attributwert verfügen, der für alle <Control-Elemente> im Manifest eindeutig ist.

Add-In-Typ: Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Mail 1.1

Der MobileButton-Wert für xsi:type ist im VersionOverrides-Schema 1.1 definiert. Das enthaltende VersionOverrides-Element muss einen xsi:type-Attributwert von VersionOverridesV1_1 aufweisen.

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

Untergeordnete Elemente

Element Erforderlich Beschreibung
Label Ja Der Text für die Schaltfläche.
Icon Ja Ein Bild für die Schaltfläche.
Action Ja Gibt die auszuführende Aktion an. Es kann nur ein <untergeordnetes Action-Element> eines <Control-Elements> sein.

Beschriftung

Gibt den Text für die Schaltfläche mithilfe des einzigen Attributs resid an, das nicht mehr als 32 Zeichen umfassen darf und auf den Wert des id-Attributs eines <String-Elements> im <untergeordneten ShortStrings-Element> des Resources-Elements festgelegt werden muss.

Add-In-Typ: Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

Beispiele

Im folgenden Beispiel führt die Schaltfläche eine Funktion aus.

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

Im folgenden Beispiel zeigt die Schaltfläche einen Aufgabenbereich an.

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