Procedimentos da caixa de diálogo e CPSUI

Importante

Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft, juntamente com o PSA (Aplicativos de Suporte para Impressão), 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 para impressão.

Um procedimento de caixa de diálogo é uma função de retorno de chamada que manipula mensagens de janela enviadas pelo sistema. Esse tipo de retorno de chamada de evento de página será necessário se você estiver criando uma página de folha de propriedades personalizada que não é fornecida pelo CPSUI. (Você também pode usar procedimentos de caixa de diálogo com páginas e modelos fornecidos por CPSUI, mas o uso de um manipulador de mensagens CPSUI é recomendado.) Para obter mais informações sobre procedimentos de caixa de diálogo, consulte DialogProc na documentação do SDK do Microsoft Windows. Os ponteiros para procedimentos da caixa de diálogo são declarados usando o tipo de ponteiro DLGPROC, também descrito na documentação do SDK do Windows.

Para todas as páginas de folha de propriedades criadas usando CPSUI, as mensagens de janela são interceptadas pela CPSUI antes de serem passadas para o procedimento da caixa de diálogo fornecido pelo aplicativo. Se a página tiver sido definida usando um modelo fornecido por CPSUI, o procedimento de diálogo fornecido pelo aplicativo poderá fornecer um valor retornado indicando que o CPSUI deve processar a mensagem.

Um procedimento de caixa de diálogo pode usar as funções SetCPSUIUserData e GetCPSUIUserData para armazenar e recuperar um valor fornecido pelo aplicativo.

Para obter mais informações sobre como usar procedimentos de caixa de diálogo com CPSUI, consulte a seção Comentários para DLGPAGE.