mcpField
S
syncfusion-wpf-pdf-viewer

syncfusion-wpf-pdf-viewer

github.com/syncfusionドキュメント256 回インストール6 週間前に更新
リポジトリ

syncfusion-wpf-pdf-viewer について

Syncfusion WPF PdfViewer向けにC#とXAMLのサンプルを生成するスキルです。対象フレームワークに応じてプロジェクト設定やコードを調整し、ビューアー機能の導入を支援します。

主な機能

  1. 01C#とXAMLのサンプル生成
  2. 02PDF表示機能への対応
  3. 03対象フレームワークに応じたコード調整
  4. 04機能別リファレンスの活用

活用シーン

  1. 01WPFアプリでのPDF読み込み
  2. 02ビューアーのコントロールやツールバーのカスタマイズ
  3. 03PDF注釈や印刷機能の実装

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/syncfusion/pdf-viewer-sdk-skills --skill syncfusion-wpf-pdf-viewer

インストール後、Claude Code で/syncfusion-wpf-pdf-viewerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
annotation.md
commands.md
customize-contextmenu.md
export-image.md
extract-text-from-pdf.md
form-filling.md
handwritten-signature.md
import-export-annotations.md
interaction-mode.md
Load-sample.md
localization.md
magnifying.md
navigation.md
organize-pages.md
pdf-coordinates.md
pdf-layers.md
pdf-pages.md
pdf-rendering.md
print.md
redaction.md
saving-pdf-files.md
searching-text.md
text-extraction-engine.md
text-selection.md
toolbar-items.md

詳細

Syncfusion WPF PDFViewer – UI サンプルジェネレーター

ユーザーのプロジェクト向けに C# コードを生成する（デフォルト）

トリガーとなるキーワード：「方法」「コードサンプル」「見せて」「例」「スニペット」「統合」「wpf PdfViewer」「サンプルを作成」。

目的： Syncfusion WPF PdfViewer コントロールを使用する際、ユーザーが WPF アプリケーションに直接挿入できる、整然としたすぐに使える C# および XAML のコードスニペットを生成します。

