identificador de DPI_AWARENESS_CONTEXT

Artigo
06/12/2023

Identifica o contexto de conscientização de uma janela.

Sintaxe

#define DPI_AWARENESS_CONTEXT_UNAWARE              ((DPI_AWARENESS_CONTEXT)-1)
#define DPI_AWARENESS_CONTEXT_SYSTEM_AWARE         ((DPI_AWARENESS_CONTEXT)-2)
#define DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE    ((DPI_AWARENESS_CONTEXT)-3)
#define DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2 ((DPI_AWARENESS_CONTEXT)-4)
#define DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED    ((DPI_AWARENESS_CONTEXT)-5)

Constantes

DPI_AWARENESS_CONTEXT_UNAWARE

DPI sem conhecimento. Essa janela não é dimensionada para alterações de DPI e sempre se supõe ter um fator de escala de 100% (96 DPI). Ele será dimensionado automaticamente pelo sistema em qualquer outra configuração de DPI.

DPI_AWARENESS_CONTEXT_SYSTEM_AWARE

Reconhecimento de DPI do sistema. Essa janela não é dimensionada para alterações de DPI. Ele consultará o DPI uma vez e usará esse valor para o tempo de vida do processo. Se o DPI for alterado, o processo não será ajustado para o novo valor de DPI. Ele será dimensionado ou reduzido automaticamente pelo sistema quando o DPI for alterado do valor do sistema.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE

Reconhecimento de DPI por monitor. Essa janela verifica o DPI quando ele é criado e ajusta o fator de escala sempre que o DPI é alterado. Esses processos não são dimensionados automaticamente pelo sistema.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2

Também conhecido como Por Monitor v2. Um avanço sobre o modo de reconhecimento de DPI por monitor original, que permite que os aplicativos acessem novos comportamentos de dimensionamento relacionados a DPI em uma base de janela de nível superior.
Por Monitor v2 foi disponibilizado na Atualização de Criadores de Windows 10 e não está disponível em versões anteriores do sistema operacional.
Os comportamentos adicionais introduzidos são os seguintes:

Notificações de alteração de DPI da janela filho – em contextos de V2 por Monitor, toda a árvore de janela é notificada sobre quaisquer alterações de DPI que ocorram.
Dimensionamento da área não cliente – todas as janelas terão automaticamente sua área não cliente desenhada de forma sensível a DPI. As chamadas para EnableNonClientDpiScaling são desnecessárias.
Dimensionamento de menus Win32 – todos os menus NTUSER criados em contextos Por Monitor v2 serão dimensionados de forma por monitor.
Dimensionamento de caixa de diálogo – caixas de diálogo Win32 criadas em contextos v2 por monitor responderão automaticamente às alterações de DPI.
Melhor dimensionamento de controles comctl32 – vários controles comctl32 melhoraram o comportamento de dimensionamento de DPI em contextos por monitor v2.
Melhor comportamento de temas – os identificadores UxTheme abertos no contexto de uma janela Por Monitor v2 funcionarão em termos do DPI associado a essa janela.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED

DPI desconhecendo a qualidade aprimorada do conteúdo baseado em GDI. Esse modo se comporta de forma semelhante a DPI_AWARENESS_CONTEXT_UNAWARE, mas também permite que o sistema melhore automaticamente a qualidade de renderização de texto e outros primitivos baseados em GDI quando a janela é exibida em um monitor de alto DPI.

Para obter mais detalhes, consulte Aprimorando a experiência de alto DPI em aplicativos da Área de Trabalho baseados em GDI.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED foi introduzido na atualização de outubro de 2018 do Windows 10 (também conhecida como versão 1809).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1607 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Cabeçalho	windef.h