Fonctions fournies par CPSUI
Important
La plateforme d’impression moderne est le moyen privilégié de Windows pour communiquer avec les imprimantes. Nous vous recommandons d’utiliser le pilote de classe IPP en boîte de Microsoft, ainsi que les applications de support d’impression (PSA), pour personnaliser l’expérience d’impression dans Windows 10 et 11 pour le développement de périphériques d’impression.
Pour plus d’informations, veuillez consulter les articles Plateforme d’impression moderne et Guide de conception des applications de support d’impression.
CPSUI fournit les deux fonctions importantes suivantes pour les applications :
-
La fonction CommonPropertySheetUI est le point d’entrée de CPSUI. La fonction entraîne la création et l’affichage des pages de feuille de propriétés, puis leur permet d’être affichées et modifiées par un utilisateur.
Lorsqu’une application appelle CommonPropertySheetUI, elle fournit l’adresse d’un rappel de création de page qui décrit les pages à créer. CPSUI appelle ce rappel pour obtenir les descriptions de page. Ensuite, il affiche les pages, permet à l’utilisateur de l’application de modifier les valeurs contenues dans la page et de remettre des valeurs modifiées à l’application à l’aide de rappels d’événements de page. La fonction CommonPropertySheetUI ne donne pas de retour tant que l’utilisateur n’a pas écarté la feuille de propriétés en cliquant sur OK ou Annuler.
Notez que les DLL d’interface d’imprimante n’appellent pas cette fonction ; elle est appelée par le spouleur d’impression.
-
La fonction ComPropSheet est le moyen par lequel les applications décrivent les pages de feuille de propriétés à CPSUI, afin que CPSUI puisse les créer et les afficher. Les applications CPSUI appellent cette fonction à partir des rappels de création de page. En règle générale, une description de page inclut un pointeur vers un rappel d’événement de page, que CPSUI appelle lorsque l’utilisateur de l’application modifie les valeurs de page.
Pour obtenir une description détaillée du moment où ces fonctions sont appelées, consultez Utilisation de CPSUI avec les pilotes d'imprimante.
Deux fonctions supplémentaires fournies par CPSUI, SetCPSUIUserData et GetCPSUIUserData, peuvent être utilisées par les procédures de boîte de dialogue fournies par l’application pour stocker et récupérer une valeur fournie par l’application.