Méthodes de spécification des pages
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 la section Plateforme d’impression moderne et le Guide de conception des applications de support d’impression.
Une application peut utiliser l’une des trois méthodes pour spécifier les pages de feuille de propriétés à CPSUI. Chacune des méthodes suivantes implique l’appel de la fonction ComPropSheet de CPSUI, en spécifiant l’un des codes de fonction ComPropSheet.
Fourniture d’une structure COMPROPSHEETUI
Si une application décrit une page de feuille de propriétés en passant une structure COMPROPSHEETUI à ComPropSheet, elle peut :
Utiliser l’une des pages et modèles fournis par CPSUI pour spécifier un type de page prédéfini et standard que les DLL d’interface d’imprimante peuvent utiliser pour les feuilles de propriétés d’imprimante.
Spécifier un ensemble d’options de feuille de propriétés modifiables par l’utilisateur qui apparaîtront sur la page.
Spécifier une fonction de rappel d’événement de page que CPSUI appellera lorsqu’un utilisateur consulte ou modifie les options de la page.
Fourniture d’une structure PROPSHEETPAGE
Une structure PROPSHEETPAGE peut être utilisée pour décrire une page de feuille de propriétés, si la page ne peut pas être construite à l’aide des boîtes de dialogue communes (standard) disponibles lors de l’utilisation d’une structure COMPROPSHEETUI. Les DLL d’interface d’imprimante ne devraient généralement pas avoir besoin d’utiliser cette méthode.
Fourniture d’une fonction de rappel
Une application peut passer à ComPropSheet l’adresse d’une fonction de rappel typée PFNPROPSHEETUI, que CPSUI appelle immédiatement. La fonction de rappel est responsable d’appeler elle-même ComPropSheet pour créer des pages de feuille de propriétés.
Le spooler d’impression utilise cette méthode pour informer CPSUI de l’existence des fonctions DrvDocumentPropertySheets et DrvDevicePropertySheets de la DLL d’interface d’imprimante. De même, les pilotes Unidrv et Pscript utilisent cette technique pour informer CPSUI de l’existence des méthodes COM IPrintOemUI::DocumentPropertySheets et IPrintOemUI::DevicePropertySheets dans les plug-ins d’interface utilisateur.
Quelle que soit la méthode utilisée pour spécifier de nouvelles pages, les pages doivent être assignées à un parent de groupe en passant un handle de parent de groupe à la fonction ComPropSheet.