H.NotifyIcon

自述文件

H.通知圖標

** 本專案是非活動基礎專案到其他平台 (WinUI/Uno.Skia.Wpf/Console) 的延續 - https://github.com/hardcodet/wpf-notifyicon **

這是 .Net 6 WPF/WinUI/Uno.Skia.WPF/Console 平台的 NotifyIcon（又稱系統托盤圖示或工作列圖示）的實作。它不僅依賴 Windows 窗體 NotifyIcon 元件，而且是一個完全獨立的控件，它利用 WPF/WinUI 框架的多個功能來顯示豐富的工具提示、彈出視窗、上下文選單和氣球訊息。它可以直接在程式碼中使用，也可以嵌入任何 XAML 檔案中。

特徵

• 通知
• 內容選單
• I命令支持
• 設計時訪問
• 效率模式
• 動態圖示生成

努格特

 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. 此實作目前使用與每個 TrayIcon 關聯的 Guid。預設值是一個雜湊函數，它根據檔案的路徑建立唯一的 Guid，因為在註冊 TrayIcon 時 Windows 會將 guid 與目前路徑關聯。更改檔案路徑時保留設定的唯一方法是使用 Authenticode。在此處閱讀更多：https://docs.microsoft.com/en-us/windows/win32/api/shellapi/ns-shellapi-notifyicondataa#troubleshooting

範例應用程式

• WPF
• WPF - 無窗
• 作業系統介面
• WinUI - 無視窗
• 模伊島
• 安慰

支援

錯誤的優先位置：https://github.com/HavenDV/H.NotifyIcon/issues 想法和一般問題的優先位置：https://github.com/HavenDV/H.NotifyIcon/discussions 我也有一個 Discord支援通路：
https://discord.gg/g8u2t9dKgE