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 要素。

こちらもご覧ください

• トーストのコンテンツ
• Notifications Visualizer