Métodos para especificar páginas

Importante

A moderna plataforma de impressão é o meio preferido do Windows para comunicar com as impressoras. Recomendamos que utilize o controlador de classe da caixa de entrada IPP da Microsoft, juntamente com as Aplicações de Suporte de Impressão (PSA), 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 Guia de design do aplicativo de suporte de impressão v1 e v2.

Um aplicativo pode usar qualquer um dos três métodos para especificar páginas de folha de propriedades para CPSUI. Cada um dos métodos a seguir envolve chamar a função ComPropSheet do CPSUI, especificando um dos códigos de função ComPropSheet .

• Fornecimento de uma estrutura COMPROPSHEETUI

  Se um aplicativo descrever uma página de folha de propriedades passando uma estrutura COMPROPSHEETUI para ComPropSheet, ele pode:

  • Use uma das páginas e modelos fornecidos pelo CPSUI para especificar um tipo de página padrão predefinido que as DLLs da interface da impressora podem usar para folhas de propriedades da impressora.

  • Especifique um conjunto de opções de folha de propriedades modificáveis pelo usuário que aparecerão na página.

  • Especifique uma função de retorno de chamada de evento de página que o CPSUI chamará quando um utilizador visualizar ou modificar as opções da página.

• Fornecimento de uma estrutura PROPSHEETPAGE

  Uma estrutura PROPSHEETPAGE pode ser usada para descrever uma página de propriedade, se a página não puder ser construída usando as caixas de diálogo comuns (padrão) disponíveis ao usar uma estrutura COMPROPSHEETUI. As DLLs da interface da impressora normalmente não precisam usar esse método.

• Fornecendo uma função de 'callback'

  Um aplicativo pode passar ComPropSheet o endereço de uma função de retorno de chamada do tipo PFNPROPSHEETUI, que o CPSUI chama imediatamente. A função de retorno de chamada é responsável por chamar ComPropSheet a si mesma para criar páginas de propriedades.

  O spooler de impressão usa este método para informar o CPSUI da existência das funções de interface de impressora DLL DrvDocumentPropertySheets e DrvDevicePropertySheets. Da mesma forma, os drivers Unidrv e Pscript usam a técnica para informar o CPSUI da existência dos métodos COM IPrintOemUI::DocumentPropertySheets e IPrintOemUI::DevicePropertySheets em plug-ins de interface do usuário.

Seja qual for o método usado para especificar novas páginas, as páginas devem ser atribuídas a um pai de grupo passando um identificador pai de grupo para a função ComPropSheet.