MobileButton 型のコントロール要素

アクションの実行や作業ウィンドウの起動を行い、モバイル プラットフォームでのみ表示されるボタンを定義します。

注:

この記事は、要素の属性に関する重要な情報を含む基本的な コントロール リファレンス記事 に精通していることを前提としています。

モバイル ボタンは、ユーザーが選択したときに 1 つのアクションを実行します。 関数を実行するか、作業ウィンドウを表示します。 各ボタン コントロールには、マニフェスト内のすべての <Control> 要素の中で一意の id 属性値が必要です。

アドインの種類: メール

次の VersionOverrides スキーマでのみ有効です:

  • メール 1.1

MobileButton の 値は、VersionOverrides スキーマ 1.1 で定義されます。 これを収容している VersionOverrides 要素は、xsi:type 属性の値が VersionOverridesV1_1 になっている必要があります。

詳細については、「 アドインのみのマニフェストのバージョンのオーバーライド」を参照してください。

次の要件セットに関連付けられています:

子要素

要素 必須 説明
Label はい ボタンのテキストです。
Icon はい ボタンの画像です。
Action はい 実行するアクションを指定します。 <Control> 要素の <Action> 子は 1 つだけ存在できます。

Label

唯一の属性 resid を使用してボタンのテキストを指定します。resid は 32 文字以内であり、Resources 要素の子である <ShortStrings> 要素の <String> 要素の id 属性の値に設定する必要があります。

アドインの種類: メール

次の VersionOverrides スキーマでのみ有効です:

  • メール 1.1

詳細については、「 アドインのみのマニフェストのバージョンのオーバーライド」を参照してください。

次の要件セットに関連付けられています:

例

次の例では、ボタンによって機能が実行されます。

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

次の例では、ボタンによって作業ウィンドウが表示されます。

<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