You need to enable JavaScript to run this app. Delphi 10.3 FMX在TPaintBox实现自由手绘(签名板)时全屏变黑如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

Delphi 10.3 FMX在TPaintBox实现自由手绘(签名板)时全屏变黑如何解决?

问题根因

你的实现出现触屏后全黑的问题,核心是完全违背了FMX框架的渲染规则,具体有三个错误点:

  • 渲染流程错误:你在OnMouseMove事件里直接手动调用pb1.Canvas.BeginScene/EndScene操作画布。FMX在Android平台使用硬件加速渲染,所有控件的画布绘制必须由框架在统一的渲染管线里触发BeginScene,手动调用这个方法会直接清空整个渲染缓冲区为默认黑色,因为没有前置的背景绘制步骤,最终就会出现屏幕全黑的现象。
  • 缺少状态锁:没有判断是否处于手指按下的状态,任何触控移动事件(哪怕是悬停、其他控件的事件透传)都会触发绘制,在Android的触控逻辑下很容易出现异常渲染。
  • 绘制逻辑无持久化:直接在控件画布上绘制的内容没有做内存缓存,一旦控件触发重绘(比如切Tab、屏幕旋转),绘制内容会立刻丢失。
  • 代码冗余:原代码中声明的brush: TStrokeBrush属于未使用的冗余变量,无实际调用逻辑。
简单自由手绘应用的正确实现方案

核心设计思路

  • 所有直接显示到屏幕的绘制逻辑,统一放到TPaintBox的OnPaint事件里,由框架触发渲染,禁止在鼠标/触控事件里直接操作控件Canvas
  • 用独立的内存位图持久保存所有手绘轨迹,作为唯一的绘制数据源
  • 增加绘制状态标记,只有手指按下时的移动轨迹才会被采集和绘制

关键实现代码

  1. 类的私有字段定义,替换原来的全局_lastPoint变量,补充必要的状态标记和持久化位图:
    private
      FIsDrawing: Boolean;  // 标记是否处于手指按下的绘制状态
      FLastPoint: TPointF;  // 上一个轨迹点
      FBitmap: TBitmap;     // 内存持久化位图,存储所有手绘内容
    
  2. 窗体初始化阶段创建位图,设置白色初始背景:
    procedure THeaderFooterwithNavigation.FormCreate(Sender: TObject);
    begin
      TabControl1.First(TTabTransition.None);
      // 初始化持久化位图
      FBitmap := TBitmap.Create;
      FBitmap.SetSize(Round(pb1.Width), Round(pb1.Height));
      FBitmap.Clear(TAlphaColors.White); // 刷白色背景,避免透黑
      FIsDrawing := False;
    end;
    
  3. 按下事件处理,启动绘制状态:
    procedure THeaderFooterwithNavigation.pb1MouseDown(Sender: TObject; Button: TMouseButton; Shift: TShiftState; X, Y: Single);
    begin
      // 只响应触控/鼠标左键的按下动作
      if Button <> TMouseButton.mbLeft then Exit;
      FIsDrawing := True;
      FLastPoint := PointF(X, Y);
      // 按下时在内存位图上标记第一个点,避免第一笔无痕迹
      FBitmap.Canvas.BeginScene;
      try
        FBitmap.Canvas.Stroke.Thickness := 2;
        FBitmap.Canvas.Stroke.Kind := TBrushKind.Solid;
        FBitmap.Canvas.Stroke.Color := TAlphaColors.Black;
        FBitmap.Canvas.DrawLine(FLastPoint, FLastPoint, 1);
      finally
        FBitmap.Canvas.EndScene;
      end;
      pb1.Invalidate; // 触发控件重绘
    end;
    
  4. 移动事件处理,只在绘制状态下采集轨迹,绘制到内存位图:
    procedure THeaderFooterwithNavigation.pb1MouseMove(Sender: TObject; Shift: TShiftState; X, Y: Single);
    var
      CurrentPoint: TPointF;
    begin
      // 非按下状态下不处理移动事件
      if not FIsDrawing then Exit;
      CurrentPoint := PointF(X, Y);
      // 线段绘制到持久化内存位图,不直接碰PB的Canvas
      FBitmap.Canvas.BeginScene;
      try
        FBitmap.Canvas.Stroke.Thickness := 2;
        FBitmap.Canvas.Stroke.Kind := TBrushKind.Solid;
        FBitmap.Canvas.Stroke.Color := TAlphaColors.Black;
        FBitmap.Canvas.DrawLine(FLastPoint, CurrentPoint, 1);
      finally
        FBitmap.Canvas.EndScene;
      end;
      FLastPoint := CurrentPoint;
      pb1.Invalidate; // 触发控件重绘
    end;
    
  5. 抬笔、移出控件范围时结束绘制状态:
    procedure THeaderFooterwithNavigation.pb1MouseUp(Sender: TObject; Button: TMouseButton; Shift: TShiftState; X, Y: Single);
    begin
      FIsDrawing := False;
    end;
    
    procedure THeaderFooterwithNavigation.pb1MouseLeave(Sender: TObject);
    begin
      FIsDrawing := False;
    end;
    
  6. 核心的OnPaint绘制逻辑,把内存位图的内容显示到PaintBox上:
    procedure THeaderFooterwithNavigation.pb1Paint(Sender: TObject; Canvas: TCanvas; const ARect: TRectF);
    begin
      Canvas.DrawBitmap(FBitmap, ARect, ARect, 1);
    end;
    
  7. 窗体销毁时释放内存位图,避免内存泄漏:
    procedure THeaderFooterwithNavigation.FormDestroy(Sender: TObject);
    begin
      FBitmap.Free;
    end;
    

Android平台适配注意事项

  • 增加PaintBox的OnResize事件处理:当控件尺寸变化时,同步调整内存位图的尺寸,将旧的绘制内容迁移到新尺寸的位图上,避免旋转屏幕、弹窗弹出时位图拉伸变形。
  • 不要在任何非OnPaint事件里手动调用PaintBox的Canvas.BeginScene,Android平台对非框架触发的硬件渲染调用兼容性很差,极易出现整屏黑掉的渲染异常。
  • 如果快速手绘时出现线条断点,可以适当把线条粗细调整到2-3像素,或对相邻轨迹点做简单的贝塞尔曲线平滑,优化手绘体验。

内容的提问来源于stack exchange,提问作者Dejan Dozet

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 17:54:04