根據應用程序上下文自動選擇圖像

---

立即下載DevExpress WPF

本主題介紹如何根據應用上下文在控件中顯示不同的圖像， app context上下文由一個或多個應用程序和系統設置定義：

• 系統DPI設置
• 應用程序語言（UI 文化）
• 應用程序的
• 觸摸模式可用性

概述

例如，您希望在常規上下文中的控件中顯示“Add.png”圖像，并在系統應用 150% DPI 設置時在同一控件中顯示“Add.scale-150.png”，應在運行時根據當前上下文自動選擇正確的圖像。

DevExpress WPF控件支持基于當前上下文的自動圖像選擇。要啟用此功能，項目中的圖像必須在其名稱中具有專用限定符，或者必須將這些圖像放在名稱包含這些限定符的文件夾中，限定符標識應該在當前上下文中使用的圖像版本。

下面的截圖展示了添加到images文件夾中的五張圖片：

• Add.png”文件是常規圖像。
• “Add.theme-metropolis.png”名稱由常規名稱(“Add”)，限定符名稱(“theme”)和限定符值(“metropolis”)組成，因此它在應用此圖像時識別應用程序上下文(即，當“theme”為“metropolis”時)。
• “Add.theme-metropolis_scale-150.png”名稱包含另一個限定符（“scale”）及其值（150）。
• 其他圖像使用相同的命名符號。

下面的代碼使用QualifiedImage擴展將Add.png圖像分配給工具欄中的按鈕。

xmlns:dxb="http://schemas.devexpress.com/winfx/2008/xaml/bars"
xmlns:dx="http://schemas.devexpress.com/winfx/2008/xaml/core"

<dxb:ToolBarControl>
<dxb:BarButtonItem Glyph="{dx:QualifiedImage Uri=Images/Add.png}" Content="Add"/>
</dxb:ToolBarControl>

QualifiedImage擴展的使用保證了基于當前上下文的自動圖像替換。

• Add.png—— 該圖像將在所有情況下使用，但不包括以下四種縮小應用程序上下文的情況。
• Add.theme-metropolis.png——當應用“MetropolisLight”、“MetropolisDark”或“TouchlineDark”主題時將使用此圖像，但以下情況除外。
• Add.theme-metropolis_scale-150.png——當應用“MetropolisLight”、“MetropolisDark”或“TouchlineDark”主題時，系統DPI設置為150%時將使用此圖像。
• Add.theme-office.png——當應用任何名稱中包含“Office”的主題時，將應用此圖像，但以下情況除外。
• Add.theme-office_input-touch.png ——當應用名稱中包含“Office”的任何觸摸感知主題時，將使用此圖像。這些主題是：“Office2013;Touch”、“Office2013LightGray;Touch”和“Office2013DarkGray;Touch”。

您可以將圖像放置在名稱包含這些限定符的文件夾中來替代在圖像名稱中使用限定符。上面顯示的圖像可以放置在文件夾中，如下所示。

QualifiedImage擴展必須指定與常規上下文對應的圖像的完整路徑，對于上面的截圖，這個路徑必須是Images/Add.png：

...
<dxb:BarButtonItem Glyph="{dx:QualifiedImage Uri=Images/Add.png}" Content="Add"/>arkGray;Touch”。

命名約定

要在圖像名稱中使用限定符，請使用以下命名約定。

若要在文件夾名稱中使用限定符，請使用以下命名約定。

您可以通過同時在文件夾和圖像名稱中使用限定符來組合這兩種方法。

文件夾/ lang-en-US / file.theme-office.png

以下部分將描述可用的限定符及其值。

主題限定詞

下表涵蓋了主題限定符和支持的限定符值。

DPI設置限定符

下表涵蓋了DPI設置限定符。

應用語言(文化)限定詞

下表涵蓋了應用程序語言(區域性)限定符。