syncfusion-maui-pdf-viewer

.NET MAUI PDF ビューアーの実装

Syncfusion .NET MAUI PDF ビューアー（SfPdfViewer）コントロールの実装とカスタマイズに関する包括的なスキルです。PDF ビューアーには、ナビゲーション、注釈、フォーム入力、テキスト操作、署名、墨消し、印刷など、強力なドキュメント表示・管理機能が備わっており、カスタマイズ可能なツールバーも組み込まれています。

このスキルを使用する場面

次のような場合にこのスキルを使用します。

• .NET MAUI アプリケーションで PDF ドキュメントを表示して操作する
• アプリケーションから提供されるストリームまたはバイト配列から PDF ドキュメントを読み込む
• メモリとリソースを解放するためにドキュメントをアンロードする（同期／非同期メソッド）
• 注釈を追加・管理する（インク、図形、スタンプ、テキストマークアップ、付箋）
• PDF フォームフィールドに入力して検証する。フォームデータをインポート／エクスポートする（XFDF、FDF、JSON、XML）
• PDF ドキュメント内のテキストを検索して選択する
• 電子署名を追加する（手書き、画像、テキスト）
• 機密コンテンツを恒久的に墨消しする
• 品質設定を指定して PDF ドキュメントを印刷する
• ツールバー、外観、ローカライズをカスタマイズする
• Xamarin.Forms PDF ビューアーから .NET MAUI に移行する

コンポーネントの概要

SfPdfViewer は、次の機能を備えた .NET MAUI 向けの包括的な PDF 表示・管理コントロールです。

• ドキュメント管理： パスワード対応の読み込み、メモリ管理のためのアンロード（同期／非同期）、フラット化して保存、品質設定を指定した印刷
• 注釈： インク、図形、スタンプ、付箋、テキストマークアップ、フリーテキスト、編集機能を完全に備えた消しゴム
• フォームとテキスト： すべての AcroForm タイプ、検証、インポート／エクスポート（XFDF/FDF/JSON/XML）、非同期検索、テキスト選択
• 署名と墨消し： 電子署名（手書き／画像／テキスト）、テキスト／領域／ページ単位の墨消し
• ナビゲーションと UI： ページレイアウト、ズーム、ブックマーク、ハイパーリンク、カスタマイズ可能なツールバー（デスクトップ／モバイル）、ローカライズ、RTL、リキッドグラス効果

ドキュメントとナビゲーションガイド

はじめにとセットアップ

📄 参照： references/basic-sample.md

• インストール、NuGet パッケージ、ハンドラーの登録（ConfigureSyncfusionCore）
• 基本的な PDF ビューアーの実装（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 の違い、プロパティ／メソッドの対応関係、名前空間の変更
• ハンドラー登録の違い、破壊的変更、移行チェックリスト