Avalonia怎么实现一个简单的画板功能 Avalonia Canvas绘图

月夜之吻 2025-12-20 00:00:00 次阅读

Avalonia画板功能通过Canvas绑定PointerPressed/Moved/Released事件，用Polyline动态绘制线条，支持颜色粗细调节、橡皮擦及清空，无需额外依赖，11+版本内置能力已足够。

在 Avalonia 中实现一个简单的画板功能，核心是利用 Canvas 作为绘图容器，配合鼠标事件（按下、移动、释放）实时绘制线条。它不依赖 Skia 或 OpenGL 渲染层，纯用 Avalonia 的矢量绘图能力即可完成基础手写/绘图效果。

1. XAML 中定义 Canvas 和事件绑定

在窗口或用户控件的 XAML 中添加 Canvas，并绑定鼠标交互事件：

注意：Pointer* 是 Avalonia 推荐的跨平台输入事件（替代旧版 Mouse*），支持触控和鼠标；确保 Background 设为非空（如 White 或 Transparent），否则可能无法捕获事件。

2. 在后台代码中记录路径并动态绘制

使用 Shape（如 Polyline）实时添加到 Canvas，比直接操作 DrawingContext 更易维护：

声明一个 Polyline _currentLine 字段，用于暂存当前笔画
按下（PointerPressed）时创建新 Polyline，设置 Stroke、StrokeThickness，并添加到 Canvas 子元素
移动（PointerMoved）时将当前坐标追加到 Polyline.Points
释放（PointerReleased）时清空引用，结束当前笔画

示例关键逻辑（C#）：

private Polyline _currentLine;

private void OnPointerPressed(object sender, PointerPressedEventArgs e) {
    var point = e.GetPosition(DrawingCanvas);
    _currentLine = new Polyline {
        Stroke = Brushes.Black,
        StrokeThickness = 2,
        Points = new PointCollection { point }
    };
    DrawingCanvas.Children.Add(_currentLine);
}

private void OnPointerMoved(object sender, PointerEventArgs e) {
    if (_currentLine == null) return;
    var point = e.GetPosition(DrawingCanvas);
    _currentLine.Points.Add(point);
}

private void OnPointerReleased(object sender, PointerReleasedEventArgs e) {
    _currentLine = null;
}

3. 可选：支持颜色、粗细、橡皮擦等基础功能

通过绑定 UI 控件（如 ColorPicker、Slider）动态修改 _currentLine.Stroke 和 StrokeThickness。橡皮擦可切换为“透明画笔”或改用 Rectangle 覆盖（需开启 IsHitTestVisible=false 避免干扰）。

清空画布只需：DrawingCanvas.Children.Clear();