syncfusion-maui-pdf-viewer

实现 .NET MAUI PDF 查看器

一项全面的技能，用于实现和自定义 Syncfusion .NET MAUI PDF Viewer（SfPdfViewer）控件。PDF Viewer 提供强大的文档查看和管理功能，包括导航、批注、表单填写、文本操作、签名、涂黑和打印，并内置可自定义工具栏。

何时使用此技能

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

• 在 .NET MAUI 应用程序中查看和导航 PDF 文档
• 从应用程序提供的流或字节数组加载 PDF 文档。
• 卸载文档以释放内存和资源（同步/异步方法）
• 添加和管理批注（墨迹、形状、图章、文本标记、便笺）
• 填写并验证 PDF 表单字段；导入/导出表单数据（XFDF、FDF、JSON、XML）
• 在 PDF 文档中搜索和选择文本
• 添加电子签名（手写、基于图像、文本）
• 永久涂黑敏感内容
• 以不同质量设置打印 PDF 文档
• 自定义工具栏、外观和本地化
• 从 Xamarin.Forms PDF Viewer 迁移到 .NET MAUI

组件概览

SfPdfViewer 是一款功能全面的 .NET MAUI PDF 查看和管理控件，具备以下功能：

• 文档管理： 加载时支持密码，卸载（同步/异步）以管理内存，保存时支持扁平化，支持设置打印质量
• 批注： 墨迹、形状、图章、便笺、文本标记、自由文本、橡皮擦，并支持全面编辑
• 表单和文本： 支持所有 AcroForm 类型、验证、导入/导出（XFDF/FDF/JSON/XML）、异步搜索、文本选择
• 签名和涂黑： 电子签名（手写/图像/文本）、基于文本/区域/页面的涂黑
• 导航和 UI： 页面布局、缩放、书签、超链接、可自定义工具栏（桌面/移动端）、本地化、RTL、流动玻璃效果

文档与导航指南

入门与设置

📄 阅读： references/basic-sample.md

• 安装、NuGet 包和处理程序注册（ConfigureSyncfusionCore）
• 基本 PDF Viewer 实现（XAML 和 C#）、DocumentSource 绑定
• 从不同来源加载 PDF，以及特定平台的设置

文档操作

📄 阅读： references/document-operations.md

• 加载 PDF 并支持密码
• 卸载文档（UnloadDocument、UnloadDocumentAsync）以妥善管理内存
• 保存修改并扁平化批注
• 设置打印质量和页面范围进行打印

批注

📄 阅读： references/annotations.md

• 添加/移除批注（AddAnnotation、RemoveAnnotation）
• 墨迹、形状、图章、便笺、文本标记、自由文本、墨迹橡皮擦
• 批注属性（颜色、不透明度、边界、笔画、旋转）和事件

表单字段

📄 阅读： references/form-fields.md

• 查看、访问并填写所有 AcroForm 字段类型
• 字段验证、导入/导出（XFDF、FDF、JSON、XML）、扁平化
• 表单字段事件和交互处理

导航与查看

📄 阅读： references/viewing.md

• 页面导航（GoToPage、PageNumber）、布局模式（Single、Continuous）
• 书签、超链接、缩放（ZoomMode、ZoomFactor）、FitMode 选项
• 坐标转换（PageToClient、ClientToPage）

文本搜索

📄 阅读： references/text-search.md

• 异步文本搜索（SearchTextAsync）、匹配项导航（GoToNextMatch、GoToPreviousMatch）
• 搜索高亮、区分大小写/全词匹配选项、自定义搜索 UI

文本选择

📄 阅读： references/text-selection.md

• 启用文本选择、SelectedText 属性、复制到剪贴板
• 自定义选择样式（颜色、不透明度）、TextSelectionChanged 事件

电子签名

📄 阅读： references/electronic-signature.md

• 手写、基于图像和文本的签名
• 签名字段管理、外观自定义、验证工作流

涂黑

📄 阅读： references/redaction.md

• 基于文本／区域／页面的涂黑（RedactText、RedactArea、RedactPage）
• 永久移除内容、自定义外观、保存已涂黑的文档

工具栏自定义

📄 阅读： references/toolbar-customization.md

• 桌面与移动端工具栏布局
• 添加／移除／隐藏／重新排列工具栏项目、AnnotationToolbarItemClicked 事件
• 创建自定义工具栏并控制其可见性

UI 设置与本地化

📄 阅读： references/ui-settings.md

• 本地化、适用于 RTL 布局的 FlowDirection、特定区域设置的格式
• 液态玻璃效果、主题自定义、特定平台的 UI 调整

手势事件与交互

📄 阅读： references/gesture-events.md

• 包含 PageNumber 和 Position 的 DocumentTapped 事件
• 触摸手势处理、自定义交互、事件驱动工作流

从 Xamarin 迁移

📄 阅读： references/migration-xamarin-to-maui.md

• API 差异、属性／方法映射、命名空间变更
• 处理程序注册差异、破坏性变更、迁移清单