Share via

PROCESS_DPI_AWARENESS列舉 (殼層calingapi.h)

  • 發行項

識別每英吋點 (dpi) 感知值。 DPI 感知表示應用程式針對 DPI 執行多少縮放比例，以及由系統執行多少調整。

用戶能夠將 DPI 縮放比例設定在其顯示器上彼此獨立。 某些舊版應用程式無法針對多個 DPI 設定調整其縮放比例。 為了讓使用者使用這些應用程式，而內容在顯示器上顯示太大或太小，Windows 可以將 DPI 虛擬化套用至應用程式，使系統自動調整它以符合目前顯示器的 DPI。 PROCESS_DPI_AWARENESS值表示應用程式自行處理的調整層級，以及 Windows 提供多少。 請記住，由系統調整的應用程式可能會變得模糊，而且會讀取有關監視器的虛擬化數據，以維持相容性。

Syntax

typedef enum PROCESS_DPI_AWARENESS {
  PROCESS_DPI_UNAWARE = 0,
  PROCESS_SYSTEM_DPI_AWARE = 1,
  PROCESS_PER_MONITOR_DPI_AWARE = 2
} ;

常數

 
PROCESS_DPI_UNAWARE
值： 0
DPI 未察覺。 此應用程式不會調整 DPI 變更，且一律假設縮放比例為 100% (96 DPI) 。 系統會在任何其他 DPI 設定上自動調整。
PROCESS_SYSTEM_DPI_AWARE
值： 1
系統 DPI 感知。 此應用程式不會針對 DPI 變更進行調整。 它會查詢 DPI 一次，並在應用程式的存留期內使用該值。 如果 DPI 變更，應用程式將不會調整為新的 DPI 值。 當 DPI 從系統值變更時，系統會自動相應增加或減少。
PROCESS_PER_MONITOR_DPI_AWARE
值： 2
每部監視器 DPI 感知。 此應用程式會在建立 DPI 時檢查 DPI，並在 DPI 變更時調整縮放比例。 系統不會自動調整這些應用程式。

備註

重要  

舊版 Windows 需要您設定整個應用程式的 DPI 感知。 現在 DPI 感知會系結至個別線程、進程或視窗。 這表示當應用程式執行時，DPI 感知可能會變更，而且多個視窗可以有自己的獨立 DPI 感知值。 如需 DPI 感知目前運作方式的詳細資訊 ，請參閱DPI_AWARENESS 。 下列有關在應用程式指令清單中設定 DPI 感知的建議仍受支援，但目前的建議是使用 DPI_AWARENESS_CONTEXT。

 
應用程式的 DPI 感知應該透過應用程式指令清單來設定，以便在採取任何取決於系統 DPI 的動作之前決定。 或者，您也可以使用 SetProcessDpiAwareness 來設定 DPI 感知，但如果您這麼做，您必須先確定設定它，再採取任何相依於系統 DPI 的動作。 設定進程的 DPI 感知之後，就無法變更它。
秘訣  

如果您的應用程式 PROCESS_DPI_UNAWARE，則不需要在應用程式指令清單中設定任何值。 除非指定其他值，否則PROCESS_DPI_UNAWARE是應用程式的預設值。

 
PROCESS_DPI_UNAWARE 和 PROCESS_SYSTEM_DPI_AWARE 應用程式不需要回應 WM_DPICHANGED ，而且不應該處理 DPI 中的變更。 當 DPI 變更時，系統會自動相應增加或減少這些類型的應用程式。 PROCESS_PER_MONITOR_DPI_AWARE 應用程式負責辨識和回應 DPI 中的變更， WM_DPICHANGED發出訊號。 這些不會由系統調整。 如果此類型的應用程式不會調整視窗及其內容的大小，當視窗從一個顯示器移到另一個具有不同 DPI 設定的顯示器時，相對 DPI 變更就會顯示或縮小。
秘訣  

在舊版 Windows 中，沒有 設定PROCESS_PER_MONITOR_DPI_AWARE。 應用程式不是 DPI 感知或 DPI 感知。 在 Windows 8.1 之前分類為 DPI 感知的舊版應用程式會被視為在目前版本的 Windows 中具有PROCESS_SYSTEM_DPI_AWARE PROCESS_DPI_AWARENESS設定。

 
若要瞭解不同 DPI 感知值的重要性和影響，請考慮有三個顯示器的使用者：A、B 和 C。顯示 A 設為 100% 縮放比例， (96 DPI) ，顯示 B 會設定為 200% 縮放比例， (192 DPI) ，而顯示 C 設定為 300% 縮放比例， (288 DPI) 。 系統 DPI 設定為 200%。

