Sostituzione di pagine della finestra delle proprietà Driver-Supplied

  • Articolo

Importante

È consigliabile 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 stampanti.

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

L'interfaccia COM IPrintCoreUI2 fornisce quattro metodi che un plug-in dell'interfaccia utente Pscript5 in esecuzione in Windows XP e versioni successive del sistema operativo Windows deve usare quando intende sostituire completamente le pagine standard dell'interfaccia utente del driver di base. Il termine driver core fa riferimento al driver della stampante Unidrv o Pscript5. Questi metodi sono i seguenti:

IPrintCoreUI2::EnumConstrainedOptions

IPrintCoreUI2::GetOptions

IPrintCoreUI2::SetOptions

IPrintCoreUI2::WhyConstrained

Questi metodi sono supportati solo durante l'esecuzione dei metodi IPrintOemUI dell'interfaccia utente::D ocumentPropertySheets e IPrintOemUI::DevicePropertySheets e le routine di callback del foglio delle proprietà. Un plug-in dell'interfaccia utente supporta questi metodi per visualizzare la propria interfaccia utente. Quando non è supportato, questi metodi restituiscono E_NOTIMPL.

Il driver di base visualizza la propria interfaccia utente del foglio delle proprietà in due circostanze- per DrvDocumentPropertySheets e per DrvDevicePropertySheets. Il primo metodo visualizza le proprietà che si applicano solo ai documenti (proprietà di tipo document-sticky), mentre il secondo metodo visualizza le proprietà che si applicano a un dispositivo (proprietà del dispositivo o della stampante-sticky).

Il driver principale ricorda il tipo di foglio di proprietà gestito (e quindi la modalità - document-sticky o printer-sticky). Il driver principale salva le informazioni sullo stato in una struttura (la struttura OEMUIOBJ ) creata per l'istanza dell'interfaccia utente. Quando il driver di base chiama i metodi di interfaccia di un plug-in, passa un puntatore a una struttura OEMUIOBJ, in modo che quando un plug-in torna al driver principale da IPrintCoreUI2::EnumConstrainedOptions, IPrintCoreUI2::GetOptions, IPrintCoreUI2:: SetOptions o IPrintCoreUI2:: WhyConstrained, questi metodi passano il puntatore al driver principale, che è quindi in grado di determinare la modalità.

Per IPrintCoreUI2::EnumConstrainedOptions, IPrintCoreUI2::SetOptions e IPrintCoreUI2::WhyConstrained, durante l'esecuzione di IPrintOemUI::D ocumentPropertySheets o le relative funzionalità di callback del foglio delle proprietà e solo le funzionalità di callback del foglio di proprietà sono supportate durante l'esecuzione di IPrintOemUI::D evicevicePropertySheets o la relativa routine di callback del foglio delle proprietà. Per IPrintCoreUI2::SetOptions, è necessario ignorare tutte le funzionalità che non corrispondono alla modalità sticky corrente. Quando viene chiamato IPrintCoreUI2::EnumConstrainedOptions o IPrintCoreUI2::WhyConstrained viene chiamato per una funzionalità che non corrisponde alla modalità di sticky corrente, il metodo deve restituire E_INVALIDARG.

Per IPrintCoreUI2::GetOptions, entrambe le funzionalità del callback del documento e della stampante sono supportate in modalità document-sticky( ovvero quando IPrintOemUI::D ocumentPropertySheets o la relativa routine di callback del foglio delle proprietà sono in esecuzione), ma solo le funzionalità della stampante sono supportate nella modalità stampante-sticky (quando IPrintOemUI::D evicevicePropertySheets o la relativa routine di callback del foglio delle proprietà sono in esecuzione).