ワークフロー：

  1. references/*.md ファイルに記載されたスニペットを使用して、C# コードを作成します。

  2. サンプルを生成する前に、ユーザーの WPF プロジェクト内の既存の XAML ファイルにコードを挿入するか、新しい WPF プロジェクトアプリケーションとして作成するかをユーザーに確認します。

  3. ユーザーが新しい WPF プロジェクトの作成を選択した場合、使用するターゲットフレームワークを確認します。

    • .NET Framework（例：4.6、4.7、4.8）— Syncfusion.PdfViewer.WPF を使用し、従来の .NET Framework をターゲットにします。
    • .NET Core / .NET（例：.NET 8、.NET 10）— Syncfusion.PdfViewer.WPF を使用し、<TargetFramework>net8.0-windows</TargetFramework>（または選択したバージョン）をターゲットにします。
    • ユーザーの選択に基づいて、適切な <TargetFramework> 値を含む .csproj ファイルを生成し、フレームワーク固有のコード（名前空間のインポート、NuGet パッケージのバージョン、起動コードなど）を調整します。

  4. XAML 生成ルール — XAML を記述する前に、参照ファイルを必ず確認してください：

    ⚠️ 厳守ルール — 例外なし： 要求された機能に関連する references/*.md ファイルを、XAML を生成する前に開いて読みます。 次の点を確認してください。「参照ファイルに、この機能の XAML マークアップが含まれているか？」

    • YES → 参照ファイルに XAML がある → スニペットに示されている正確な XAML 要素だけを含めます。
    • NO → 参照ファイルは C# のみ → MainWindow.xaml には <Grid> 内の <syncfusion:PdfViewerControl> だけを含めます。そこで終了します。他には何も追加しません。

    XAML を出力する前に毎回実行するチェックリスト：

    • 関連する references/*.md ファイルを開きました。
    • XAML が含まれているか、C# のみかを確認しました。
    • C# のみの場合、XAML には <Grid> 内の <syncfusion:PdfViewerControl x:Name="pdfViewer"/> 以外は含まれていません。
    • 参照ファイルに XAML がある場合、要素を新たに考案せず、その要素だけをコピーしています。

    禁止事項（参照ファイルに XAML がない場合）： <Button>、<ComboBox>、<Slider>、<StackPanel>、<TextBlock>、<Grid.RowDefinitions>、または参照スニペットにそのまま記載されていない UI 要素。

    C# のみの機能（XAML を生成しないことが判明しているもの）：

    • インク／図形／スタンプ／テキスト／ハイライト注釈（annotation.md）— 設定はすべて C# のみです。
    • 拡大鏡／ズームレベル（magnifying.md）— C# のみです。
    • インタラクションモード（interaction-mode.md）— C# のみです。
    • テキスト選択（text-selection.md）— C# のみです。
    • PDF レイヤー（pdf-layers.md）— C# のみです。
    • 墨消し（redaction.md）— C# のみです。
    • 印刷（print.md）— C# のみです。
    • 画像のエクスポート（export-image.md）— C# のみです。
    • PDF の保存（saving-pdf-files.md）— C# のみです。

    XAML が必要なことが判明している機能（参照ファイルに基づくもの）：

    • コマンド（commands.md）：ナビゲーション／ズーム／注釈／元に戻す／やり直し／印刷／アンロードの各ボタンでは、Command="{Binding ElementName=..., Path=...}" を使用します。
    • ツールバー項目（toolbar-items.md）：クラシックスタイルでは、<syncfusion:PdfViewerControl> に Style="{StaticResource SyncfusionPdfViewerCustomControlStyle}" を設定する必要があります。 すべての XAML 追加要素は、<syncfusion:PdfViewerControl> を含む同じ <Grid> 内に配置してください。<StackPanel> または <Grid> のサブレイアウトを使用するのは、参照スニペットで必要とされている場合に限ります。

  5. ユーザーが要求した機能を満たすために必要な API だけを追加してください。オプションの API など、追加の API は含めないでください。

  6. C# 言語バージョンとの互換性： ターゲットフレームワークが .NET Framework（例：4.6、4.7、4.8）の場合、既定の C# 言語バージョンは 7.3 です。生成する C# コードでは、C# 8.0 以降の言語機能を使用してはいけません。具体的には、次の機能を使用しないでください。

    • switch 式（x switch { ... }）
    • nullable 参照型（string?、#nullable enable、object?）
    • 既定のインターフェイス実装
    • 範囲とインデックス（^1、1..^1）
    • ??= による null 合体代入 switch 式の代わりに if/else または従来の switch 文を使用してください。nullable 参照型の構文ではなく、通常の null チェック（if (x != null)）を使用してください。
コードリファレンス

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

ファイル用途
Load-sample.mdファイルパス、ストリーム、または PdfLoadedDocument を使用して PDF を読み込み、読み込み解除します（暗号化の有無を問いません）。非同期読み込み、MVVM バインディング、パスワード処理、読み込みインジケーターのカスタマイズ、テーマの適用をサポートします。
navigation.mdインデックスベースまたはページ番号ベースの API を使用して PDF ページを移動し、ページ状態の情報を取得し、プログラムでスクロールし、サムネイルとブックマークを管理し、ハイパーリンクのナビゲーションイベントを処理します。
annotation.mdすべての注釈タイプを有効化、カスタマイズ、管理します。注釈イベントを処理し、注釈をプログラムで選択、非表示、ロック、削除します。コメントパネル、作成者情報、ハイパーリンク、選択表示を制御します。
pdf-rendering.mdPDFium と SfPdf を切り替え、必要な ReferencePath を設定して、PDF レンダリングエンジンを構成します。
text-extraction-engine.mdテキスト抽出の動作を制御するため、テキスト抽出エンジン（PDFium または SfPdf）を選択します。
print.mdサイレント印刷またはダイアログ表示で PDF を印刷します。プリンター、ページサイズ、拡大縮小、向き、ページ範囲、給紙元、ドキュメント名を設定し、印刷のライフサイクルイベントを処理します。
export-image.mdサイズ、DPI、アスペクト比、透明度を制御して、PDF ページまたはページ範囲を画像（JPG、PNG、TIFF、BMP）としてエクスポートします。
import-export-annotations.mdFDF または XFDF 形式を使用して注釈をインポートおよびエクスポートします。
extract-text-from-pdf.mdページまたはドキュメント全体からテキストコンテンツと境界情報を抽出します。
form-filling.mdAcroForm フィールドを処理します。フォームイベントを管理し、アイコンを表示または非表示にし、フォームデータをインポート／エクスポートし、フォームフィールドをプログラムで追加または編集します。
pdf-layers.md表示状態の切り替え、レイヤーの有効化または無効化、レイヤーペイン UI の制御によって、PDF レイヤーにアクセスして管理します。
redaction.md領域を指定し、外観をカスタマイズし、墨消しイベントを処理して墨消しを適用します。
pdf-coordinates.md座標系を相互に変換し、スクロールオフセットを取得し、特定のページ領域を拡大表示します。
organize-pages.mdページ整理機能を使用してページを回転、並べ替え、削除します。
handwritten-signature.md手書き署名をキャプチャし、外観をカスタマイズし、署名イベントを処理し、保存時に署名をフラット化します。
interaction-mode.mdカーソル設定を使用して、テキスト選択、パン、範囲指定ズームなどのビューアー操作モードを切り替えます。
pdf-pages.mdページの外観をカスタマイズし、ページ操作イベントを処理し、ピクセル座標を PDF ポイントに変換します。
saving-pdf-files.md編集した PDF を保存し、未保存の変更を検出し、保存操作をキャンセルし、保存イベントを処理し、保留中の編集がある場合は閉じる前に確認を求めます。
magnifying.mdズームレベル、フィットモード、制限、矩形領域へのズーム、ツールバーの表示、ズーム変更イベントなど、ズームの動作を制御します。
searching-text.mdテキストを検索して強調表示し、検索結果を移動し、一致範囲とテキストの詳細を取得し、複数行検索をサポートし、検索 UI と検索の可否を制御します。
text-selection.mdテキスト選択の完了を検出し、選択されたテキストと境界を取得し、強調表示の色をカスタマイズし、選択を有効または無効にし、選択範囲をプログラムでクリアします。
localization.md.resx リソースとカルチャ設定を使用して、PDF Viewer の UI をローカライズします。
customize-contextmenu.mdコンテキストメニューの項目を追加、削除、非表示にし、メニューのクリックイベントを処理して、コンテキストメニューをカスタマイズします。
commands.mdナビゲーション、ズーム、検索、注釈、元に戻す／やり直し、印刷、保存、ドキュメントの読み込み解除に関する組み込みの WPF コマンドを使用し、バインドします。
toolbar-items.mdツールバー、パネル、ボタン、メニュー、通知バーの表示／非表示を切り替え、ツールバースタイルを切り替えて、ビューアー UI をカスタマイズします。
前提条件
  1. 開発環境：Visual Studio 2022 または Visual Studio Insider 2026（.NET 10 にはこちらを推奨します）。
  2. .NET Framework 4.5 以降、または WPF に対応した .NET Core／.NET 8 以降。
  3. Syncfusion WPF NuGet パッケージ：Syncfusion.PdfViewer.WPF
テーマの NuGet パッケージ

SfSkinManager を使用して WPF PdfViewerControl に組み込みテーマを適用するには、適用するテーマに対応する NuGet パッケージをインストールしてください。

テーマ名必要な NuGet パッケージ
FluentLightSyncfusion.Themes.FluentLight.WPF
FluentDarkSyncfusion.Themes.FluentDark.WPF
MaterialLightSyncfusion.Themes.MaterialLight.WPF
MaterialDarkSyncfusion.Themes.MaterialDark.WPF
MaterialLight3Syncfusion.Themes.MaterialLight3.WPF
MaterialDark3Syncfusion.Themes.MaterialDark3.WPF
Office2019ColorfulSyncfusion.Themes.Office2019Colorful.WPF
Office2019BlackSyncfusion.Themes.Office2019Black.WPF
Office2019WhiteSyncfusion.Themes.Office2019White.WPF
Office2019DarkGraySyncfusion.Themes.Office2019DarkGray.WPF
Windows11LightSyncfusion.Themes.Windows11Light.WPF
Windows11DarkSyncfusion.Themes.Windows11Dark.WPF

Note: ユーザーが適用するテーマに対応する NuGet パッケージのみをインストールしてください。テーマをサポートするには Syncfusion.SfSkinManager.WPF が必要です。このパッケージはテーマパッケージの依存関係として含まれています。

参照：SfSkinManager を使用したテーマの適用 | WPF PdfViewer のテーマ

ドキュメント

WPF PdfViewer の概要

コメント

Markdown 対応