Metodi per specificare le pagine

Importante

La piattaforma di stampa moderna è il mezzo preferito di Windows per comunicare con le stampanti. Ti consigliamo di usare il driver di classe IPP di Microsoft, insieme a Print Support Apps (PSA), per personalizzare l'esperienza di stampa in Windows 10 e 11 per lo sviluppo di dispositivi per stampanti.

Per altre informazioni, vedere Piattaforma di stampa moderna e guida alla progettazione dell'app di supporto per la stampa.

Un'applicazione può usare uno dei tre metodi per specificare pagine della finestra delle proprietà per CPSUI. Ognuno dei metodi seguenti prevede la chiamata della funzione ComPropSheet di CPSUI, specificando uno dei codici di funzione ComPropSheet.

• Specifica di una struttura COMPROPSHEETUI

  Se un'applicazione descrive una pagina della finestra delle proprietà passando una struttura COMPROPSHEETUI a ComPropSheet, può:

  • Utilizzare una delle pagine e i modelli forniti da CPSUI per specificare un tipo di pagina standard predefinito che le DLL dell'interfaccia della stampante possono usare per le finestre delle proprietà della stampante.

  • Specificare un set di opzioni della finestra delle proprietà modificabili dall'utente che verranno visualizzate nella pagina.

  • Specificare una funzione di callback dell'evento di pagina che CPSUI chiamerà quando un utente visualizza o modifica le opzioni della pagina.

• Specifica di una struttura PROPSHEETPAGE

  Una struttura PROPSHEETPAGE può essere utilizzata per descrivere una pagina della finestra delle proprietà, se la pagina non può essere costruita utilizzando le finestre di dialogo comuni (standard) disponibili quando si utilizza una struttura COMPROPSHEETUI . Le DLL dell'interfaccia della stampante in genere non devono usare questo metodo.

• Specifica di una funzione di callback

  Un'applicazione può passare ComPropSheet l'indirizzo di una funzione di callback tipizzata PFNPROPSHEETUI, che CPSUI chiama immediatamente. La funzione di callback è responsabile della chiamata a ComPropSheet stesso per creare pagine della finestra delle proprietà.

  Lo spooler di stampa usa questo metodo per informare CPSUI dell'esistenza di una DLL dell'interfaccia della stampante DrvDocumentPropertySheets e drvDevicePropertySheets. Analogamente, i driver Unidrv e Pscript usano la tecnica per informare CPSUI dell'esistenza di metodi COM IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicevicePropertySheets nei plug-in dell'interfaccia utente.

A seconda del metodo utilizzato per specificare nuove pagine, le pagine devono essere assegnate a un elemento padre di gruppo passando un handle padre di gruppo alla funzione ComPropSheet .