Substituindo Driver-Supplied páginas de folha de propriedades

Importante

Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft, juntamente com aplicativos de suporte de impressão (PSA), para personalizar a experiência de impressão em Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.

Para obter mais informações, consulte o Guia de design do aplicativo de suporte de impressão.

A Interface COM IPrintCoreUI2 fornece quatro métodos que um plug-in de interface do usuário Pscript5 em execução no Windows XP e versões posteriores do sistema operacional Windows deve usar quando pretende substituir totalmente as páginas de interface do usuário padrão do driver principal. (O termo driver principal refere-se ao driver de impressora Unidrv ou Pscript5.) Esses métodos são os seguintes:

IPrintCoreUI2::EnumConstrainedOptions

IPrintCoreUI2::GetOptions

IPrintCoreUI2::SetOptions

IPrintCoreUI2::WhyConstrained

Esses métodos têm suporte somente durante a execução dos métodos IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets e suas rotinas de retorno de chamada da folha de propriedades. Um plug-in de interface do usuário dá suporte a esses métodos para exibir sua própria interface do usuário. Quando não há suporte, esses métodos retornam E_NOTIMPL.

O driver principal exibe sua própria interface do usuário da folha de propriedades em duas circunstâncias: para DrvDocumentPropertySheets e para DrvDevicePropertySheets. O primeiro método exibe propriedades que se aplicam somente a documentos (propriedades autoadesivas de documento), enquanto o segundo método exibe propriedades que se aplicam a um dispositivo (propriedades autoadesivas de dispositivo ou impressora).

O driver principal lembra o tipo de folha de propriedades que ele manipula (e, portanto, o modo -- autoadesiva de documento ou impressora autoadesiva). O driver principal salva essas informações de estado em uma estrutura (a estrutura OEMUIOBJ ) que ele cria para a instância da interface do usuário. Quando o driver principal chama os métodos de interface de um plug-in, ele passa um ponteiro para uma estrutura OEMUIOBJ, de modo que, quando um plug-in chama de volta para o driver principal de IPrintCoreUI2::EnumConstrainedOptions, IPrintCoreUI2::GetOptions, IPrintCoreUI2::SetOptions ou IPrintCoreUI2::WhyConstrained, esses métodos passam o ponteiro de volta para o driver principal, que é capaz de determinar o modo.

Para IPrintCoreUI2::EnumConstrainedOptions, IPrintCoreUI2::SetOptions, e IPrintCoreUI2::WhyConstrained, somente recursos de documento autoadesiva têm suporte durante a execução de IPrintOemUI::D ocumentPropertySheets ou sua rotina de retorno de chamada de folha de propriedades e apenas recursos autoadesivas da impressora têm suporte durante a execução de IPrintOemUI::D evicePropertySheets ou sua rotina de retorno de chamada da folha de propriedades. Para IPrintCoreUI2::SetOptions, qualquer recurso cuja aderência não corresponda ao modo autoadesiva atual deve ser ignorado. Quando IPrintCoreUI2::EnumConstrainedOptions ou IPrintCoreUI2::WhyConstrained é chamado para um recurso cuja aderência não corresponde ao modo autoadesiva atual, o método deve retornar E_INVALIDARG.

Para IPrintCoreUI2::GetOptions, Os recursos autoadesivas de documentos e impressoras são compatíveis com o modo autoadesiva do documento (ou seja, quando IPrintOemUI::D ocumentPropertySheets ou sua rotina de retorno de chamada de folha de propriedades estão em execução), mas apenas os recursos autoadesivas da impressora têm suporte no modo autoadesiva da impressora (quando IPrintOemUI::D evicePropertySheets ou sua rotina de retorno de chamada da folha de propriedades estão em execução).