視覺效果 (磚架構)

  • 發行項

包含多個 系結 子專案，每個專案都會定義圖格。

元素階層

<瓦>
<視覺>

Syntax

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

  <!-- Child elements -->
  binding+

</visual>

答案

? (一或多個) + (選用 (零或一個)

屬性和項目

屬性

屬性 描述 資料類型 必要 預設值
addImageQuery

設定為 true 可讓 Windows 將查詢字串附加至磚通知中提供的圖像 URI。 如果您的伺服器裝載影像，並且可以處理查詢字串 (方式為根據查詢字串擷取影像變體，或忽略查詢字串並傳回未使用查詢字串所指定的影像)，請使用此屬性。 此查詢字串會指定縮放比例、對比設定和語言;例如， 的值

“www.website.com/images/hello.png”

包含在通知中會變成

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

 boolean No false
baseUri

與影像來源屬性中相對 URI 結合的預設基底 URI。

 anyURI No ms-appx:///
品牌

磚應用來顯示應用程式品牌的表單。

此屬性可以有下列其中一個值：

  • 無
  • 標誌
  • NAME
 否 無
contentId

設定為可唯一識別通知內容的寄件者定義字串。 這可防止大型磚範本顯示最後三個寬磚通知的情況重複。

 字串 No 無
朗

XML 承載的目標地區設定，指定為 BCP-47 語言標籤 ，例如 “en-US” 或 “fr-FR”。 系結或文字中指定的任何地區設定會覆寫此地區設定。 如果此值為常值字串，則此屬性預設為使用者的 UI 語言。 如果此值為字串參考，則此屬性預設為 Windows 執行階段在解析字串時所選擇的地區設定。 如需未指定此值的時機，請參閱。

 字串 No 無
version

此特定承載所開發的磚 XML 架構版本。 它可以有兩個值：1 或 2。 第 1 版需要 Windows 8 架構下的有效承載。 第 2 版會辨識新的大型磚範本、現有範本的新 Windows 8.1 範本名稱，以及綁定項的後援屬性。

 整數 No 1

 

子元素

子元素 描述
繫結

指定磚範本。 每個通知都應該為每個支援的磚大小包含一個綁定項。

 

父項目

Parent 項目 Description
瓦

基底圖格元素，其中包含單一 視覺 元素。

 

備註

下表說明未指定 lang 時，系統如何回應。

如需... 系統回應
通知的語言
  • 如果明確設定，請使用visual.lang或binding.lang
  • 否則應用程式特定語言設定 (語言，如果有的話，[資源管理系統] (/previous-versions/windows/apps/jj552947 (v=win.10) ) 會決定應用程式將在目前的語言配置檔中執行)
  • 否則，Windows 執行階段 解析磚上的顯示名稱語言
  • 否則殼層的UI語言 (MUI 語言)

此語言主要會影響功能數據行之範本中的數據行配置。
具有常值文字的文字元素
  • 如果明確設定，請使用visual.lang或binding.lang
  • 否則應用程式特定語言設定 (語言，如果有的話，[資源管理系統] (/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) 以使用者的語言配置檔初始化

解析字串之後，已解析字串的語言會指派給 text 元素。 此語言會 (LTR 與 RTL) 和 UI 字型選擇來塑造文字對齊。
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
  • 否則，應用程式特定語言設定 (語言，如果有的話，[資源管理系統] (/previous-versions/windows/apps/jj552947 (v=win.10) ) 會決定應用程式將在指定的目前語言配置檔中執行)
  • 否則，如果名稱是語言中性) ，則可能無法設定磚上 Windows 執行階段 (解析的顯示名稱語言
  • 否則殼層的UI語言 (MUI 語言)

如果 addImageQuery 為 true，此語言會包含在查詢字串中。

 

規格需求

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