SetDialogDpiChangeBehavior-Funktion (winuser.h)

Dialoge in Pro-Monitor v2-Kontexten werden automatisch dpi skaliert. Mit dieser Methode können Sie das DPI-Änderungsverhalten anpassen.

Diese Funktion funktioniert in Verbindung mit der DIALOG_DPI_CHANGE_BEHAVIORS Enumeration, um das standardmäßige DPI-Skalierungsverhalten für Dialogfelder zu überschreiben. Diese Funktion wird in einem angegebenen Dialogfeld aufgerufen, für das die angegebenen Flags einzeln gespeichert werden.

Diese Funktion wirkt sich nicht auf das DPI-Skalierungsverhalten für die untergeordneten Fenster des betreffenden Dialogfelds aus, was mit SetDialogControlDpiChangeBehavior erfolgt.

Syntax

BOOL SetDialogDpiChangeBehavior(
  HWND                        hDlg,
  DIALOG_DPI_CHANGE_BEHAVIORS mask,
  DIALOG_DPI_CHANGE_BEHAVIORS values
);

Parameter

hDlg

Ein Handle für das Dialogfeld, 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 werden ERROR_INVALID_HANDLE , wenn ein ungültiger Dialog HWND übergeben wird, und ERROR_ACCESS_DENIED , wenn der Dialog zu einem anderen Prozess gehört.

Hinweise

Aus Gründen der Erweiterbarkeit wurde DIALOG_DPI_CHANGE_BEHAVIORS als Eine Reihe von Bitflags modelliert, die separate Verhaltensweisen darstellen. 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 kein Fehler, diese API außerhalb von Pro Monitor v2-Kontexten aufzurufen, obwohl die Flags keine Auswirkungen auf das Verhalten des angegebenen Dialogfelds haben, bis der Kontext in Pro Monitor v2 geändert wird.

Anforderungen

Weitere Informationen

DIALOG_DPI_CHANGE_BEHAVIORS

GetDialogDpiChangeBehavior