Función SetThreadDpiHostingBehavior (winuser.h)

  • Artículo

Establece la DPI_HOSTING_BEHAVIOR del subproceso. Este comportamiento permite que las ventanas creadas en el subproceso hospede ventanas secundarias con un DPI_AWARENESS_CONTEXT diferente.

Sintaxis

DPI_HOSTING_BEHAVIOR SetThreadDpiHostingBehavior(
  DPI_HOSTING_BEHAVIOR value
);

Parámetros

value

Nuevo valor de DPI_HOSTING_BEHAVIOR para el subproceso actual.

Valor devuelto

El DPI_HOSTING_BEHAVIOR anterior del subproceso. Si el comportamiento de hospedaje pasado no es válido, el subproceso no se actualizará y el valor devuelto será DPI_HOSTING_BEHAVIOR_INVALID. Puede usar este valor para restaurar el antiguo DPI_HOSTING_BEHAVIOR después de invalidarlo con un valor predefinido.

Comentarios

DPI_HOSTING_BEHAVIOR habilita un comportamiento de hospedaje de contenido mixto, que permite que las ventanas primarias creadas en el subproceso hospeden ventanas secundarias con un valor de DPI_AWARENESS_CONTEXT diferente. Esta propiedad solo afecta a las nuevas ventanas creadas dentro de este subproceso mientras el comportamiento de hospedaje mixto está activo. Una ventana primaria con este comportamiento de hospedaje puede hospedar ventanas secundarias con diferentes valores de DPI_AWARENESS_CONTEXT , independientemente de si las ventanas secundarias tienen habilitado el comportamiento de hospedaje mixto.

Este comportamiento de hospedaje no permite que las ventanas con valores por monitor DPI_AWARENESS_CONTEXT se hospeden hasta que las ventanas con DPI_AWARENESS_CONTEXT valores del sistema o no sean conscientes.

Para evitar resultados inesperados, el DPI_HOSTING_BEHAVIOR de un subproceso debe cambiarse para admitir comportamientos de hospedaje mixtos solo al crear una nueva ventana que necesite admitir esos comportamientos. Una vez creada esa ventana, el comportamiento de hospedaje se debe volver a cambiar a su valor predeterminado.

Esta API se usa para cambiar la DPI_HOSTING_BEHAVIOR del subproceso de su valor predeterminado. Esto solo es necesario si la aplicación necesita hospedar ventanas secundarias de complementos y componentes de terceros que no admiten el contexto compatible con el monitor. Es más probable que esto ocurra si está actualizando aplicaciones complejas para admitir comportamientos de DPI_AWARENESS_CONTEXT por monitor.

La habilitación del comportamiento de hospedaje mixto no ajustará automáticamente el DPI_AWARENESS_CONTEXT del subproceso para que sea compatible con el contenido heredado. El contexto de reconocimiento del subproceso debe cambiarse manualmente antes de que se creen nuevas ventanas para hospedar dicho contenido.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1803 [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

DPI_HOSTING_BEHAVIOR

GetThreadDpiHostingBehavior

GetWindowDpiHostingBehavior