WinForms 無標題列視窗拖曳移動：MouseDown/MouseMove 實作細節與邊界處理

核心原理

記錄滑鼠按下時相對視窗左上角的偏移量，滑鼠移動時將視窗位置設為「螢幕滑鼠位置 - 偏移量」。

最小實作

public partial class BorderlessForm : Form
{
    private Point _mouseOffset;

    public BorderlessForm()
    {
        InitializeComponent();
        this.FormBorderStyle = FormBorderStyle.None; // 移除標題列與邊框
        this.MouseDown += BorderlessForm_MouseDown;
        this.MouseMove += BorderlessForm_MouseMove;
    }

    private void BorderlessForm_MouseDown(object sender, MouseEventArgs e)
    {
        if (e.Button == MouseButtons.Left)
        {
            // 記錄滑鼠在視窗客戶區內的相對座標
            _mouseOffset = new Point(-e.X, -e.Y);
        }
    }

    private void BorderlessForm_MouseMove(object sender, MouseEventArgs e)
    {
        if (e.Button == MouseButtons.Left)
        {
            // 取得螢幕絕對座標並套用偏移
            Point screenPos = Control.MousePosition;
            screenPos.Offset(_mouseOffset.X, _mouseOffset.Y);
            this.Location = screenPos;
        }
    }
}

進階強化：邊界限制、標題列區域、效能優化

public class DraggableBorderlessForm : Form
{
    private Point _mouseOffset;
    private bool _isDragging;
    private readonly Rectangle _dragRegion; // 可拖曳區域（如標題列高度 30px）

    public DraggableBorderlessForm() : this(new Rectangle(0, 0, int.MaxValue, 30)) { }

    public DraggableBorderlessForm(Rectangle dragRegion)
    {
        InitializeComponent();
        this.FormBorderStyle = FormBorderStyle.None;
        _dragRegion = dragRegion;
        this.MouseDown += OnMouseDown;
        this.MouseMove += OnMouseMove;
        this.MouseUp += OnMouseUp;
    }

    private void OnMouseDown(object sender, MouseEventArgs e)
    {
        if (e.Button == MouseButtons.Left && _dragRegion.Contains(e.Location))
        {
            _mouseOffset = new Point(-e.X, -e.Y);
            _isDragging = true;
            this.Capture = true; // 捕獲滑鼠，即使移出客戶區仍收到事件
        }
    }

    private void OnMouseMove(object sender, MouseEventArgs e)
    {
        if (_isDragging)
        {
            Point screenPos = Control.MousePosition;
            screenPos.Offset(_mouseOffset.X, _mouseOffset.Y);

            // 螢幕邊界限制（可選）
            Rectangle workingArea = Screen.FromPoint(screenPos).WorkingArea;
            screenPos.X = Math.Clamp(screenPos.X, workingArea.Left, workingArea.Right - this.Width);
            screenPos.Y = Math.Clamp(screenPos.Y, workingArea.Top, workingArea.Bottom - this.Height);

            this.Location = screenPos;
        }
    }

    private void OnMouseUp(object sender, MouseEventArgs e)
    {
        if (e.Button == MouseButtons.Left)
        {
            _isDragging = false;
            this.Capture = false;
        }
    }
}

關鍵細節對照表

常見 Bug 與修正

• 拖曳時視窗抖動/閃爍：啟用雙緩衝 this.SetStyle(ControlStyles.AllPaintingInWmPaint | ControlStyles.UserPaint | ControlStyles.OptimizedDoubleBuffer, true);。
• 最大化/最小化邏輯缺失：無標題列需自行實作最大化/還原/最小化按鈕，並在最大化時填滿 Screen.WorkingArea。
• 多螢幕拖曳跨螢幕：Screen.FromPoint(screenPos) 動態取得目標螢幕工作區，自動適配不同解析度/DPI。
• Child 控制項攔截滑鼠事件：在容器控制項 (Panel, PictureBox) 上同樣註冊 MouseDown/MouseMove/MouseUp，或設定 Control.Capture = true 統一由表單處理。

現代替代：WPF WindowChrome / WinUI AppWindow

• WPF：WindowChrome 類別可自訂標題列高度、按鈕、拖曳區域，保留原生視窗管理（Aero Snap、最小化動畫）。
• WinUI 3 / Windows App SDK：AppWindow + AppWindowTitleBar 完全客製化標題列，支援 Mica/Acrylic 材質。

結語

無標題列視窗拖曳核心只有 10 行程式碼，但邊界限制、滑鼠捕獲、高 DPI、子控制項事件轉發才是決定體驗好壞的關鍵。建議封裝為可重用基底類別 DraggableBorderlessForm，專案統一繼承，一次解決、處處受益。