SetThreadDpiHostingBehavior-Funktion (winuser.h)

Legt die DPI_HOSTING_BEHAVIOR des Threads fest. Dieses Verhalten ermöglicht es im Thread erstellten Fenstern, untergeordnete Fenster mit einem anderen DPI_AWARENESS_CONTEXT zu hosten.

Syntax

DPI_HOSTING_BEHAVIOR SetThreadDpiHostingBehavior(
  DPI_HOSTING_BEHAVIOR value
);

Parameter

value

Der neue DPI_HOSTING_BEHAVIOR Wert für den aktuellen Thread.

Rückgabewert

Der vorherige DPI_HOSTING_BEHAVIOR für den Thread. Wenn das übergebene Hostingverhalten ungültig ist, wird der Thread nicht aktualisiert, und der Rückgabewert wird DPI_HOSTING_BEHAVIOR_INVALID. Sie können diesen Wert verwenden, um die alte DPI_HOSTING_BEHAVIOR wiederherzustellen, nachdem Sie ihn mit einem vordefinierten Wert überschrieben haben.

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 werden, 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 gemischtes Hostingverhalten aktiviert ist.

Dieses Hostingverhalten lässt es nicht zu, dass Fenster mit monitorspezifischen DPI_AWARENESS_CONTEXT Werten gehostet werden, bis Windows mit DPI_AWARENESS_CONTEXT Werten des Systems oder nicht bekannt sind.

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

Diese API wird verwendet, um die DPI_HOSTING_BEHAVIOR des Threads vom Standardwert zu ändern. Dies ist nur erforderlich, wenn Ihre App untergeordnete Fenster aus Plug-Ins und Drittanbieterkomponenten hosten muss, die keinen monitorbasierten Kontext unterstützen. Dies tritt am wahrscheinlichsten auf, wenn Sie komplexe Anwendungen aktualisieren, um DPI_AWARENESS_CONTEXT Verhalten pro Monitor zu unterstützen.

Durch das Aktivieren des gemischten Hostingverhaltens wird der DPI_AWARENESS_CONTEXT des Threads nicht automatisch so angepasst, dass er mit Legacyinhalten kompatibel ist. Der Bewusstseinskontext des Threads muss weiterhin manuell geändert werden, bevor neue Fenster zum Hosten solcher Inhalte erstellt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1803 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h
Bibliothek	User32.lib
DLL	User32.dll

Weitere Informationen

DPI_HOSTING_BEHAVIOR

GetThreadDpiHostingBehavior

GetWindowDpiHostingBehavior