Partilhar via


DPI_AWARENESS_CONTEXT punho

Identifica o contexto de reconhecimento 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 inconsciente. Esta janela não é dimensionada para alterações de DPI e é sempre assumida como tendo um fator de escala de 100% (96 DPI). Ele será automaticamente dimensionado pelo sistema em qualquer outra configuração de DPI.

DPI_AWARENESS_CONTEXT_SYSTEM_AWARE

Sistema de conhecimento de DPI. Esta janela não é dimensionada para alterações de DPI. Ele consultará o DPI uma vez e usará esse valor durante o tempo de vida do processo. Se o DPI mudar, o processo não será ajustado ao novo valor de DPI. Ele será automaticamente dimensionado para cima ou para baixo pelo sistema quando o DPI mudar do valor do sistema.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE

Por monitor DPI consciente. Esta janela verifica o DPI quando ele é criado e ajusta o fator de escala sempre que o DPI muda. Esses processos não são dimensionados automaticamente pelo sistema.

DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2

Também conhecido como Per Monitor v2. Um avanço em relação ao modo de reconhecimento de DPI original por monitor, que permite que os aplicativos acessem novos comportamentos de dimensionamento relacionados ao DPI por janela de nível superior.
Per Monitor v2 foi disponibilizado na Atualização de Criadores do Windows 10 (também conhecida como versão 1703) 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 Por Monitor v2, toda a árvore de janela é notificada de quaisquer alterações de DPI que ocorram.
  • Dimensionamento de de área não cliente - Todas as janelas terão automaticamente sua área não cliente desenhada de forma sensível ao DPI. Chamadas para EnableNonClientDpiScaling são desnecessárias.
  • Dimensionamento de menus do Win32 - Todos os menus NTUSER criados em contextos Por Monitor v2 serão dimensionados de forma por monitor.
  • Dialog Scaling - As caixas de diálogo do Win32 criadas em contextos Per Monitor v2 responderão automaticamente às alterações de DPI.
  • Dimensionamento aprimorado de controles comctl32 - Vários controles comctl32 melhoraram o comportamento de dimensionamento de DPI em contextos Per Monitor v2.
  • Comportamento de tema melhorado - Os identificadores UxTheme abertos no contexto de uma janela Per Monitor v2 funcionarão em termos do DPI associado a essa janela.

DPI_AWARENESS_CONTEXT_UNAWARE_GDISCALED

DPI inconsciente com melhor qualidade de conteúdo baseado em GDI. Esse modo se comporta de forma semelhante ao DPI_AWARENESS_CONTEXT_UNAWARE, mas também permite que o sistema melhore automaticamente a qualidade de renderização de texto e outras primitivas baseadas em GDI quando a janela é exibida em um monitor de alto DPI.

Para obter mais detalhes, consulte Melhorando a experiência de alto DPI em aplicativos de á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).

Requerimentos

Exigência Valor
Cliente mínimo suportado
Windows 10, versão 1607 [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado
Nenhum suportado
Cabeçalho
windef.h

Ver também

AreDpiAwarenessContextsEqual

GetAwarenessFromDpiAwarenessContext

GetDpiFromDpiAwarenessContext

GetThreadDpiAwarenessContext

GetWindowDpiAwarenessContext

IsValidDpiAwarenessContext

SetProcessDpiAwarenessContext

SetThreadDpiAwarenessContext