.NET WinForms 中 PopupWin 控件使用指南：屬性、事件與最佳實踐

PopupWin 是一款開源的 Windows Forms 彈出提示控件，模擬系統通知區氣泡提示，提升桌面應用用戶體驗。本文匯總核心屬性、典型用法與佈局技巧。

控件效果預覽

核心屬性速查表

典型使用代碼

var popup = new PopupWin();
popup.Title = "新郵件到達";
popup.Text = "您有 3 封未讀郵件";
popup.Message = "發件人: Alice, Bob, Charlie";
popup.Link = "https://mail.example.com";
popup.DockModel = DockModel.BottomRight;
popup.ColorStyle = ColorStyle.Green;
popup.HideAfter = 10;
popup.PopupSpeed = PopupSpeed.Fast;
popup.OffsetX = -20;  // 向左微調
popup.AutoShow = true;  // 設置為 true 瞬間彈出

進階佈局與自定義

• 自定義繪製：ColorStyle = Custom 時，處理 Paint 事件自繪背景/邊框/文字。
• 點擊響應：訂閱 LinkClicked 事件，在代碼中處理導航邏輯（如調用默認瀏覽器、打開應用內頁面）。
• 多螢幕適配：DockModel 基於主螢幕工作區，多螢幕環境下可通過 Screen.FromControl(this) 計算偏移。

常見問題

1. 不彈出：確認 AutoShow=true 或調用 Show() 方法；檢查是否被其他頂層窗口遮擋。
2. 中文亂碼：確保項目編碼為 UTF-8，字體支援中文（預設 Microsoft YaHei）。
3. 動畫卡頓：降低 PopupSpeed 或關閉動畫（若控件支援）。