Share via

SetDialogDpiChangeBehavior, fonction (winuser.h)

  • Article

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

Voir aussi

DIALOG_DPI_CHANGE_BEHAVIORS

GetDialogDpiChangeBehavior