如何解决C# WPF中Popup仅能拖动一次的问题？

问题根源 #

你的代码里有几个关键问题导致Popup仅能首次拖动：

• UserControl_MouseMove方法存在语法+逻辑错误：if (PopUpMovement.Instance().draggingPopup)后无执行代码块，直接跳转else if，且CustomTablePopupClicked变量从未被赋值为true，后续拖动逻辑完全无法触发。
• 鼠标捕获目标错误：捕获UserControl而非Popup自身，Popup移动后鼠标事件无法正确传递，导致拖动失效。
• 初始位置计算基准错误：使用相对于UserControl的鼠标位置计算偏移，Popup移动后该基准失效，偏移量计算错误。
• 单例类中CustomTablePopupClicked变量完全冗余，从未被正确使用。

修复步骤 #

1. 简化单例类（移除冗余变量） #

public class PopUpMovement
{
    private PopUpMovement() { }

    private static PopUpMovement _instance;
    private static readonly object _instanceLock = new object();

    public static PopUpMovement Instance()
    {
        if (_instance == null)
        {
            lock (_instanceLock)
            {
                _instance ??= new PopUpMovement();
            }
        }
        return _instance;
    }

    public bool DraggingPopup { get; set; } // 规范为帕斯卡命名法
}

2. 修正后台代码逻辑 #

重点调整拖动逻辑、鼠标捕获目标和位置计算基准：

private Point _dragStartMousePosition;
private double _startHorizontalOffset;
private double _startVerticalOffset;

public UserControlPage()
{
    InitializeComponent();
    // 建议只给Popup标题栏（GridHeader）绑定事件，符合常规窗口拖动逻辑
    GridHeader.MouseLeftButtonDown += PopupHeader_MouseLeftButtonDown;
    CustomTablePopup.MouseMove += Popup_MouseMove;
    CustomTablePopup.MouseLeftButtonUp += Popup_MouseLeftButtonUp;
    CustomTablePopup.LostMouseCapture += Popup_LostMouseCapture;
}

private void CloseButton_Click(object sender, RoutedEventArgs e)
{
    CustomTablePopup.IsOpen = false;
}

private void Popup_MouseMove(object sender, MouseEventArgs e)
{
    var popUpState = PopUpMovement.Instance();
    if (!popUpState.DraggingPopup) return;

    // 用屏幕坐标计算偏移，避免Popup移动后基准失效
    Point currentMousePos = Mouse.GetPosition(null);
    double offsetX = currentMousePos.X - _dragStartMousePosition.X;
    double offsetY = currentMousePos.Y - _dragStartMousePosition.Y;

    // 基于初始偏移量更新Popup位置
    CustomTablePopup.HorizontalOffset = _startHorizontalOffset + offsetX;
    CustomTablePopup.VerticalOffset = _startVerticalOffset + offsetY;
}

private void Popup_MouseLeftButtonUp(object sender, MouseButtonEventArgs e)
{
    var popUpState = PopUpMovement.Instance();
    if (popUpState.DraggingPopup)
    {
        popUpState.DraggingPopup = false;
        Mouse.Capture(null);
    }
}

private void PopupHeader_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
{
    var popUpState = PopUpMovement.Instance();
    popUpState.DraggingPopup = true;

    // 记录拖动起始状态：屏幕鼠标位置、Popup当前偏移量
    _dragStartMousePosition = Mouse.GetPosition(null);
    _startHorizontalOffset = CustomTablePopup.HorizontalOffset;
    _startVerticalOffset = CustomTablePopup.VerticalOffset;

    // 捕获标题栏控件，确保拖动过程中事件正常传递
    Mouse.Capture(sender as UIElement);
}

private void Popup_LostMouseCapture(object sender, MouseEventArgs e)
{
    // 丢失鼠标捕获时重置拖动状态，避免异常
    PopUpMovement.Instance().DraggingPopup = false;
}

3. 可选优化：限制拖动区域为标题栏 #

上述代码已将拖动事件绑定到Popup的标题栏（GridHeader），这样用户只有点击标题栏才能拖动Popup，点击内容区域不会触发拖动，更符合常规窗口的交互逻辑。如果需要整个Popup都能拖动，只需将事件绑定到roundBorder即可。

修复说明 #

• 使用屏幕坐标计算偏移，彻底解决Popup移动后位置基准失效的问题。
• 捕获拖动触发的控件而非UserControl，确保鼠标事件在Popup移动过程中持续传递。
• 移除冗余变量，简化状态管理逻辑。
• 添加LostMouseCapture事件处理，防止意外丢失鼠标捕获导致的状态异常。

内容的提问来源于stack exchange，提问作者user23077506