Función SetDialogControlDpiChangeBehavior (winuser.h)

  • Artículo

Invalida el comportamiento de escalado de PPP por monitor predeterminado de una ventana secundaria en un cuadro de diálogo.

Sintaxis

BOOL SetDialogControlDpiChangeBehavior(
  HWND                                hWnd,
  DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS mask,
  DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS values
);

Parámetros

hWnd

Identificador de la ventana cuyo comportamiento se modificará.

mask

Máscara que especifica el subconjunto de marcas que se van a cambiar.

values

Valor deseado que se va a establecer para el subconjunto de marcas especificado.

Valor devuelto

Esta función devuelve TRUE si la operación se realizó correctamente y FALSE en caso contrario. Para obtener información de error extendida, llame a GetLastError.

Los posibles errores se ERROR_INVALID_HANDLE si se pasa un HWND no válido y ERROR_ACCESS_DENIED si las ventanas pertenecen a otro proceso.

Comentarios

Los comportamientos se especifican como valores de la enumeración DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS . Esta función sigue el enfoque típico de dos parámetros para establecer marcas, donde una máscara especifica el subconjunto de las marcas que se van a cambiar.

Es válido establecer estos comportamientos en cualquier ventana. No importa si la ventana es actualmente un elemento secundario de un diálogo en el momento en que se llama a SetDialogControlDpiChangeBehavior. Los comportamientos se conservan y solo surtirán efecto cuando la ventana sea un elemento secundario inmediato de un cuadro de diálogo que tenga habilitado el escalado de PPP por monitor.

Esta API influye en los controles individuales dentro de los diálogos. El comportamiento de escalado de PPP por monitor para todo el cuadro de diálogo se controla mediante SetDialogDpiChangeBehavior.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1703 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h
Library User32.lib
Archivo DLL User32.dll

Consulte también

DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS

GetDialogControlDpiChangeBehavior