visual (タイル スキーマ)

  • [アーティクル]

複数の バインド 子要素が含まれており、それぞれがタイルを定義します。

要素の階層

<tile>
<visual>

構文

<visual version?       = integer
        lang?          = string
        baseUri?       = anyURI
        branding?      = "none" | "logo" | "name"
        addImageQuery? = boolean
        contentId?     = string >

  <!-- Child elements -->
  binding+

</visual>

キー

? 省略可能 (0 または 1) + 必須 (1 つ以上)

属性および要素

属性

属性 説明 データ型 必須 既定値
addImageQuery

タイル通知で指定されたイメージ URI にクエリ文字列を追加できるようにするには、 true に設定します。 この属性は、サーバーが画像をホストしていてクエリ文字列を処理できる場合に使用します。サーバーがこのために、クエリ文字列に基づいて画像の変化形を取得しているか、またはクエリ文字列を無視して使わずに指定の画像を返しているかどうかは問いません。 このクエリ文字列は、スケール、コントラストの設定、言語を指定します。たとえば、 の値

"www.website.com/images/hello.png"

通知に含まれる

"www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

 boolean いいえ false
Baseuri

イメージ ソース属性の相対 URI と組み合わせた既定のベース URI。

 anyURI いいえ ms-appx:///
ブランド

アプリのブランドを表示するためにタイルで使用されるフォームです。

この属性は、次のいずれかの値になります。

  • なし
  • ロゴ
  • name
 いいえ なし
contentId

通知の内容を一意に識別する送信者定義の文字列に設定します。 これにより、大きなタイル テンプレートで最後の 3 つのワイド タイル通知が表示される状況での重複を防ぐことができます。

 string いいえ なし
ラング

"en-US" や "fr-FR" などの BCP-47 言語タグとして指定された XML ペイロードのターゲット ロケール。 このロケールは、 バインディング または テキストで指定されたロケールによってオーバーライドされます。 この値がリテラル文字列の場合、この属性の既定値はユーザーの UI 言語になります。 この値が文字列リファレンスの場合、この属性の既定値は、文字列を解決する際に Windows ランタイムで選択されたロケールになります。 この値が指定されていない場合の備考に関するページを参照してください。

 string いいえ なし
version

この特定のペイロードが開発されたタイル XML スキーマのバージョン。 1 または 2 の 2 つの値を指定できます。 バージョン 1 には、Windows 8 スキーマの有効なペイロードが必要です。 バージョン 2 では、新しい大きなタイル テンプレート、既存のテンプレートの新しいWindows 8.1テンプレート名、およびバインド要素のフォールバック属性が認識されます。

 整数 (integer) いいえ 1

 

子要素

子要素 説明
binding

タイル テンプレートを指定します。 すべての通知には、サポートされているタイル サイズごとに 1 つのバインド要素が含まれている必要があります。

 

親要素

Parent 要素 説明
tile

単一の ビジュアル 要素を含む基本タイル要素。

 

注釈

次の表では、lang が指定されていない場合のシステムの応答について説明します。

For... システム応答
通知の言語
  • 明示的に設定する場合は、visual.lang または binding.lang を使用します
  • それ以外の場合、アプリ固有の言語設定 ([Resource Management System](/previous-versions/windows/apps/jj552947(v=win.10)) が現在の言語プロファイルでアプリを実行することを決定する言語 (存在する場合)
  • それ以外の場合は、Windows ランタイムによって解決されたタイルの表示名の言語
  • それ以外の場合、シェルの UI 言語 (MUI 言語)

この言語は主に、列を特徴とするテンプレート内の列のレイアウトに影響します。
リテラル テキストを含むテキスト要素
  • 明示的に設定する場合は、visual.lang または binding.lang を使用します
  • それ以外の場合、アプリ固有の言語設定 ([Resource Management System](/previous-versions/windows/apps/jj552947(v=win.10)) が現在の言語プロファイルでアプリを実行することを決定する言語 (存在する場合)
  • それ以外の場合は、Windows ランタイムによって解決されたタイルの表示名の言語
  • それ以外の場合は、シェルの UI 言語 (MUI 言語)
ms-resource コンテンツを含むテキスト要素
  • 明示的に設定する場合は、visual.lang または binding.lang を使用し、明示的な言語が言語リストの前に追加されます。リソース管理システムの [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) を使用して文字列を解決します
  • それ以外の場合、ユーザーの言語プロファイルで初期化されたとして使用される [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext)

文字列が解決されると、解決された文字列の言語がテキスト要素に割り当てられます。 この言語は、UI のテキストの配置 (LTR と RTL) とフォントの選択を調整します。
ms-appx:/// image
  • 明示的に設定する場合は、visual.lang または binding.lang を使用します。明示的な言語は、文字列の解決に使用されるリソース管理システムの [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) の言語リストの前に追加されます。
  • それ以外の場合は、[ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) をユーザーの言語プロファイルで初期化して使用します
クラウド イメージ
  • 明示的に設定する場合は、visual.lang または binding.lang を使用します
  • それ以外の場合、アプリ固有の言語設定 ([Resource Management System](/previous-versions/windows/apps/jj552947(v=win.10)) が現在の言語プロファイルでアプリを実行することを決定する言語 (存在する場合)
  • それ以外の場合は、Windows ランタイムによって解決されたタイルの表示名の言語 (名前が言語に依存しない場合は設定されない可能性があります)
  • それ以外の場合、シェルの UI 言語 (MUI 言語)

addImageQuery が true の場合、この言語はクエリ文字列に含まれます。

 

要件

値
Namespace http://schemas.microsoft.com/notifications/2012/tile.xsd