SetDialogDpiChangeBehavior, fonction (winuser.h)
Les boîtes de dialogue dans les contextes par moniteur v2 sont automatiquement mises à l’échelle ppp. Cette méthode vous permet de personnaliser leur comportement de modification PPP.
Cette fonction fonctionne conjointement avec l’énumération DIALOG_DPI_CHANGE_BEHAVIORS afin de remplacer le comportement de mise à l’échelle PPP par défaut pour les dialogues. Cette fonction est appelée dans une boîte de dialogue spécifiée, pour laquelle les indicateurs spécifiés sont enregistrés individuellement.
Cette fonction n’affecte pas le comportement de mise à l’échelle PPP pour les fenêtres enfants de la boîte de dialogue en question, ce qui est effectué avec SetDialogControlDpiChangeBehavior.
Syntaxe
BOOL SetDialogDpiChangeBehavior(
HWND hDlg,
DIALOG_DPI_CHANGE_BEHAVIORS mask,
DIALOG_DPI_CHANGE_BEHAVIORS values
);
Paramètres
hDlg
Handle pour la boîte de dialogue 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 de boîte de dialogue non valide est passé et ERROR_ACCESS_DENIED si le dialogue appartient à un autre processus.
Remarques
Pour l’extensibilité, DIALOG_DPI_CHANGE_BEHAVIORS a été modélisé comme un ensemble d’indicateurs de bits représentant des comportements distincts. 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.
L’appel de cette API en dehors des contextes Par moniteur v2 ne constitue pas une erreur, mais les indicateurs n’auront aucun effet sur le comportement de la boîte de dialogue spécifiée tant que le contexte n’est pas remplacé par Par moniteur v2.
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 |