fonctions CPSUI-Supplied

  • Article

Important

Nous vous recommandons d’utiliser le pilote de classe de boîte de réception IPP 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 d’appareils d’imprimante.

Pour plus d’informations, consultez le guide de conception d’application de prise en charge de l’impression.

CPSUI fournit les deux fonctions importantes suivantes pour les applications :

  • CommonPropertySheetUI

    La fonction CommonPropertySheetUI est le point d’entrée de CPSUI. La fonction permet de créer et d’afficher des pages de feuille de propriétés, puis de les afficher et de les modifier 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 remet les valeurs modifiées à l’application à l’aide de rappels d’événements de page. La fonction CommonPropertySheetUI ne retourne pas tant que l’utilisateur n’a pas ignoré 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 ; il est appelé par le spouleur d’impression.

  • ComPropSheet

    La fonction ComPropSheet est le moyen par lequel les applications décrivent des 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 des 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.