【笔记】在WPF中QueryContinueDragEvent的详细介绍

QueryContinueDrag（以及 PreviewQueryContinueDrag）是 WPF 拖放（Drag & Drop）过程中非常关键的路由事件，用来让**拖拽源（Drag Source）**在 DragDrop.DoDragDrop(...) 的阻塞循环里决定：

是否继续拖拽
是否取消拖拽
是否立即执行 Drop（完成拖拽）

它本质上是拖拽生命周期的"控制阀"。

1) 它解决的问题：谁来控制拖拽何时结束

DragDrop.DoDragDrop(...) 启动后会进入内部消息循环（直到拖拽结束才返回）。在这段时间里 WPF 必须不断检查用户意图：

鼠标按钮还按着吗？松开表示要 Drop
用户按了 Esc 吗？按下表示取消
是否发生系统级取消（例如鼠标捕获丢失、窗口状态变化等）

QueryContinueDrag 就是在此期间反复触发，让你可以覆盖默认规则，或补充业务规则。

2) 事件签名与关键参数

事件处理器类型：QueryContinueDragEventHandler

csharp 复制代码

void QueryContinueDragEventHandler(object sender, QueryContinueDragEventArgs e)

QueryContinueDragEventArgs 常用成员（核心）：

e.Action：你要告诉 WPF 下一步怎么做 （最重要）
- DragAction.Continue：继续拖拽
- DragAction.Drop：结束拖拽并尝试在当前目标 Drop
- DragAction.Cancel：取消拖拽（DoDragDrop 返回 DragDropEffects.None）
e.EscapePressed：用户是否按下了 Esc
e.KeyStates：当前拖拽时的输入状态（DragDropKeyStates 位标志），包含：
- LeftMouseButton / RightMouseButton / MiddleMouseButton
- ControlKey / ShiftKey / AltKey
e.Handled：是否阻止后续路由处理

3) 触发时机（在 DoDragDrop 内部高频触发）

QueryContinueDrag 会在拖拽执行期间频繁触发，典型原因包括：

鼠标移动
鼠标按钮状态变化（按下/松开）
键盘状态变化（Ctrl/Shift/Alt、Esc）
系统需要重新评估拖拽是否应继续

因此处理逻辑应当轻量，避免复杂命中测试/大对象分配。

4) 默认行为（你不处理时会怎样）

WPF/系统默认一般是：

如果 e.EscapePressed == true → Cancel
如果发起拖拽的那个鼠标按钮松开 → Drop
其他情况 → Continue

你处理 QueryContinueDrag 的意义在于"覆盖/增强这个默认策略"。

5) 典型应用场景

场景 A：实现"只允许按住某按钮才继续拖拽"

例如你希望必须一直按住左键，否则直接取消而不是 Drop：

左键松开：Cancel（不给 Drop）
或者右键松开：Drop（做特殊交互）

场景 B：拖拽过程中按特定键改变结束策略

例如：

按住 Alt 时松开鼠标改为 Cancel
按住 Ctrl 时松开鼠标改为 Drop（或相反）

注意：Ctrl/Shift 更常用于改变 Effects（Copy/Move），但你也可以决定彻底取消/强制 Drop。

场景 C：自定义"拖拽阈值/拖拽锁定"

有时希望拖拽开始后必须移动超过某个距离才允许 Drop，否则取消（常用于防误操作）。严格来说阈值一般在启动 DoDragDrop 前做，但你也可以在 QueryContinueDrag 中根据累计移动来决定 Cancel。

场景 D：与 `GiveFeedback` 协作做交互体验

QueryContinueDrag 控制 Continue/Drop/Cancel
GiveFeedback 控制拖拽光标（例如 Cancel 状态显示禁用）

6) 与其它拖拽事件的分工（避免混用）

源端（Drag Source）
- QueryContinueDrag：继续/取消/Drop 的决策（生命周期）
- GiveFeedback：拖拽过程中光标/反馈
目标端（Drop Target）
- DragEnter / DragOver：决定 e.Effects（Copy/Move/None）以及视觉提示
- Drop：真正接收数据并处理

经验：

"能不能放、放下去发生什么"在目标端；"拖拽什么时候结束"在源端。

7) 常见坑与注意事项

QueryContinueDrag 处理过重会卡顿

因为触发频率高，建议只做状态读取/简单判断。
设置 e.Action 后最好设置 e.Handled = true

避免其它元素再次更改 Action（尤其是你在复杂可视树中统一处理）。
取消与 Drop 的差异会影响 DoDragDrop 返回值
- Cancel 通常返回 DragDropEffects.None
- Drop 返回由目标端最终确认的 Effects（Copy/Move 等）

8) 最小示例（仅说明语义）

下面示例表达"Esc 取消；左键松开才允许 Drop；右键松开则取消"：

csharp 复制代码

private void OnQueryContinueDrag(object sender, QueryContinueDragEventArgs e)
{
    if (e.EscapePressed)
    {
        e.Action = DragAction.Cancel;
        e.Handled = true;
        return;
    }

    bool leftDown = (e.KeyStates & DragDropKeyStates.LeftMouseButton) == DragDropKeyStates.LeftMouseButton;
    bool rightDown = (e.KeyStates & DragDropKeyStates.RightMouseButton) == DragDropKeyStates.RightMouseButton;

    if (!rightDown && !leftDown)
    {
        // 两个都松开：按你的策略决定
        e.Action = DragAction.Drop;
        e.Handled = true;
        return;
    }

    if (!leftDown)
    {
        e.Action = DragAction.Drop;
        e.Handled = true;
        return;
    }

    if (!rightDown)
    {
        e.Action = DragAction.Cancel;
        e.Handled = true;
        return;
    }

    e.Action = DragAction.Continue;
    e.Handled = true;
}