Funzioni fornite da CPSUI
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.
CPSUI fornisce le due funzioni importanti seguenti per le applicazioni:
-
La funzione CommonPropertySheetUI è il punto di ingresso di CPSUI. La funzione fa sì che le pagine della finestra delle proprietà vengano create e visualizzate e quindi possano essere visualizzate e modificate da un utente.
Quando un'applicazione chiama CommonPropertySheetUI, fornisce l'indirizzo di un callback di creazione di pagina che descrive le pagine da creare. CPSUI chiama questo callback per ottenere le descrizioni della pagina. Visualizza quindi le pagine, consente all'utente dell'applicazione di modificare i valori contenuti nella pagina e recapita i valori modificati all'applicazione usando i callback degli eventi di pagina. La funzione CommonPropertySheetUI non restituisce finché l'utente non ha ignorato la finestra delle proprietà facendo clic su OK o Annulla.
Si noti che le DLL dell'interfaccia della stampante non chiamano questa funzione; viene chiamato dallo spooler di stampa.
-
La funzione ComPropSheet è il mezzo attraverso il quale le applicazioni descrivono le pagine della finestra delle proprietà in CPSUI, in modo che CPSUI possa crearle e visualizzarle. Le applicazioni CPSUI chiamano questa funzione dai callback di creazione di pagine. In genere, una descrizione di pagina include un puntatore a un callback dell'evento di pagina, che CPSUI chiamerà quando l'utente dell'applicazione modifica i valori della pagina.
Per una descrizione dettagliata di quando queste funzioni vengono chiamate, vedere Uso di CPSUI con i driver della stampante.
È possibile usare due funzioni aggiuntive fornite da CPSUI, SetCPSUIUserData e GetCPSUIUserData, dalle procedure della finestra di dialogo fornite dall'applicazione per archiviare e recuperare un valore fornito dall'applicazione.