Partager via

À propos des propriétés de la fenêtre

  • Article

Une propriété de fenêtre est toute donnée affectée à une fenêtre. Une propriété de fenêtre est généralement un handle des données spécifiques à la fenêtre, mais il peut s’agir de n’importe quelle valeur. Chaque propriété de fenêtre est identifiée par un nom de chaîne. Il existe plusieurs fonctions qui permettent aux applications d’utiliser des propriétés de fenêtre. Cette vue d’ensemble traite des rubriques suivantes :

Avantages de l’utilisation des propriétés de fenêtre

Les propriétés de fenêtre sont généralement utilisées pour associer des données à une fenêtre sous-classée ou à une fenêtre dans une application MDI (Multi-Document Interface). Dans les deux cas, il n’est pas pratique d’utiliser les octets supplémentaires spécifiés dans la fonction CreateWindow ou la structure de classes pour les deux raisons suivantes :

  • Une application peut ne pas savoir combien d’octets supplémentaires sont disponibles ou comment l’espace est utilisé. En utilisant des propriétés de fenêtre, l’application peut associer des données à une fenêtre sans accéder aux octets supplémentaires.
  • Une application doit accéder aux octets supplémentaires à l’aide de décalages. Toutefois, les propriétés de fenêtre sont accessibles par leurs identificateurs de chaîne, et non par des décalages.

Pour plus d’informations sur la sous-classification, consultez Sous-classe de procédure de fenêtre. Pour plus d’informations sur les fenêtres MDI, consultez Interface de document multiple.

Affectation de propriétés de fenêtre

La fonction SetProp affecte une propriété window et son identificateur de chaîne à une fenêtre. La fonction GetProp récupère la propriété window identifiée par la chaîne spécifiée. La fonction RemoveProp détruit l’association entre une fenêtre et une propriété de fenêtre, mais ne détruit pas les données proprement dites. Pour détruire les données proprement dites, utilisez la fonction appropriée pour libérer le handle retourné par RemoveProp.

Énumération des propriétés de la fenêtre

Les fonctions EnumProps et EnumPropsEx énumèrent toutes les propriétés d’une fenêtre à l’aide d’une fonction de rappel définie par l’application. Pour plus d’informations sur la fonction de rappel, consultez PropEnumProc.

EnumPropsEx inclut un paramètre supplémentaire pour les données définies par l’application utilisées par la fonction de rappel. Pour plus d’informations sur la fonction de rappel, consultez PropEnumProcEx.