H.NotifyIcon

ЧИТАЙТЕ

H.NotifyIcon

** Этот проект является продолжением неактивного базового проекта для других платформ (WinUI/Uno.Skia.Wpf/Console) — https://github.com/hardcodet/wpf-notifyicon **

Это реализация NotifyIcon (также известного как значок на панели задач или значок на панели задач) для платформ .Net 6 WPF/WinUI/Uno.Skia.WPF/Console. Он не просто опирается на компонент Windows Forms NotifyIcon, но представляет собой совершенно независимый элемент управления, который использует несколько функций платформ WPF/WinUI для отображения подсказок, всплывающих окон, контекстных меню и всплывающих сообщений. Его можно использовать непосредственно в коде или внедрить в любой файл XAML.

Функции

• Уведомления
• Контекстные меню
• IКомандная поддержка
• Доступ во время разработки
• Режим эффективности
• Динамическое создание иконок

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

Использование

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

Режим эффективности

В Windows 11 представлена ​​новая концепция под названием «Режим эффективности».
Поскольку, по сути, эта библиотека предназначена для существования приложений в фоновом режиме с возможностью взаимодействия через TrayIcon, то в библиотеке реализован API для этого режима:

 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 

Сгенерированные значки

Пример 1:

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

Пример 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 >

Пример 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 >

Пример 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 >

Доступ во время разработки

Для удобства просмотра рекомендуется закрепить иконку дизайнера. Для этого перейдите в «Настройки панели задач» -> «Другие значки на панели задач» и включите этот значок:

Контекстное меню WinUI

На данный момент реализовано три режима, каждый со своими плюсами и минусами.

1. На основе вашего MenuFlyout будет создано Win32 PopupMenu, которое будет вызывать команды, прикрепленные к вашему MenuFlyoutItem. Это значение по умолчанию.
2. Меню будет создано в вашем открытом окне, в углу экрана.
3. Будет создано второе прозрачное окно, которое будет использоваться для отображения собственного меню. На данный момент оно находится на стадии предварительного просмотра. Для этого вам нужно явно установить ContextMenuMode="SecondWindow"
   

Доступность различных опций (зависит от используемой вами версии WindowsAppSDK ):

Вариант	Упакованное приложение	Неупакованное приложение
Прозрачность	из версии 1.1.0-превью	из версии 1.1.0-превью
Без границ		из версии 1.1.0-превью
Анимации	, но с границами	из версии 1.1.0-превью
Подменю

Поведение, требующее внимания

1. В настоящее время эта реализация использует Guid, связанный с каждым TrayIcon. По умолчанию используется хеш-функция, которая создает уникальный Guid на основе пути к вашему файлу, поскольку Windows связывает Guid с текущим путем при регистрации TrayIcon. Единственный способ сохранить настройки при изменении пути к файлу — использовать Authenticode. Подробнее читайте здесь: https://docs.microsoft.com/en-us/windows/win32/api/shellapi/ns-shellapi-notifyicondataa#troubleshooting.

Примеры приложений

• WPF
• WPF — без окон
• WinUI
• WinUI — без окон
• МАУИ
• Консоль

Поддерживать

Приоритетное место для ошибок: https://github.com/HavenDV/H.NotifyIcon/issues Приоритетное место для идей и общих вопросов: https://github.com/HavenDV/H.NotifyIcon/discussions Еще у меня есть Discord канал поддержки:
https://discord.gg/g8u2t9dKgE