SetDialogControlDpiChangeBehavior-Funktion (winuser.h)
Überschreibt das standardmäßige DPI-Skalierungsverhalten eines untergeordneten Fensters pro Monitor in einem Dialogfeld.
Syntax
BOOL SetDialogControlDpiChangeBehavior(
HWND hWnd,
DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS mask,
DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS values
);
Parameter
hWnd
Ein Handle für das Fenster, dessen Verhalten geändert wird.
mask
Eine Maske, die die Teilmenge der zu ändernden Flags angibt.
values
Der gewünschte Wert, der für die angegebene Teilmenge von Flags festgelegt werden soll.
Rückgabewert
Diese Funktion gibt TRUE zurück, wenn der Vorgang erfolgreich war, andernfalls FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Mögliche Fehler sind ERROR_INVALID_HANDLE , wenn ein ungültiger HWND übergeben wird, und ERROR_ACCESS_DENIED , wenn die Fenster zu einem anderen Prozess gehören.
Hinweise
Die Verhaltensweisen werden als Werte aus der DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS-Enumeration angegeben. Diese Funktion folgt dem typischen Zwei-Parameter-Ansatz zum Festlegen von Flags, bei dem eine Maske die Teilmenge der zu ändernden Flags angibt.
Es ist gültig, diese Verhaltensweisen für jedes Fenster festzulegen. Es spielt keine Rolle, ob das Fenster zum Zeitpunkt des Aufrufs von SetDialogControlDpiChangeBehavior derzeit ein untergeordnetes Element eines Dialogfelds ist. Das Verhalten wird beibehalten und wird nur wirksam, wenn das Fenster ein unmittelbares untergeordnetes Element eines Dialogfelds ist, in dem die DPI-Skalierung pro Monitor aktiviert ist.
Diese API beeinflusst einzelne Steuerelemente in Dialogen. Das bildschirmweite DPI-Skalierungsverhalten pro Monitor wird durch SetDialogDpiChangeBehavior gesteuert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1703 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h |
| Bibliothek | User32.lib |
| DLL | User32.dll |