syncfusion-maui-signature-pad

.NET MAUI SignaturePad の実装

.NET MAUI SignaturePad（SfSignaturePad）は、滑らかでリアルなデジタル署名を記録できるインタラクティブな UI コントロールです。タブレット、タッチスクリーン、その他のデバイスで指、ペン、マウスによる入力に対応し、ストロークの外観をカスタマイズできるため、さまざまな高度な機能と自然な署名体験を提供します。

このスキルを使用するタイミング

次のようなニーズがある場合に、このスキルを使用してください。

• .NET MAUI アプリケーションで、書類、フォーム、認証用のデジタル署名を記録する
• 契約書、合意書、請求書など、署名が必要な書類に署名機能を実装する
• PDF、書類、データベースに埋め込むため、署名を画像として保存する
• 特定の色、太さの範囲、視覚スタイルで署名の外観をカスタマイズする
• 検証、処理、ワークフロー制御のために署名イベントを処理する
• 高度な分析やカスタム描画のために署名のポイントデータを取得する
• 電子署名が必要な書類の署名ワークフローに統合する
• 高品質な署名体験を実現するため、Liquid Glass Effect などの最新の UI 効果を適用する

SignaturePad は、描画速度とジェスチャーの圧力に基づいてリアルな手書き署名を作成する、独自のストローク描画アルゴリズムを備えています。そのため、単純な描画コントロールよりも本格的な署名体験を提供します。

コンポーネントの概要

主な機能：

• リアルな手書き： 描画速度と圧力に応じてストロークの太さを動的に調整
• ストロークのカスタマイズ： 色、最小／最大の太さ、外観を設定
• 画像のエクスポート： 署名を ImageSource として保存し、書類に統合
• ポイントデータの取得： カスタム処理用に生の署名ポイントを List<List<float>> として取得
• イベント処理： 描画の開始／完了への対応と、キャンセルのサポート
• クリア機能： SignaturePad をプログラムからリセット
• 最新の効果： 対応プラットフォームで 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() メソッドを実装する
• イベント処理を使用して検証ワークフローを作成する
• イベント駆動型の署名取得プロセスを構築する
• イベントの順序とライフサイクルを理解する

上級：Liquid Glass Effect

📄 参照： references/liquid-glass-effect.md

次のような場合に、このリファレンスを参照してください。

• Liquid Glass Effect を適用して、モダンで半透明な UI デザインを実現する
• SignaturePad を SfGlassEffectView でラップする
• 透明度とガラス効果のプロパティを設定する
• プラットフォーム要件（.NET 10、iOS 26、macOS 26）を理解する
• プレミアムなビジュアル体験を実装する
• ガラス効果の外観をカスタマイズする