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

Une propriété de fenêtre correspond à toutes les données affectées à 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. Plusieurs fonctions permettent aux applications d’utiliser les propriétés de la fenêtre. Cette vue d’ensemble aborde les sujets suivants :

Avantages de l’utilisation des propriétés de la 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 d’interface multidocument (MDI). 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 classe pour les deux raisons suivantes :

  • Une application peut ne pas connaître le nombre d’octets supplémentaires disponibles ou la manière dont l’espace est utilisé. En utilisant les propriétés de la 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 la fenêtre sont accessibles par leurs identificateurs de chaîne, et non par des décalages.

Pour plus d’informations sur le sous-classement, consultez sous-classe de procédure de fenêtre. Pour plus d’informations sur les fenêtres MDI, consultez interface multidocument.

Affecter des propriétés de fenêtre

La fonction échec SetProp assigne une propriété de fenêtre et son identificateur de chaîne à une fenêtre. La fonction getprop récupère la propriété de fenêtre 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 elles-mêmes. Pour supprimer les données elles-mêmes, 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 comprend 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.