action (トースト XML スキーマ)

  • [アーティクル]

トーストに表示されるボタンを指定します。

要素の階層

<トースト>
<アクション>
<入力>

構文

<action content = string
    arguments = string
    activationType? = "foreground" | "background" | "protocol"
    afterActivationBehavior? = "default" | "pendingUpdate"
    placement? = "contextMenu"
    imageUri? = string
    hint-inputid = string
    hint-buttonStyle = "Success" | "Critical"
    hint-toolTip = string
/>

キー

? 省略可能 (0 または 1)

属性および要素

属性

属性 説明 データ型 必須 既定値
content ボタンに表示されるコンテンツ。 string はい なし
arguments ユーザーがこのボタンをクリックした場合にアプリが後から受け取る、アプリで定義された引数の文字列です。 string はい なし
型 関連付けられたアプリに渡すことができる引数文字列。ユーザー アクションに応答して実行する必要があるアクションに関する詳細を提供します。 string はい なし
activationType ユーザーが特定の操作を行った際に使用されるアクティブ化の種類を決定します。
  • "foreground" - 既定値。 フォアグラウンド アプリが起動します。
  • "background" - 対応するバックグラウンド タスクがトリガーされ、ユーザーを中断することなくバックグラウンドでコードを実行できます。
  • "protocol" - プロトコルのアクティブ化を使用して別のアプリを起動します。
 string いいえ "フォアグラウンド"
afterActivationBehavior ユーザーがトーストに対して操作を行ったときに、トーストが使用する動作を指定します。
  • "default" - 既定値。 ユーザーがトーストに対して操作を行うと、トーストが無視されます。
  • "pendingUpdate" - ユーザーがトースト上のボタンをクリックすると、通知は "保留中の更新" 表示状態のままです。 この "更新の保留中" の表示状態が長時間続くことを避けるため、バックグラウンド タスクから即座にトーストを更新する必要があります。
 string いいえ "default"
配置 "contextMenu" に設定すると、アクションは、従来のトースト ボタンではなく、トースト通知のコンテキスト メニューに追加されたコンテキスト メニュー アクションになります。 string いいえ なし
imageUri トースト ボタン アイコンのイメージ ソースの URI。 これらのアイコンは、100% のスケーリングで白い透明な 16 x 16 ピクセルの画像であり、画像自体にパディングを含めてはいけません。 トースト通知にアイコンを表示する場合、ボタンのスタイルがアイコン ボタンに変更されるため、通知内のすべてのボタンに対してアイコンを表示する必要があります。 次のいずれかのプロトコル ハンドラーを使用します。
  • http:// または https:// - Web ベースのイメージ。
  • ms-appx:/// - アプリ パッケージに含まれるイメージ。
  • ms-appdata:///local/ - ローカル ストレージに保存されたイメージ。
  • file:/// - ローカル イメージ。 (デスクトップ アプリでのみサポートされます。このプロトコルは、UWP アプリでは使用できません)。)
 string いいえ なし
hint-inputId 入力の横にある [位置への 入力 ] ボタンの ID に設定します。 string いいえ なし
hint-buttonStyle ボタンのスタイル。 トースト要素では、useButtonStyle を true に設定する必要があります。
  • "成功" - ボタンが緑色です
  • "クリティカル" - ボタンが赤です。
これらの値では、大文字と小文字が区別されます。		 string いいえ なし
hint-toolTip ボタンに空のコンテンツ文字列がある場合のボタンのヒント。 string いいえ なし

子要素

なし

親要素

Parent 要素 説明
actions トースト通知に対して最大 5 つの入力と最大 5 つのボタン アクションを宣言するための Container 要素。

こちらもご覧ください