H.NotifyIcon

README

H.NotifyIcon

** Dieses Projekt ist eine Fortsetzung des inaktiven Basisprojekts für andere Plattformen (WinUI/Uno.Skia.Wpf/Console) – https://github.com/hardcodet/wpf-notifyicon **

Dies ist eine Implementierung eines NotifyIcon (auch bekannt als Taskleistensymbol oder Taskleistensymbol) für .Net 6 WPF/WinUI/Uno.Skia.WPF/Console-Plattformen. Es basiert nicht nur auf der NotifyIcon-Komponente von Windows Forms, sondern ist ein völlig unabhängiges Steuerelement, das mehrere Funktionen der WPF/WinUI-Frameworks nutzt, um umfangreiche Tooltips, Popups, Kontextmenüs und Sprechblasenmeldungen anzuzeigen. Es kann direkt im Code verwendet oder in jede XAML-Datei eingebettet werden.

Merkmale

• Benachrichtigungen
• Kontextmenüs
• ICommand-Unterstützung
• Entwurfszeitzugriff
• Effizienzmodus
• Dynamische Icon-Generierung

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

Verwendung

< 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 >

Effizienzmodus

Windows 11 führt ein neues Konzept namens Effizienzmodus ein.
Da diese Bibliothek grundsätzlich für Anwendungen gedacht ist, die im Hintergrund laufen und über TrayIcon interagieren können, implementiert die Bibliothek eine API für diesen Modus:

 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 

Generierte Symbole

Beispiel 1:

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

Beispiel 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 >

Beispiel 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 >

Beispiel 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 >

Entwurfszeitzugriff

Es wird empfohlen, das Designer-Symbol anzuheften, damit es einfacher angezeigt werden kann. Gehen Sie dazu zu Taskleisteneinstellungen -> Andere Taskleistensymbole und aktivieren Sie dieses Symbol:

WinUI-Kontextmenü

Derzeit sind drei Modi implementiert, von denen jeder seine eigenen Vor- und Nachteile hat.

1. Basierend auf Ihrem MenuFlyout wird ein Win32-PopupMenu erstellt, das die an Ihr MenuFlyoutItem angehängten Befehle aufruft. Dies ist die Standardeinstellung.
2. Das Menü wird in Ihrem geöffneten Fenster in der Ecke des Bildschirms erstellt.
3. Ein zweites transparentes Fenster wird erstellt und zum Rendern des nativen Menüs verwendet. Derzeit befindet es sich in der Vorschauphase. Dazu müssen Sie ContextMenuMode="SecondWindow" explizit festlegen.
   

Verfügbarkeit verschiedener Optionen (abhängig von der von Ihnen verwendeten Version von WindowsAppSDK ):

Option	Verpackte App	Unverpackte App
Transparenz	ab 1.1.0-Vorschau	ab 1.1.0-Vorschau
Grenzenlos		ab 1.1.0-Vorschau
Animationen	, aber mit Grenzen	ab 1.1.0-Vorschau
Untermenüs

Verhalten, das Aufmerksamkeit erfordert

1. Diese Implementierung verwendet derzeit die Guid, die jedem TrayIcon zugeordnet ist. Die Standardeinstellung ist eine Hash-Funktion, die eine eindeutige Guid basierend auf dem Pfad zu Ihrer Datei erstellt, da Windows die Guid mit dem aktuellen Pfad verknüpft, wenn TrayIcon registriert wird. Die einzige Möglichkeit, die Einstellungen beim Ändern des Dateipfads beizubehalten, ist die Verwendung von Authenticode. Lesen Sie hier mehr: https://docs.microsoft.com/en-us/windows/win32/api/shellapi/ns-shellapi-notifyicondataa#troubleshooting

Beispiel-Apps

• WPF
• WPF – Fensterlos
• WinUI
• WinUI – fensterlos
• MAUI
• Konsole

Unterstützung

Vorrangiger Ort für Fehler: https://github.com/HavenDV/H.NotifyIcon/issues Vorrangiger Ort für Ideen und allgemeine Fragen: https://github.com/HavenDV/H.NotifyIcon/discussions Ich habe auch einen Discord Support-Kanal:
https://discord.gg/g8u2t9dKgE