Fonction SetDialogControlDpiChangeBehavior (winuser.h)
Remplace le comportement par défaut de mise à l’échelle DPI par moniteur d’une fenêtre enfant dans une boîte de dialogue.
Syntaxe
BOOL SetDialogControlDpiChangeBehavior(
HWND hWnd,
DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS mask,
DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS values
);
Paramètres
hWnd
Handle pour la fenêtre dont le comportement sera modifié.
mask
Masque spécifiant le sous-ensemble d’indicateurs à modifier.
values
Valeur souhaitée à définir pour le sous-ensemble d’indicateurs spécifié.
Valeur retournée
Cette fonction retourne TRUE si l’opération a réussi, et FALSE dans le cas contraire. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Les erreurs possibles sont ERROR_INVALID_HANDLE si un HWND non valide a été transmis et ERROR_ACCESS_DENIED si les fenêtres appartiennent à un autre processus.
Remarques
Les comportements sont spécifiés en tant que valeurs de l’énumération DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS . Cette fonction suit l’approche classique à deux paramètres pour définir des indicateurs, où un masque spécifie le sous-ensemble des indicateurs à modifier.
Il est valide de définir ces comportements sur n’importe quelle fenêtre. Peu importe si la fenêtre est actuellement un enfant d’une boîte de dialogue au moment où SetDialogControlDpiChangeBehavior est appelé. Les comportements sont conservés et prendront effet uniquement lorsque la fenêtre est un enfant immédiat d’une boîte de dialogue sur laquelle la mise à l’échelle DPI par moniteur est activée.
Cette API influence les contrôles individuels dans les boîtes de dialogue. Le comportement de mise à l’échelle du DPI à l’échelle de la boîte de dialogue par moniteur est contrôlé par SetDialogDpiChangeBehavior.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10, version 1703 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2016 (applications de bureau uniquement) |
| Plateforme cible | Windows |
| En-tête | winuser.h |
| Bibliothèque | User32.lib |
| DLL | User32.dll |