enumerazione DPI_HOSTING_BEHAVIOR (windef.h)

Articolo
03/08/2023

Identifica il comportamento di hosting DPI per una finestra. Questo comportamento consente alle finestre create nel thread di ospitare finestre figlio con un DPI_AWARENESS_CONTEXT diverso

Sintassi

typedef enum DPI_HOSTING_BEHAVIOR {
  DPI_HOSTING_BEHAVIOR_INVALID = -1,
  DPI_HOSTING_BEHAVIOR_DEFAULT = 0,
  DPI_HOSTING_BEHAVIOR_MIXED = 1
} ;

Costanti


`DPI_HOSTING_BEHAVIOR_INVALID` Valore: -1 Comportamento di hosting DPI non valido. Ciò si verifica in genere se la precedente chiamata SetThreadDpiHostingBehavior ha usato un parametro non valido.
`DPI_HOSTING_BEHAVIOR_DEFAULT` Valore: 0 Comportamento di hosting DPI predefinito. La finestra associata si comporta come di consueto e non può creare o ricreare finestre figlio con un DPI_AWARENESS_CONTEXT diverso.
`DPI_HOSTING_BEHAVIOR_MIXED` Valore: 1 Comportamento di hosting DPI misto. In questo modo è possibile creare e ri-padre delle finestre figlio con DPI_AWARENESS_CONTEXT diverse. Queste finestre figlio verranno ridimensionate in modo indipendente dal sistema operativo.

Commenti

DPI_HOSTING_BEHAVIOR abilita un comportamento di hosting di contenuto misto, che consente alle finestre padre create nel thread di ospitare finestre figlio con un valore di DPI_AWARENESS_CONTEXT diverso. Questa proprietà influisce solo sulle nuove finestre create all'interno di questo thread mentre il comportamento di hosting misto è attivo. Una finestra padre con questo comportamento di hosting è in grado di ospitare finestre figlio con valori di DPI_AWARENESS_CONTEXT diversi, indipendentemente dal fatto che le finestre figlio abbiano un comportamento di hosting misto abilitato.

Questo comportamento di hosting non consente alle finestre con valori di DPI_AWARENESS_CONTEXT per monitor di essere ospitati da windows con valori DPI_AWARENESS_CONTEXT di sistema o non a conoscenza.

Per evitare risultati imprevisti, il DPI_HOSTING_BEHAVIOR di un thread deve essere modificato per supportare i comportamenti di hosting misti solo quando si crea una nuova finestra che deve supportare tali comportamenti. Dopo aver creato la finestra, il comportamento di hosting deve essere riportato al valore predefinito.

L'abilitazione del comportamento di hosting misto non regola automaticamente il DPI_AWARENESS_CONTEXT del thread in modo che sia compatibile con il contenuto legacy. Il contesto di consapevolezza del thread deve comunque essere modificato manualmente prima che vengano create nuove finestre per ospitare tali contenuti.

Requisiti


Client minimo supportato	Windows 10 versione 1803 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Intestazione	windef.h

Vedi anche

GetThreadDpiHostingBehavior

GetWindowDpiHostingBehavior

SetThreadDpiHostingBehavior

Condividi tramite