Substituindo páginas da folha de propriedades fornecidas pelo driver
Importante
A plataforma de impressão moderna é o meio preferencial do Windows para se comunicar com as impressoras. Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft juntamente com PSA (Aplicativos de Suporte à Impressão) para personalizar a experiência de impressão no Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.
Para obter mais informações, consulte Plataformade impressão moderna e 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
Esses métodos têm suporte apenas durante a execução dos métodos IPrintOemUI::DocumentPropertySheets e IPrintOemUI::DevicePropertySheets do plug-in da interface do usuário e suas rotinas de retorno de chamada de 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 fixas de documento), enquanto o segundo método exibe propriedades que se aplicam a um dispositivo (propriedades fixas de dispositivo ou impressora).
O driver principal lembra o tipo de folha de propriedades que ele manipula (e, portanto, o modo – adesivo de documento ou adesivo de impressora). 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 fixos de documento têm suporte durante a execução de IPrintOemUI::DocumentPropertySheets ou sua rotina de retorno de chamada de folha de propriedades e apenas recursos fixos de impressora têm suporte durante a execução de IPrintOemUI::DevicePropertySheets ou sua rotina de retorno de chamada de folha de propriedades. Para IPrintCoreUI2::SetOptions, qualquer recurso cuja aderência não corresponda ao modo sticky atual deve ser ignorado. Quando IPrintCoreUI2::EnumConstrainedOptions ou IPrintCoreUI2::WhyConstrained é chamado para um recurso cuja aderência não corresponde ao modo fixo atual, o método deve retornar E_INVALIDARG.
Para IPrintCoreUI2::GetOptions, á suporte para recursos fixos de documento e de impressora no modo de fixação de documento (ou seja, quando IPrintOemUI::DocumentPropertySheets ou sua rotina de retorno de chamada de folha de propriedades estão em execução), mas apenas recursos fixos de impressora têm suporte no modo de impressão fixa (quando IPrintOemUI::DevicePropertySheets ou sua rotina de retorno de chamada de folha de propriedades estão em execução).