PROCESS_DPI_UNAWARE的應用程式一律會使用縮放比例 100% (96 DPI) 。 在此案例中，會建立 PROCESS_DPI_UNAWARE 視窗，大小為 500 到 500。 在顯示 A 時，它會以原生方式轉譯，而不需要縮放比例。 在顯示 B 和 C 上，系統會自動相應增加 2 和 3 的因數。 這是因為 PROCESS_DPI_UNAWARE 一律假設 DPI 為 96，而系統帳戶則為 。 如果應用程式查詢視窗大小，無論視窗大小為何，它一律會取得 500 到 500 的值。 如果此應用程式要求三個監視器的任何一個 DPI，它會收到 96 個。

現在請考慮PROCESS_SYSTEM_DPI_AWARE的應用程式。 請記住，在範例中，系統 DPI 為 200% 或 192 DPI。 這表示此應用程式所建立的任何視窗都會在顯示 B 上以原生方式呈現。視窗會移至顯示 A，它會自動相應減少 2。 這是因為此案例中的 PROCESS_SYSTEM_DPI_AWARE 應用程式假設 DPI 一律為 192。 它會在啟動時查詢 DPI，然後永遠不會變更它。 當移至顯示 A 時，系統會自動相應減少。同樣地，如果視窗移至顯示 C，系統會自動相應增加 1.5。 如果應用程式查詢視窗大小，它一律會取得相同的值，類似於 PROCESS_DPI_UNAWARE。 如果它要求三個監視器中的任何一個 DPI，它會收到 192。

不同於其他感知值， PROCESS_PER_MONITOR_DPI_AWARE 應該適應其開啟的顯示。 這表示它一律會以原生方式轉譯，而且永遠不會由系統調整。 在收到 WM_DPICHANGED 訊息時，應用程式會負責調整縮放比例。 此訊息的一部分包含窗口的建議 Rect。 這項建議是從舊 DPI 值調整為新 DPI 值的目前視窗。 例如，在顯示 A 上為 500 到 500 的視窗，並移至顯示 B 時，會收到建議的視窗矩形，也就是 1000 到 1000。 如果該相同的視窗移至顯示 C，則附加至 WM_DPICHANGED 的建議視窗會是 1500 到 1500。 此外，當此應用程式查詢窗口大小時，它一律會取得實際的原生值。 同樣地，如果它要求三個監視器的任何一個 DPI，則分別會收到 96、192 和 288。

由於 DPI 虛擬化，如果某個應用程式以不同的 DPI 相依資訊感知層級查詢另一個應用程式，系統會自動調整值，以符合呼叫者的感知層級。 其中一個範例是，如果您呼叫 GetWindowRect ，並傳入另一個應用程式所建立的視窗。 使用上述情況，假設 PROCESS_DPI_UNAWARE 應用程式在顯示 C 時建立了 500 到 500 個視窗。如果您從不同的應用程式查詢視窗矩形，rect 的大小會根據應用程式的 DPI 感知而有所不同。

PROCESS_DPI_UNAWARE 您將得到 500 到 500 個 rect，因為系統會假設 DPI 為 96，並自動將實際縮小比例為 3。
PROCESS_SYSTEM_DPI_AWARE 您將取得 1000 到 1000 個 rect，因為系統會假設 DPI 為 192，並依 3/2 比例自動相應減少實際調整。
PROCESS_PER_MONITOR_DPI_AWARE 您將取得 1500 到 1500 個矩形，因為系統會使用顯示器的實際 DPI，而不會在幕後進行任何縮放。
 

範例

此代碼段示範如何在應用程式指令清單中設定 PROCESS_SYSTEM_DPI_AWARE 值。

<dpiAware>true</dpiAware>

此代碼段示範如何在應用程式指令清單中設定 PROCESS_PER_MONITOR_DPI_AWARE 值。

<dpiAware>true/PM</dpiAware>

規格需求

需求 值
最低支援的用戶端 Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 R2 [僅限傳統型應用程式]
標頭 shellscalingapi.h

另請參閱

DPI_AWARENESS