對語言、縮放比例及高對比的磚與快顯通知支援

  • 發行項

您的磚和快顯可以載入針對顯示語言、顯示縮放比例、高對比度和其他執行階段內容量身打造的字串和影像。 若要了解如何在資源檔案的名稱中使用限定條件的背景，請參閱針對語言、規模和其他限定條件客製化您的資源和應用程式圖示和標誌。

如需有關將您的應用程式當地語系化的價值主張的詳細資訊，請參閱全球化和當地語系化。

從範本參考字串資源

在磚或快顯範本中，您可以使用 ms-resource URI (統一資源識別元) 結構描述後面接著簡單的字串資源識別元來參考字串資源。 例如，如果您的 Resources.resx 檔案包含名稱為 “Farewell” 的資源項目，則您的字串資源識別元為 “Farewell”。 如需字串資源識別元和資源檔案 (.resw) 的詳細資訊，請參閱將 UI 和應用程式套件資訊清單中的字串當地語系化。

這是使用 ms-resource 時，您範本內容的文字本文中參考 "Farewell" 字串資源識別元的方式。

<text id="1">ms-resource:Farewell</text>

如果您省略 ms-resource URI 結構描述，則文字本文就只是字串常值，而不是識別元的參考。

<text id="1">Farewell</text>

從範本參考影像資源

在磚或快顯範本中，您可以使用 ms-appx URI (統一資源識別元) 結構描述後面接著影像資源的名稱來參考影像資源。 此方式與您在 XAML 標記中參考影像資源的方式相同 (如需詳細資料，請參閱參考 XAML 標記和程式碼中的影像或其他資產)。

例如，您可能會像這樣命名資料夾。

\Assets\Images\contrast-standard\welcome.png
\Assets\Images\contrast-high\welcome.png

在該案例中，您擁有單一影像資源，且其名稱 (以絕對路徑形式表示) 為 /Assets/Images/welcome.png。 以下說明如何在您的範本中使用該名稱。

<image id="1" src="ms-appx:///Assets/Images/welcome.png"/>

特別注意在此範例 URI 中，結構描述 ("ms-appx") 後面接著 “://"，然後再接著絕對路徑 (絕對路徑開頭為 “/")。

在雲端裝載和載入影像

ms-resource 和 ms-appx URI 結構描述會執行自動化限定條件比對，以找出最適合目前內容的資源。 Web URI 結構描述 (例如 http、https 和 ftp) 不會執行任何這類自動比對。

而是改為將描述所要求限定條件的一或多個值的查詢字串附加至您影像的 URI。

<image id="1" src="http://www.contoso.com/Assets/Images/welcome.png?ms-lang=en-US"/>

接著在提供影像的應用程式服務中實作 HTTP 處理常式，以檢查並使用查詢字串來判斷要傳回的影像。

您也需要在磚或快顯通知 XML 承載中，將 addImageQuery 屬性設定為 true。 addImageQuery 屬性會同時出現在磚和快顯結構描述的 visual、binding 和 image 元素中。 在元素上明確設定 addImageQuery 會覆寫上階中設定的任何值。 例如，image 元素中 true 的 addImageQuery 值會覆寫其父 binding 元素的 false 中的 addImageQuery。

您可以使用這些查詢字串。

Qualifier 查詢字串 範例
調整 ms-scale ?ms-scale=400
語言 ms-lang ?ms-lang=en-US
對比 ms-contrast ?ms-contrast=high

如需可在查詢字串中使用的所有可能限定條件值的參考表，請參閱 ResourceContext.QualifierValues。

重要 API