DPI_HOSTING_BEHAVIOR列挙 (windef.h)

  • [アーティクル]

ウィンドウの DPI ホスティング動作を識別します。 この動作により、スレッドで作成されたウィンドウは、別のDPI_AWARENESS_CONTEXTを持つ子ウィンドウをホストできます。

構文

typedef enum DPI_HOSTING_BEHAVIOR {
  DPI_HOSTING_BEHAVIOR_INVALID = -1,
  DPI_HOSTING_BEHAVIOR_DEFAULT = 0,
  DPI_HOSTING_BEHAVIOR_MIXED = 1
} ;

定数

 
DPI_HOSTING_BEHAVIOR_INVALID
値: -1
DPI ホスティング動作が無効です。 これは通常、前の SetThreadDpiHostingBehavior 呼び出しで無効なパラメーターが使用された場合に発生します。
DPI_HOSTING_BEHAVIOR_DEFAULT
値: 0
既定の DPI ホスティング動作。 関連付けられたウィンドウは通常どおりに動作し、別の DPI_AWARENESS_CONTEXTを持つ親の子ウィンドウを作成または再び作成することはできません。
DPI_HOSTING_BEHAVIOR_MIXED
値: 1
混合 DPI ホスティング動作。 これにより、異なるDPI_AWARENESS_CONTEXTを持つ子ウィンドウの作成と再親化 が可能になります。 これらの子ウィンドウは、OS によって個別にスケーリングされます。

解説

DPI_HOSTING_BEHAVIOR では、混合コンテンツ ホスティング動作が有効になります。これにより、スレッドで作成された親ウィンドウで、異なる DPI_AWARENESS_CONTEXT 値を持つ子ウィンドウをホストできます。 このプロパティは、混合ホスティング動作がアクティブな間に、このスレッド内に作成された新しいウィンドウにのみ影響します。 このホスティング動作を持つ親ウィンドウでは、子ウィンドウのホスティング動作が混在しているかどうかに関係なく、異なる DPI_AWARENESS_CONTEXT 値を持つ子ウィンドウをホストできます。

このホスティング動作では、モニターごとの DPI_AWARENESS_CONTEXT 値を持つウィンドウを、システムまたは認識しない DPI_AWARENESS_CONTEXT 値を持つウィンドウでホストすることはできません。

予期しない結果を回避するには、スレッドの DPI_HOSTING_BEHAVIOR を変更して、それらの動作をサポートする必要がある新しいウィンドウを作成する場合にのみ、混合ホスティング動作をサポートする必要があります。 そのウィンドウが作成されたら、ホスティング動作を既定値に戻す必要があります。

混合ホスティング動作を有効にした場合、スレッドの DPI_AWARENESS_CONTEXT がレガシ コンテンツと互換性を持つように自動的に調整されることはありません。 このようなコンテンツをホストするために新しいウィンドウを作成する前に、スレッドの認識コンテキストを手動で変更する必要があります。

要件

   
サポートされている最小のクライアント Windows 10バージョン 1803 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2016 [デスクトップ アプリのみ]
Header windef.h

関連項目

GetThreadDpiHostingBehavior

GetWindowDpiHostingBehavior

SetThreadDpiHostingBehavior