syncfusion-winforms-pdf-viewer

Syncfusion WinForms PdfViewer - UI サンプル生成ツール

ユーザーのプロジェクト向けに C# コードを生成（既定）

トリガーキーワード：「code」、「snippet」、「how to write」、「Program.cs」、「show me」、「sample」、「integrate」、「example code」、「generate code for」、「create sample」、「winforms pdfviewer」。

目的： Syncfusion WinForms PdfViewer コントロールを使用する際に、ユーザーの WinForms アプリケーションにそのまま挿入できる、すぐに使用可能な整った C# コードスニペットを生成します。

ワークフロー：

1. references/*.md ファイルに記載されているスニペットを使って C# コードを作成します。
2. サンプルを生成する前に、コードを既存の WinForms プロジェクトに統合するか、新しい WinForms アプリケーションとして作成するかをユーザーに確認します。
3. ユーザーが新しい WinForms プロジェクトの作成を選択した場合は、使用するターゲットフレームワークを確認します。 -.NET Framework（例：4.6、4.7、4.8）— Syncfusion.PdfViewer.WinForms を使用し、従来の .NET Framework をターゲットにします。 -.NET / .NET Core（例：.NET 8、.NET 10）— Syncfusion.PdfViewer.WinForms を使用し、net8.0-windows（または選択されたバージョン）をターゲットにします。
4. ユーザーの選択に基づいて、以下を行います。 正しい 値を指定した .csproj ファイルを生成します。 必要な NuGet パッケージを追加します。 名前空間のインポート、フォームの初期化、スタートアップコード（Program.cs）、PDF Viewer の設定など、フレームワーク固有のコードを適宜調整します。
5. ユーザーが求める機能を満たすために必要な API のみを追加します。任意の API や追加の API は含めないでください。

---

コードリファレンス

すべてのテンプレートとスニペットは references/ フォルダーにあります。各ファイルには、エージェントが組み合わせてサンプルを生成する、用途を絞ったスニペットまたはテンプレートが含まれています。

ファイル	内容
view-pdfviewer.md	NuGet のセットアップ、PdfViewerControl/PdfDocumentView の追加、PDF の読み込み
saving-pdf-files.md	ツールバーを使用した PDF の保存、LoadedDocument.Save() によるプログラムからの保存、BeginSave および EndSave イベント
printing-pdf-files.md	ツールバーを使用した PDF の印刷、Print() によるサイレント印刷、印刷サイズのカスタマイズ（ActualSize、Fit、CustomScale）、印刷方向（Auto、Portrait、Landscape）、印刷ステータスダイアログの非表示、BeginPrint、PrintProgress、EndPrint イベント
extract-text.md	ExtractText(pageIndex, out textLines) を使用した単一ページからのテキスト抽出、PageCount ループを使用したファイル全体からのテキスト抽出、TextLines/TextLine を使用した行の境界情報付きテキスト抽出、WordCollection/TextWord を使用した境界情報付き単語の抽出
pdf-rendering-engines.md	RenderingEngine プロパティを使用したレンダリングエンジンの切り替え（デフォルトは PDFium、代替は SfPdf）、アクセス制限のある環境で ReferencePath を使用してカスタム PDFium バイナリパスを設定
searching-text.md	SearchNextText()/SearchPreviousText() を使用した次／前のテキストの検索、FindText() を使用した境界情報付きのすべての該当箇所の検索、該当件数の合計のカウント、TextSearchSettings.HighlightAllInstance を使用したすべての該当箇所のハイライトの有効化／無効化、TextSearchSettings.CurrentInstanceColor/OtherInstanceColor を使用したハイライト色のカスタマイズ
navigation.md	ブックマークのナビゲーション、ハイパーリンクの処理、ページナビゲーション（プログラムからの GoToBookmark()、HyperlinkClicked/HyperlinkMouseOver、GoToPageAtIndex()）
localization.md	ツールチップとコンテキストメニューの静的テキストのローカライズ、デフォルトの en-US ローカライズキーの表、カルチャ固有の Resx ファイル（例：Syncfusion.PdfViewer.Windows.fr.resx）の追加、LocalizationManager.SetResources() を使用したローカライズ用のカスタムアセンブリ／名前空間の設定
themes.md	ThemeName プロパティを使用した組み込みテーマの適用（Office2016Colorful、Office2016Black、Office2016DarkGray、Office2016White、Office2019Colorful、HighContrastBlack）、SkinManager.LoadAssembly() を使用したテーマアセンブリの読み込み、デフォルトテーマへのリセット
interaction-modes.md	CursorMode プロパティを使用したカーソルモードの切り替え — テキスト選択（デフォルト）には PdfViewerCursorMode.SelectTool、パン／スクロールには PdfViewerCursorMode.HandTool
error-handling.md	ErrorOccurred イベントの購読、ErrorOccurredEventArgs.Message を使用したエラーのログ記録またはユーザーへのメッセージ表示
magnifying.md	ZoomTo() を使用した指定した割合へのズーム、ZoomPercentage による現在のズーム倍率の取得、ZoomMode プロパティを使用したズームモードの切り替え（FitPage、FitWidth）
view-pdf-stream.md	Load(stream) オーバーロードを使用した FileStream からの PDF の読み込み
document-information.md	DocumentInformation.FileName および DocumentInformation.FilePath を使用した、読み込まれた PDF のファイル名とファイルパスへのアクセス、PageCount によるページ数の取得
mouse-position.md	PageClicked および PageMouseMove イベントを処理して、PDF ページを基準としたページインデックスとマウス位置を取得
host-wpf-pdfviewer-in-winforms.md	ElementHost を使用して WPF PdfViewer を WinForms アプリ内にホストし、高度な機能（注釈、フォーム入力、署名）にアクセス
toolbar.md	ToolbarSettings.<Button>.IsVisible を使用した個々のツールバーボタン（Open、Save、Zoom、Print、Pan）の表示／非表示

---

前提条件

• 開発環境：Visual Studio 2022 または Visual Studio insider 2026（.NET 10 にはこちらを推奨）。
• .NET Framework 4.5+ または .NET Core/NET 8+
• Syncfusion WinForms NuGet パッケージ：Syncfusion.PdfViewer.Windows

ドキュメント

• Syncfusion WinForms PdfViewer ドキュメント
• API リファレンス