Delphi 10.3 FMX在TPaintBox实现自由手绘(签名板)时全屏变黑如何解决?
问题根因
你的实现出现触屏后全黑的问题,核心是完全违背了FMX框架的渲染规则,具体有三个错误点:
- 渲染流程错误:你在
OnMouseMove事件里直接手动调用pb1.Canvas.BeginScene/EndScene操作画布。FMX在Android平台使用硬件加速渲染,所有控件的画布绘制必须由框架在统一的渲染管线里触发BeginScene,手动调用这个方法会直接清空整个渲染缓冲区为默认黑色,因为没有前置的背景绘制步骤,最终就会出现屏幕全黑的现象。 - 缺少状态锁:没有判断是否处于手指按下的状态,任何触控移动事件(哪怕是悬停、其他控件的事件透传)都会触发绘制,在Android的触控逻辑下很容易出现异常渲染。
- 绘制逻辑无持久化:直接在控件画布上绘制的内容没有做内存缓存,一旦控件触发重绘(比如切Tab、屏幕旋转),绘制内容会立刻丢失。
- 代码冗余:原代码中声明的
brush: TStrokeBrush属于未使用的冗余变量,无实际调用逻辑。
简单自由手绘应用的正确实现方案
核心设计思路
- 所有直接显示到屏幕的绘制逻辑,统一放到
TPaintBox的OnPaint事件里,由框架触发渲染,禁止在鼠标/触控事件里直接操作控件Canvas - 用独立的内存位图持久保存所有手绘轨迹,作为唯一的绘制数据源
- 增加绘制状态标记,只有手指按下时的移动轨迹才会被采集和绘制
关键实现代码
- 类的私有字段定义,替换原来的全局
_lastPoint变量,补充必要的状态标记和持久化位图:private FIsDrawing: Boolean; // 标记是否处于手指按下的绘制状态 FLastPoint: TPointF; // 上一个轨迹点 FBitmap: TBitmap; // 内存持久化位图,存储所有手绘内容 - 窗体初始化阶段创建位图,设置白色初始背景:
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; - 按下事件处理,启动绘制状态:
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; - 移动事件处理,只在绘制状态下采集轨迹,绘制到内存位图:
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; - 抬笔、移出控件范围时结束绘制状态:
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; - 核心的OnPaint绘制逻辑,把内存位图的内容显示到PaintBox上:
procedure THeaderFooterwithNavigation.pb1Paint(Sender: TObject; Canvas: TCanvas; const ARect: TRectF); begin Canvas.DrawBitmap(FBitmap, ARect, ARect, 1); end; - 窗体销毁时释放内存位图,避免内存泄漏:
procedure THeaderFooterwithNavigation.FormDestroy(Sender: TObject); begin FBitmap.Free; end;
Android平台适配注意事项
- 增加PaintBox的OnResize事件处理:当控件尺寸变化时,同步调整内存位图的尺寸,将旧的绘制内容迁移到新尺寸的位图上,避免旋转屏幕、弹窗弹出时位图拉伸变形。
- 不要在任何非OnPaint事件里手动调用PaintBox的Canvas.BeginScene,Android平台对非框架触发的硬件渲染调用兼容性很差,极易出现整屏黑掉的渲染异常。
- 如果快速手绘时出现线条断点,可以适当把线条粗细调整到2-3像素,或对相邻轨迹点做简单的贝塞尔曲线平滑,优化手绘体验。
内容的提问来源于stack exchange,提问作者Dejan Dozet
相关产品推荐
相关产品推荐

