Funzione SetThreadDpiHostingBehavior (winuser.h)

  • Articolo

Imposta la DPI_HOSTING_BEHAVIOR del thread. Questo comportamento consente alle finestre create nel thread di ospitare finestre figlio con un DPI_AWARENESS_CONTEXT diverso.

Sintassi

DPI_HOSTING_BEHAVIOR SetThreadDpiHostingBehavior(
  DPI_HOSTING_BEHAVIOR value
);

Parametri

value

Nuovo valore DPI_HOSTING_BEHAVIOR per il thread corrente.

Valore restituito

Il DPI_HOSTING_BEHAVIOR precedente per il thread. Se il comportamento di hosting passato non è valido, il thread non verrà aggiornato e il valore restituito verrà DPI_HOSTING_BEHAVIOR_INVALID. È possibile usare questo valore per ripristinare il DPI_HOSTING_BEHAVIOR precedente dopo l'override con un valore predefinito.

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 l'hosting di windows con valori di DPI_AWARENESS_CONTEXT per monitor fino a quando le finestre con valori DPI_AWARENESS_CONTEXT di sistema o non sono 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.

Questa API viene usata per modificare il DPI_HOSTING_BEHAVIOR del thread dal valore predefinito. Questa operazione è necessaria solo se l'app deve ospitare finestre figlio da plug-in e componenti di terze parti che non supportano il contesto in grado di riconoscere il monitoraggio. Ciò è molto probabile se si aggiornano applicazioni complesse per supportare i comportamenti di DPI_AWARENESS_CONTEXT per monitor.

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

Requisito Valore
Client minimo supportato Windows 10 versione 1803 [solo app desktop]
Server minimo supportato Windows Server 2016 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione Winuser
Libreria User32.lib
DLL User32.dll

Vedi anche

DPI_HOSTING_BEHAVIOR

GetThreadDpiHostingBehavior

GetWindowDpiHostingBehavior