Funções fornecidas pelo CPSUI
Importante
A plataforma de impressão moderna é o meio preferido 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.
O CPSUI fornece as duas funções importantes a seguir para aplicativos:
-
A função CommonPropertySheetUI é o ponto de entrada do CPSUI. A função faz com que as páginas da folha de propriedades sejam criadas e exibidas e, em seguida, permite que elas sejam exibidas e modificadas por um usuário.
Quando um aplicativo chama CommonPropertySheetUI, ele fornece o endereço de um retorno de chamada de criação de página que descreve as páginas a serem criadas. O CPSUI chama esse retorno de chamada para obter as descrições da página. Em seguida, ele exibe as páginas, permite que o usuário do aplicativo modifique os valores contidos na página e fornece valores modificados para o aplicativo usando retornos de chamada de evento de página. A função CommonPropertySheetUI não retorna até que o usuário tenha descartado a folha de propriedades clicando em OK ou Cancelar.
Observe que as DLLs da interface da impressora não chamam essa função; ele é chamado pelo spooler de impressão.
-
A função ComPropSheet é o meio pelo qual os aplicativos descrevem páginas de folha de propriedades para CPSUI, para que o CPSUI possa criá-las e exibi-las. Os aplicativos CPSUI chamam essa função de dentro dos retornos de chamada de criação de página. Normalmente, uma descrição de página inclui um ponteiro para um retorno de chamada de evento de página, que o CPSUI chamará quando o usuário do aplicativo modificar os valores da página.
Para obter uma descrição detalhada de quando essas funções são chamadas, consulte Usando CPSUI com drivers de impressora.
Duas funções adicionais fornecidas pelo CPSUI, SetCPSUIUserData e GetCPSUIUserData, podem ser usadas por procedimentos de caixa de diálogo fornecidos pelo aplicativo para armazenar e recuperar um valor fornecido pelo aplicativo.