text (トースト XML スキーマ)
トースト テンプレートで使用されるテキストを指定します。
要素の階層
構文
<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++) で参照されます。
詳細については、「 タイルのグローバル化: ローカライズ、スケーリング、アクセシビリティ」を参照してください。
こちらもご覧ください