Share via

Fonction SetDialogControlDpiChangeBehavior (winuser.h)

  • Article

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

Voir aussi

DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS

GetDialogControlDpiChangeBehavior