syncfusion-maui-signature-pad

实现 .NET MAUI SignaturePad

.NET MAUI SignaturePad（SfSignaturePad）是一种交互式 UI 控件，可让用户绘制流畅、逼真的数字签名。它支持在平板电脑、触摸屏和其他设备上使用手指、触控笔或鼠标输入，并提供自然的签名体验，以及可自定义的笔画外观和高级功能。

何时使用此技能

在以下情况下使用此技能：

• 采集数字签名：在 .NET MAUI 应用中为文档、表单或身份验证采集数字签名
• 实现签名功能：用于合同、协议、发票或任何需要签名的文档
• 将签名保存为图像：将签名嵌入 PDF、文档或数据库
• 自定义签名外观：设置特定颜色、粗细范围或视觉样式
• 处理签名事件：进行验证、处理或工作流控制
• 获取签名点数据：用于高级分析或自定义渲染
• 集成文档签署工作流：用于需要电子签名的场景
• 应用现代 UI 效果：例如 Liquid Glass Effect，打造优质的签名体验

SignaturePad 提供独特的笔画渲染算法，可根据绘制速度和手势压力生成逼真的手写签名，比简单的绘图控件更能带来自然的签名体验。

组件概览

主要功能：

• 逼真的手写效果： 根据绘制速度和压力动态调整笔画粗细
• 笔画自定义： 配置颜色、最小/最大粗细和外观
• 图像导出： 将签名保存为 ImageSource，以便集成到文档中
• 点数据获取： 以 List<List<float>> 的形式获取原始签名点，供自定义处理
• 事件处理： 响应绘制开始和完成事件，并支持取消
• 清除功能： 以编程方式重置签名板
• 现代效果： 在兼容平台上支持 Liquid Glass Effect
• 跨平台： 在 iOS、Android、macOS 和 Windows 上保持一致的行为

文档与导航指南

入门

📄 阅读： references/getting-started.md

在以下情况下使用此参考：

• 在新的 .NET MAUI 项目中设置 SignaturePad
• 安装 Syncfusion.Maui.SignaturePad NuGet 包
• 在 MauiProgram.cs 中注册 Syncfusion 处理程序
• 使用 XAML 或 C# 创建基本的 SignaturePad
• 了解最简实现配置

笔画自定义

📄 阅读： references/stroke-customization.md

在以下情况下使用此参考：

• 更改签名笔画颜色（StrokeColor）
• 设置最小和最大笔画粗细，以实现逼真的渲染
• 使用简单的笔画宽度来获得均匀的外观
• 配置背景色或透明度
• 了解逼真的手写算法
• 了解笔画外观的最佳实践
• 决定使用 StrokeWidth 还是 MinimumStrokeThickness/MaximumStrokeThickness

保存和获取签名

📄 阅读： references/saving-signatures.md

在以下情况下使用此参考：

• 使用 ToImageSource() 将签名保存为图像
• 将签名导出到文件系统或数据库
• 使用 GetSignaturePoints() 获取签名点数据
• 使用 List<List<float>> 点数据结构
• 将签名集成到 PDF 或文档中
• 实现保存/加载工作流
• 处理跨设备同步
• 管理图像格式相关事项

事件和方法

📄 阅读： references/events-and-methods.md

在以下情况下，请使用此参考：

• 处理 DrawStarted 事件以验证或限制绘制
• 使用 CancelEventArgs 阻止签名绘制
• 响应 DrawCompleted 事件以进行绘制后处理
• 实现 Clear() 方法以重置签名
• 使用事件处理创建验证工作流
• 构建事件驱动的签名采集流程
• 了解事件顺序和生命周期

高级：液态玻璃效果

📄 阅读： references/liquid-glass-effect.md

在以下情况下，请使用此参考：

• 应用液态玻璃效果，打造现代、半透明的 UI 设计
• 在 SfGlassEffectView 中包装 SignaturePad
• 配置透明度和玻璃效果属性
• 了解平台要求（.NET 10、iOS 26、macOS 26）
• 实现高端视觉体验
• 自定义玻璃效果外观