H.NotifyIcon

LEIA-ME

H.NotifyIcon

**Este projeto é uma continuação do projeto base inativo para outras plataformas (WinUI/Uno.Skia.Wpf/Console) - https://github.com/hardcodet/wpf-notifyicon **

Esta é uma implementação de um NotifyIcon (também conhecido como ícone da bandeja do sistema ou ícone da barra de tarefas) para plataformas .Net 6 WPF/WinUI/Uno.Skia.WPF/Console. Ele não depende apenas do componente NotifyIcon do Windows Forms, mas é um controle puramente independente que aproveita vários recursos das estruturas WPF/WinUI para exibir dicas de ferramentas avançadas, pop-ups, menus de contexto e mensagens em balão. Ele pode ser usado diretamente no código ou incorporado em qualquer arquivo XAML.

Características

• Notificações
• Menus de contexto
• Suporte ICommand
• Acesso em tempo de design
• Modo de eficiência
• Geração dinâmica de ícones

NuGet

 Install-Package H.NotifyIcon.Wpf
Install-Package H.NotifyIcon.WinUI
Install-Package H.NotifyIcon.Uno
Install-Package H.NotifyIcon.Uno.WinUI
# If you need other platforms, you can use this Core library - 
# it allows you to make NotifyIcon even in a console application.
Install-Package H.NotifyIcon

Uso

< Window
    xmlns : tb = " clr-namespace:H.NotifyIcon;assembly=H.NotifyIcon.Wpf " // WPF
    xmlns : tb = " using:H.NotifyIcon " // WinUI
    >
    < tb : TaskbarIcon
        ToolTipText = " ToolTip "
        IconSource = " /Images/TrayIcons/Logo.ico "
        ContextMenu = " {StaticResource TrayMenu} "
        MenuActivation = " LeftOrRightClick "
        TrayPopup = " {StaticResource TrayStatusPopup} "
        PopupActivation = " DoubleClick "
        TrayToolTip = " {StaticResource TrayToolTip} "
        />
</ Window >

Modo de eficiência

O Windows 11 apresenta um novo conceito chamado Modo de Eficiência.
Como, basicamente, esta biblioteca é destinada a aplicações que existam em segundo plano com a capacidade de interagir através do TrayIcon, a biblioteca implementa uma API para este modo:

 EfficiencyModeUtilities . SetEfficiencyMode ( bool value )
WindowExtensions . Hide ( this Window window , enableEfficiencyMode : true ) // default value
WindowExtensions . Show ( this Window window , disableEfficiencyMode : true ) // default value
TaskbarIcon . ForceCreate ( bool enablesEfficiencyMode = true ) // default value 

Ícones gerados

Exemplo 1:

< tb : TaskbarIcon >
    < tb : TaskbarIcon .IconSource>
        < tb : GeneratedIconSource
            Text = " "
            Foreground = " Red "
            />
    </ tb : TaskbarIcon .IconSource>
</ tb : TaskbarIcon >

Exemplo 2:

< tb : TaskbarIcon
    IconSource = " /Icons/Error.ico "
    >
    < tb : TaskbarIcon .IconSource>
        < tb : GeneratedIconSource
            Text = " 5 "
            Foreground = " Black "
            FontSize = " 36 "
            FontWeight = " Bold "
            />
    </ tb : TaskbarIcon .IconSource>
</ tb : TaskbarIcon >

Exemplo 3:

< tb : TaskbarIcon >
    < tb : TaskbarIcon .IconSource>
        < tb : GeneratedIconSource
            Text = " "
            Foreground = " Red "
            FontFamily = " Segoe UI Emoji "
            Background = " AliceBlue "
            FontWeight = " Bold "
            FontSize = " 38 "
            />
    </ tb : TaskbarIcon .IconSource>
</ tb : TaskbarIcon >

Exemplo 4:

< tb : TaskbarIcon >
    < tb : TaskbarIcon .IconSource>
        < tb : GeneratedIconSource
            Text = " "
            BorderThickness = " 5 "
            FontSize = " 46 "
            >
            < tb : GeneratedIconSource .Foreground>
                < LinearGradientBrush StartPoint = " 0,0 " EndPoint = " 128,128 " >
                    < GradientStop Color = " White " />
                    < GradientStop Color = " Red " />
                </ LinearGradientBrush >
            </ tb : GeneratedIconSource .Foreground>
            < tb : GeneratedIconSource .BorderBrush>
                < LinearGradientBrush StartPoint = " 0,0 " EndPoint = " 128,128 " >
                    < GradientStop Color = " White " />
                    < GradientStop Color = " Red " />
                </ LinearGradientBrush >
            </ tb : GeneratedIconSource .BorderBrush>
        </ tb : GeneratedIconSource >
    </ tb : TaskbarIcon .IconSource>
</ tb : TaskbarIcon >

Acesso em tempo de design

Recomenda-se fixar o ícone do designer para facilitar a visualização. Para fazer isso, vá para Configurações da barra de tarefas -> Outros ícones da bandeja do sistema e habilite este ícone:

Menu de contexto do WinUI

No momento, três modos estão implementados, cada um com seus prós e contras.

1. Com base no seu MenuFlyout, será criado um PopupMenu Win32 que chamará os comandos anexados ao seu MenuFlyoutItem. Este é o padrão.
2. O menu será criado na janela aberta, no canto da tela.
3. Uma segunda janela transparente será criada e utilizada para renderizar o menu nativo. No momento está em fase de visualização. Para fazer isso você precisa definir explicitamente ContextMenuMode="SecondWindow"
   

Disponibilidade de várias opções (depende da versão do WindowsAppSDK que você está usando):

Opção	Aplicativo empacotado	Aplicativo não empacotado
Transparência	da visualização 1.1.0	da visualização 1.1.0
Sem fronteiras		da visualização 1.1.0
Animações	, mas com fronteiras	da visualização 1.1.0
Submenus

Comportamento que precisa de atenção

1. Esta implementação atualmente usa o Guid associado a cada TrayIcon. O padrão é uma função hash que cria um Guid exclusivo com base no caminho do seu arquivo, porque o Windows associa o guid ao caminho atual quando o TrayIcon é registrado. A única maneira de manter as configurações ao alterar o caminho do arquivo é usar Authenticode. Leia mais aqui: https://docs.microsoft.com/en-us/windows/win32/api/shellapi/ns-shellapi-notifyicondataa#troubleshooting

Exemplos de aplicativos

• WPF
• WPF - sem janelas
• WinUI
• WinUI - sem janelas
• Maui
• Console

Apoiar

Lugar prioritário para bugs: https://github.com/HavenDV/H.NotifyIcon/issues Lugar prioritário para ideias e dúvidas gerais: https://github.com/HavenDV/H.NotifyIcon/discussions Também tenho um Discord canal de suporte:
https://discord.gg/g8u2t9dKgE