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 |