WinUI 3：强制鼠标指针与用户控件交互（超出范围时）

针对你遇到的指针移出控件后追踪中断、控件外释放点击后重新进入错误追踪的问题，以下是两种思路的具体实现方案：

一、强制捕获指针事件（推荐方案） #

WinUI 3 提供的指针捕获机制，能让控件在指针移出自身边界后仍接收指针事件，同时可处理指针在控件外释放的场景。

修改步骤： #

1. XAML 补充事件绑定：给MainArea添加PointerCanceled事件（处理指针意外取消的情况，比如按ESC键、系统弹窗抢占焦点）：

<UserControl [...] >
    <Border Name="MainArea"
            PointerPressed="StartCapturing"
            PointerReleased="StopCapturing"
            PointerMoved="CaptureCoords"
            PointerCanceled="OnPointerCanceled"
            [...] >

        <!-- [...] -->

    </Border>
</UserControl>

2. C# 代码修改：

bool _isCapturing = false;

private void CalculateCoords(PointerRoutedEventArgs args){
    var h = MainArea.ActualHeight;
    var w = MainArea.ActualWidth;
    
    var pos = args.GetCurrentPoint(MainArea).Position;
    var (x, y) = (pos.X, pos.Y);
    
    x = Math.Clamp(x, 0, w);
    y = Math.Clamp(y, 0, h);

    var (x_perc, y_perc) = (x/w, y/h);

    // 处理百分比逻辑
}

public void StartCapturing(object? sender, PointerRoutedEventArgs args){
    _isCapturing = true;
    MainArea.CapturePointer(args.Pointer); // 捕获指针，确保后续事件能被接收
    CalculateCoords(args);
}

public void CaptureCoords(object? sender, PointerRoutedEventArgs args){
    if (!_isCapturing) return;
    CalculateCoords(args);
}

public void StopCapturing(object? sender, PointerRoutedEventArgs args){
    _isCapturing = false;
    MainArea.ReleasePointerCapture(args.Pointer); // 释放指针捕获
    CalculateCoords(args);
}

private void OnPointerCanceled(object? sender, PointerRoutedEventArgs args){
    _isCapturing = false;
    MainArea.ReleasePointerCapture(args.Pointer); // 意外取消时也要释放捕获
}

原理：调用CapturePointer后，MainArea会持续接收该指针的所有事件，直到调用ReleasePointerCapture或指针被系统取消。即使指针移出控件，PointerMoved事件仍会触发；在控件外释放左键时，PointerReleased事件也会被MainArea接收，避免_isCapturing状态残留。

二、限制鼠标移动到控件边界内 #

通过修改系统鼠标位置，强制指针无法移出控件范围。这种方案会改变用户正常操作习惯，仅在特殊场景下使用。

C# 代码修改（仅修改CalculateCoords方法）： #

private void CalculateCoords(PointerRoutedEventArgs args){
    var h = MainArea.ActualHeight;
    var w = MainArea.ActualWidth;
    
    // 获取控件在屏幕上的绝对位置和边界
    var transform = MainArea.TransformToVisual(null);
    var screenTopLeft = transform.TransformPoint(new Point(0, 0));
    var screenBounds = new Rect(screenTopLeft.X, screenTopLeft.Y, w, h);
    
    // 获取指针当前的屏幕位置
    var currentScreenPos = args.GetCurrentPoint(null).Position;
    
    // 将指针位置限制在控件屏幕边界内
    var clampedScreenX = Math.Clamp(currentScreenPos.X, screenBounds.Left, screenBounds.Right);
    var clampedScreenY = Math.Clamp(currentScreenPos.Y, screenBounds.Top, screenBounds.Bottom);
    
    // 如果位置被修正，强制设置鼠标位置
    if (clampedScreenX != currentScreenPos.X || clampedScreenY != currentScreenPos.Y)
    {
        Window.Current.CoreWindow.PointerPosition = new Point(clampedScreenX, clampedScreenY);
    }
    
    // 转换为控件相对坐标
    var relativePos = transform.InverseTransformPoint(new Point(clampedScreenX, clampedScreenY));
    var (x, y) = (relativePos.X, relativePos.Y);
    
    var (x_perc, y_perc) = (x/w, y/h);

    // 处理百分比逻辑
}

注意：这种方法会强制锁定鼠标在控件内，用户体验较差，通常不推荐，优先选择指针捕获方案。

内容的提问来源于stack exchange，提问作者Andreas M.