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

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

DevExpress WPF v21.1高速下載

概述

例如，您希望在常規上下文控件中顯示“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 圖像分配給工具欄中的按鈕。

XAML

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”：

XAML

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

命名約定

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

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

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

folder/lang-en-US/file.theme-office.png

DevExpress WPF | 下載試用

DevExpress WPF擁有120+個控件和庫，將幫助您交付滿足甚至超出企業需求的高性能業務應用程序。通過DevExpress WPF能創建有著強大互動功能的XAML基礎應用程序，這些應用程序專注于當代客戶的需求和構建未來新一代支持觸摸的解決方案。 無論是Office辦公軟件的衍伸產品，還是以數據為中心的商業智能產品，都能通過DevExpress WPF控件來實現。

DevExpress技術交流群4：715863792      歡迎一起進群討論