根據(jù)應(yīng)用程序上下文自動(dòng)選擇圖像

---

立即下載DevExpress WPF

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

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

概述

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

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

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

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

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

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

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

 QualifiedImage擴(kuò)展必須指定與常規(guī)上下文對(duì)應(yīng)的圖像的完整路徑，對(duì)于上面的截圖，這個(gè)路徑必須是Images/Add.png：

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

命名約定

要在圖像名稱中使用限定符，請(qǐng)使用以下命名約定。

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

您可以通過(guò)同時(shí)在文件夾和圖像名稱中使用限定符來(lái)組合這兩種方法。

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

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

主題限定詞

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

DPI設(shè)置限定符

下表涵蓋了DPI設(shè)置限定符。

應(yīng)用語(yǔ)言(文化)限定詞

下表涵蓋了應(yīng)用程序語(yǔ)言(區(qū)域性)限定符。