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

トースト テンプレートで使用されるテキストを指定します。

要素の階層

<トースト>

<Visual>

<binding>

<テキスト>

構文

<text id    = integer
      lang? = string 
      placement? = "attribution"
      hint-callScenarioCenterAlign? = boolean />

キー

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

属性および要素

属性

属性	説明	データ型	必須	既定値
id	このテキストが意図されているトースト テンプレート内の text 要素。 テンプレートにテキスト要素が 1 つしかない場合、この値は 1 です。 使用可能なテキスト位置の数は、テンプレート定義に基づいています。	整数 (integer)	はい	なし
ラング	"en-US" や "fr-FR" などの BCP-47 言語タグとして指定された XML ペイロードのターゲット ロケール。 ここで指定したロケールは、 バインディング またはビジュアルで指定されたその他のロケールをオーバーライド します。 この値がリテラル文字列の場合、この属性の既定値はユーザーの UI 言語になります。 この値が文字列リファレンスの場合、この属性の既定値は、文字列を解決する際に Windows ランタイムで選択されたロケールになります。	string	いいえ	なし
placement	テキストの配置。 Anniversary Update で導入されました。 値 "attribution" を指定すると、テキストは常に通知の下部に、アプリの ID または通知のタイムスタンプと共に表示されます。 属性テキストをサポートしていない以前のバージョンの Windows では、テキストは単に別のテキスト要素として表示されます (3 つのテキスト要素を最大限に含めていない場合)。 詳細については、「 トースト コンテンツ」を参照してください。	string	いいえ	なし
hint-callScenarioCenterAlign	着信通知のテキストを中央に配置するには、"true" に設定します。 この値は、 シナリオ 値が "incomingCall" の通知にのみ使用されます。それ以外の場合は無視されます。 詳細については、「 トースト コンテンツ」を参照してください。	boolean	いいえ	なし

 

子要素

なし。

親要素

Parent 要素	説明
binding	トースト テンプレートを指定します。 トースト通知に含めることができるバインド要素は 1 つだけであることに注意してください。

 

注釈

テキスト要素の本文は、次の 2 つの方法で表すことができます。

• リテラル文字列として。たとえば、 <text id="1">Hello world!</text>。
• 文字列参照として、"ms-resource" プレフィックスを使用します。たとえば、 <text id="1"> ms-resource:hello</text> です。 "ms-resource" プレフィックスを使用する場合、文字列識別子はアプリの Resources.resjson (JavaScript を使用する Windows アプリ) または Resources.resw ファイル (C#/C++) で参照されます。

詳細については、「 タイルのグローバル化: ローカライズ、スケーリング、アクセシビリティ」を参照してください。

こちらもご覧ください

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