Ativando notificações do sistema de aplicativos da área de trabalho

Os aplicativos Win32 empacotados e não empacotados podem enviar notificações do sistema interativas, assim como os aplicativos UWP. Isso inclui aplicativos empacotados (consulte Criar um novo projeto para um aplicativo de desktop WinUI 3 empacotado); aplicativos empacotados com localização externa (consulte Conceder o identificador de pacote por empacotamento com localização externa); e aplicativos não empacotados (consulte Criar um novo projeto para um aplicativo de desktop WinUI 3 não empacotado).

No entanto, para um aplicativo Win32 não empacotado, há algumas etapas especiais. Isso se deve aos diferentes esquemas de ativação e à falta de identidade do pacote em tempo de execução.

Neste tópico, listamos as opções que você tem para enviar uma notificação do sistema no Windows 10. Cada opção suporta totalmente...

• Persistindo na Central de Ações
• Ser ativável a partir do pop-up e dentro da Central de Ações
• Ser ativável enquanto seu EXE não está em execução

Todas as opções

A tabela abaixo ilustra suas opções para dar suporte a notificações do sistema em seu aplicativo da área de trabalho e os recursos compatíveis correspondentes. Você pode usar a tabela para selecionar a melhor opção para seu cenário.

Opção preferida - ativador COM

Essa é a opção preferencial que funciona para aplicativos da área de trabalho e dá suporte a todos os recursos de notificação. Não tenha medo do "ativador COM"; temos uma biblioteca para aplicativos C# e C++ que torna isso muito simples, mesmo que você nunca tenha escrito um servidor COM antes.

Com a opção ativador COM, você pode usar os seguintes modelos de notificação e tipos de ativação em seu aplicativo.

Para saber como usar essa opção, consulte Enviar uma notificação do sistema local de aplicativos C# da área de trabalho ou Enviar uma notificação do sistema local de aplicativos Win32 C++ WRL.

Opção alternativa - Sem COM / Stub CLSID

Essa é uma opção alternativa se você não puder implementar um ativador COM. No entanto, você sacrificará alguns recursos, como suporte de entrada (caixas de texto em notificações do sistema) e ativação em processo.

Com essa opção, se você der suporte à área de trabalho, ficará muito mais limitado nos modelos de notificação e nos tipos de ativação que pode usar, conforme mostrado abaixo.

Para aplicativos empacotados, basta enviar notificações do sistema como um aplicativo UWP faria. Quando o usuário clicar na notificação do sistema, seu aplicativo será iniciado na linha de comando com os argumentos de inicialização especificados na notificação do sistema.

Para aplicativos não empacotados, configure a AUMID para que você possa enviar notificações do sistema e, em seguida, especifique também um CLSID no atalho. Isso pode ser qualquer GUID aleatório. Não adicione o servidor/ativador COM. Você está adicionando um CLSID COM de "stub", o que fará com que a Central de Ações persista a notificação. Observe que você pode usar apenas notificações do sistema de ativação de protocolo, pois o CLSID de stub interromperá a ativação de qualquer outra ativação de notificação do sistema. Portanto, você precisa atualizar seu aplicativo para dar suporte à ativação do protocolo e fazer com que o protocolo da notificação do sistema ative seu próprio aplicativo.

Recursos

• Enviar uma notificação do sistema local de aplicativos C# da área de trabalho
• Enviar uma notificação do sistema local de aplicativos Win32 C++ WRL
• Documentação de conteúdo da notificação do sistema