Função SetThreadDpiHostingBehavior (winuser.h)

Define o DPI_HOSTING_BEHAVIOR do thread. Esse comportamento permite que as janelas criadas no thread hospedem janelas filho com um DPI_AWARENESS_CONTEXT diferente.

Sintaxe

DPI_HOSTING_BEHAVIOR SetThreadDpiHostingBehavior(
  DPI_HOSTING_BEHAVIOR value
);

Parâmetros

value

O novo valor DPI_HOSTING_BEHAVIOR para o thread atual.

Retornar valor

O DPI_HOSTING_BEHAVIOR anterior para o thread. Se o comportamento de hospedagem passado for inválido, o thread não será atualizado e o valor retornado será DPI_HOSTING_BEHAVIOR_INVALID. Você pode usar esse valor para restaurar o DPI_HOSTING_BEHAVIOR antigo depois de substituí-lo por um valor predefinido.

Comentários

DPI_HOSTING_BEHAVIOR habilita um comportamento de hospedagem de conteúdo misto, que permite que as janelas pai criadas no thread hospedem janelas filho com um valor de DPI_AWARENESS_CONTEXT diferente. Essa propriedade afeta apenas as novas janelas criadas dentro desse thread enquanto o comportamento de hospedagem mista está ativo. Uma janela pai com esse comportamento de hospedagem é capaz de hospedar janelas filho com valores de DPI_AWARENESS_CONTEXT diferentes, independentemente de as janelas filho terem o comportamento de hospedagem misto habilitado.

Esse comportamento de hospedagem não permite que janelas com valores de DPI_AWARENESS_CONTEXT por monitor sejam hospedadas até que janelas com DPI_AWARENESS_CONTEXT valores do sistema ou não saibam.

Para evitar resultados inesperados, o DPI_HOSTING_BEHAVIOR de um thread deve ser alterado para dar suporte a comportamentos de hospedagem mistos somente ao criar uma nova janela que precise dar suporte a esses comportamentos. Depois que essa janela for criada, o comportamento de hospedagem deverá ser alternado de volta para seu valor padrão.

Essa API é usada para alterar a DPI_HOSTING_BEHAVIOR do thread de seu valor padrão. Isso só será necessário se seu aplicativo precisar hospedar janelas filho de plug-ins e componentes de terceiros que não dão suporte ao contexto com reconhecimento de monitor. Isso provavelmente ocorrerá se você estiver atualizando aplicativos complexos para dar suporte a comportamentos de DPI_AWARENESS_CONTEXT por monitor.

Habilitar o comportamento de hospedagem mista não ajustará automaticamente o DPI_AWARENESS_CONTEXT do thread para ser compatível com o conteúdo herdado. O contexto de reconhecimento do thread ainda deve ser alterado manualmente antes que novas janelas sejam criadas para hospedar esse conteúdo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1803 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h
Biblioteca	User32.lib
DLL	User32.dll

Confira também

DPI_HOSTING_BEHAVIOR

GetThreadDpiHostingBehavior

GetWindowDpiHostingBehavior