Partilhar via


Procedimentos de caixa de diálogo e CPSUI

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.

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. (Também é possível usar procedimentos de caixa de diálogo com Páginas e modelos fornecidos pelo CPSUI, mas o uso de um manipulador de mensagens CPSUI é recomendado.) Para mais informações sobre procedimentos de caixa de diálogo, consulte DialogProc na documentação do SDK do Microsoft Windows. Os ponteiros para procedimentos de caixa de diálogo são declarados ao usar o tipo de ponteiro DLGPROC, também descrito na documentação do SDK do Windows.

Para todas as páginas da folha de propriedades criadas com o CPSUI, as mensagens de janela são interceptadas primeiro pelo CPSUI antes de serem passadas para o procedimento da caixa de diálogo fornecida pelo aplicativo. Se a página foi definida usando um modelo fornecido pelo CPSUI, o procedimento de diálogo fornecido pelo aplicativo pode 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 mais informações sobre como usar procedimentos de caixa de diálogo com CPSUI, consulte a seção Comentários para DLGPAGE.