énumération DPI_HOSTING_BEHAVIOR (windef.h)

Article
08/27/2023

Identifie le comportement d’hébergement PPP pour une fenêtre. Ce comportement permet aux fenêtres créées dans le thread d’héberger des fenêtres enfants avec une autre DPI_AWARENESS_CONTEXT

Syntax

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

Constantes


`DPI_HOSTING_BEHAVIOR_INVALID` Valeur : -1 Comportement d’hébergement PPP non valide. Cela se produit généralement si l’appel SetThreadDpiHostingBehavior précédent utilisait un paramètre non valide.
`DPI_HOSTING_BEHAVIOR_DEFAULT` Valeur : 0 Comportement d’hébergement PPP par défaut. La fenêtre associée se comporte normalement et ne peut pas créer ou recréer des fenêtres enfants avec une autre DPI_AWARENESS_CONTEXT.
`DPI_HOSTING_BEHAVIOR_MIXED` Valeur : 1 Comportement d’hébergement PPP mixte. Cela permet la création et la reparation des fenêtres enfants avec des DPI_AWARENESS_CONTEXT différentes. Ces fenêtres enfants seront mises à l’échelle indépendamment par le système d’exploitation.

Remarques

DPI_HOSTING_BEHAVIOR active un comportement d’hébergement de contenu mixte, qui permet aux fenêtres parentes créées dans le thread d’héberger des fenêtres enfants avec une valeur de DPI_AWARENESS_CONTEXT différente. Cette propriété affecte uniquement les nouvelles fenêtres créées dans ce thread pendant que le comportement d’hébergement mixte est actif. Une fenêtre parente avec ce comportement d’hébergement peut héberger des fenêtres enfants avec des valeurs de DPI_AWARENESS_CONTEXT différentes, que le comportement d’hébergement mixte soit activé ou non pour les fenêtres enfants.

Ce comportement d’hébergement ne permet pas aux fenêtres avec des valeurs de DPI_AWARENESS_CONTEXT par moniteur d’être hébergées par des fenêtres avec DPI_AWARENESS_CONTEXT valeurs système ou non.

Pour éviter des résultats inattendus, la DPI_HOSTING_BEHAVIOR d’un thread doit être modifiée pour prendre en charge les comportements d’hébergement mixte uniquement lors de la création d’une fenêtre qui doit prendre en charge ces comportements. Une fois cette fenêtre créée, le comportement d’hébergement doit être rétabli à sa valeur par défaut.

L’activation du comportement d’hébergement mixte n’ajuste pas automatiquement la DPI_AWARENESS_CONTEXT du thread pour qu’elle soit compatible avec le contenu hérité. Le contexte de sensibilisation du thread doit toujours être modifié manuellement avant que de nouvelles fenêtres soient créées pour héberger ce contenu.

Configuration requise


Client minimal pris en charge	Windows 10, version 1803 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
En-tête	windef.h

Voir aussi

GetThreadDpiHostingBehavior

GetWindowDpiHostingBehavior

SetThreadDpiHostingBehavior

Partager via