Freigeben über

DPI_HOSTING_BEHAVIOR-Enumeration (windef.h)

  • Artikel

Gibt das DPI-Hostingverhalten für ein Fenster an. Dieses Verhalten ermöglicht es im Thread erstellten Fenstern, untergeordnete Fenster mit einem anderen DPI_AWARENESS_CONTEXT

Syntax

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

Konstanten

 
DPI_HOSTING_BEHAVIOR_INVALID
Wert: -1
Ungültiges DPI-Hostingverhalten. Dies tritt in der Regel auf, wenn der vorherige SetThreadDpiHostingBehavior-Aufruf einen ungültigen Parameter verwendet hat.
DPI_HOSTING_BEHAVIOR_DEFAULT
Wert: 0
Standard-DPI-Hostingverhalten. Das zugeordnete Fenster verhält sich wie normal und kann keine untergeordneten Fenster mit einem anderen DPI_AWARENESS_CONTEXT erstellen oder neu übergeordnet werden.
DPI_HOSTING_BEHAVIOR_MIXED
Wert: 1
Gemischtes DPI-Hostingverhalten. Dadurch können untergeordnete Fenster mit unterschiedlichen DPI_AWARENESS_CONTEXT erstellt und übergeordnet werden. Diese untergeordneten Fenster werden vom Betriebssystem unabhängig skaliert.

Hinweise

DPI_HOSTING_BEHAVIOR ermöglicht ein Hostingverhalten für gemischte Inhalte, das es übergeordneten Fenstern ermöglicht, die im Thread erstellt wurden, untergeordnete Fenster mit einem anderen DPI_AWARENESS_CONTEXT Wert zu hosten. Diese Eigenschaft wirkt sich nur auf neue Fenster aus, die in diesem Thread erstellt wurden, während das gemischte Hostingverhalten aktiv ist. Ein übergeordnetes Fenster mit diesem Hostingverhalten kann untergeordnete Fenster mit unterschiedlichen DPI_AWARENESS_CONTEXT Werten hosten, unabhängig davon, ob für die untergeordneten Fenster ein gemischtes Hostingverhalten aktiviert ist.

Dieses Hostingverhalten lässt nicht zu, dass Fenster mit monitorspezifischen DPI_AWARENESS_CONTEXT Werten von Fenstern mit DPI_AWARENESS_CONTEXT Werten des Systems oder nicht erkannt werden.

Um unerwartete Ergebnisse zu vermeiden, sollte die DPI_HOSTING_BEHAVIOR eines Threads so geändert werden, dass gemischte Hostingverhalten nur beim Erstellen eines neuen Fensters unterstützt werden, das diese Verhaltensweisen unterstützen muss. Nachdem dieses Fenster erstellt wurde, sollte das Hostingverhalten wieder auf den Standardwert umgestellt werden.

Durch aktivieren des gemischten Hostingverhaltens wird die DPI_AWARENESS_CONTEXT des Threads nicht automatisch an die Kompatibilität mit Legacyinhalten angepasst. Der Bewusstseinskontext des Threads muss noch manuell geändert werden, bevor neue Fenster zum Hosten solcher Inhalte erstellt werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10, Version 1803 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Kopfzeile windef.h

Weitere Informationen

GetThreadDpiHostingBehavior

GetWindowDpiHostingBehavior

SetThreadDpiHostingBehavior