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

Confira também

DPI_HOSTING_BEHAVIOR

GetThreadDpiHostingBehavior

GetWindowDpiHostingBehavior