本篇教程主要介紹如何根據(jù)應(yīng)用上下文在控件中顯示不同的圖像，應(yīng)用上下文由一個或多個應(yīng)用程序和系統(tǒng)設(shè)置定義：

• 系統(tǒng) DPI 設(shè)置；
• 應(yīng)用程序語言（UI 文化）；
• 應(yīng)用程序的繪畫主題；
• 觸摸模式可用性。

DevExpress WPF v21.1高速下載

概述

例如，您希望在常規(guī)上下文控件中顯示“Add.png”圖像，并在將150% DPI設(shè)置應(yīng)用于系統(tǒng)時在同一控件中顯示“Add.scale-150.png”，應(yīng)該在運(yùn)行時根據(jù)當(dāng)前上下文自動選擇正確的圖像。

DevExpress WPF控件支持基于當(dāng)前上下文的自動圖像選擇，要啟用此功能，項(xiàng)目中的圖像必須在其名稱中包含專用限定符，或者這些圖像必須放置在名稱包含這些限定符的文件夾中，限定符標(biāo)識應(yīng)在當(dāng)前上下文中使用的圖像版本。

考慮以下屏幕截圖，展示添加到Images文件夾中的五個圖像：

• “Add.png”文件是一個常規(guī)圖像。
• “Add.theme-metropolis.png”名稱由常規(guī)名稱（“Add”）、限定符名稱（“theme”）和限定符值（“metropolis”）組成，因此它在此圖像被加載時標(biāo)識了應(yīng)用程序上下文 應(yīng)用（即當(dāng)“theme”是“metropolis”時）。
• “Add.theme-metropolis_scale-150.png”名稱包括另一個限定符（“scale”）及其值（150）。
• 其他圖像使用相同的命名符號。

以下代碼使用 QualifiedImage 擴(kuò)展將 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擴(kuò)展的使用保證了基于當(dāng)前上下文的自動圖像替換。

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

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

QualifiedImage 擴(kuò)展必須指定對應(yīng)于常規(guī)上下文圖像的完整路徑，對于上面的截圖，這個路徑必須是“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+個控件和庫，將幫助您交付滿足甚至超出企業(yè)需求的高性能業(yè)務(wù)應(yīng)用程序。通過DevExpress WPF能創(chuàng)建有著強(qiáng)大互動功能的XAML基礎(chǔ)應(yīng)用程序，這些應(yīng)用程序?qū)Ｗ⒂诋?dāng)代客戶的需求和構(gòu)建未來新一代支持觸摸的解決方案。 無論是Office辦公軟件的衍伸產(chǎn)品，還是以數(shù)據(jù)為中心的商業(yè)智能產(chǎn)品，都能通過DevExpress WPF控件來實(shí)現(xiàn)。

DevExpress技術(shù)交流群4：715863792      歡迎一起進(jìn)群討論