syncfusion-uwp-spreadsheet-editor

Syncfusion UWP Spreadsheet Editor

概要

Syncfusion SfSpreadsheet コントロールを使用して、ブック操作、数式、グラフ、データ検証、リボンのカスタマイズを全面的にサポートする、Excel のようなスプレッドシートアプリケーションを UWP で構築します。

主な機能

• ブック操作： Excel ファイル（XLS、XLSX、XLSM、CSV）の作成／開く／保存、複数のワークシート、ウィンドウ枠の固定、ズーム、保護
• セル操作： 編集、書式設定（フォント、色、罫線、配置）、セルの結合、コメント、ハイパーリンク、ブックマーク
• データ機能： Excel 互換の数式 400 種類以上、名前付き範囲、データ検証、条件付き書式、連続データの入力
• 高度な機能： グラフ、スパークライン、クリップボード操作、元に戻す／やり直し、グループ化／アウトライン

クイックスタートの例

例 1

ユーザー：「データと数式を含むスプレッドシートの作成方法を教えてください」

結果： ブックの作成、セル値の設定、数式の追加を行う C# コードが生成されます

例 2

ユーザー：「スプレッドシートコントロールにデータ検証とルールを追加してください」

結果： スプレッドシートコントロールの検証とカスタムルール用の C# コードが生成されます

---

UWP コードの生成 — ワークフロー

トリガーキーワード：「方法」「スプレッドシートを追加」「コードサンプル」「見せて」「例」「スニペット」「統合」「コンポーネント」「サンプルを作成」「コード」「サンプルコード」「コードを生成」「実装」「プロジェクトに追加」「スプレッドシートを設定」

ステップ 1：ユーザーに出力方法を確認する

コードを表示する前に、次のように質問します。

"How would you like me to provide the solution?

Option 1: Create a new file in skill folder (.codestudio/skills/syncfusion-uwp-spreadsheet-editor/output/)
Option 2: Add code to an existing file in your project (you provide the file path)
Option 3: Just show the code (no files created/modified)

Please select Option 1, 2, or 3."

⏸️ 続行する前に、ユーザーが明示的に選択するまで待ちます。

ステップ 2：参照ファイルからコードを生成する

• 要求された機能に関連する references/*.md ファイルを読み込みます
• 参照ファイル内のスニペットのみを使用して、C# および／または XAML コードを作成します
• まだコードを表示せず、ファイルもまだ作成しません

ステップ 3：ユーザーの選択に対応する

オプション 1： コードを表示 → .codestudio/skills/syncfusion-uwp-spreadsheet-editor/output/（スキルフォルダーのみ）に自動的に保存 オプション 2： ファイルパスを確認 → コードを表示 → 明示的な YES の確認を待つ → コードを適用 → ビルドするか確認 オプション 3： 概要と必要なアセンブリを添えてコードを表示 → 完了（ファイルの作成／変更なし）

• オプション 2 のみ： コードを生成する前に、プロジェクトに references/gettingstarted.md の前提条件とセットアップ要件のセクションに記載された前提条件が揃っているか確認します。不足している場合は、ユーザーの同意を得て追加します。

---

対象外のリクエスト

ユーザーから、このスキルの対象分野に該当しない質問（UWP Spreadsheet、Excel 処理、Syncfusion スプレッドシートコントロールに関係しない質問）があった場合は、次のように回答します。

「入力を処理できません。別の方法で入力してください。」

次のことは行わないでください：

• スプレッドシート／Excel 分野以外のコードを生成する
• スプレッドシート機能に関係しない一般的な UWP のガイダンスを提供する
• 他の Syncfusion コントロールや無関係なフレームワークに関するリクエストを処理する
• スプレッドシート以外の機能を支援する

ユーザーのリクエストがトリガーキーワード「spreadsheet」「Excel」「UI」「code」「Ribbon」「UWP」に一致する場合（スプレッドシート／Excel の文脈に限る）のみ、このスキルとそのワークフローを有効にしてください。

コードリファレンス

すべてのテンプレートと機能スニペットは references/*.md にあります。各ファイルには、エージェントがサンプルの生成時に組み合わせる、特定の内容に絞ったスニペットが記載されています。

フロー：必ず references/gettingstarted.md の「Prerequisites and Setup Requirements」セクションから始め、その後、該当する機能スニペットを結合してください。機能キーワードに一致するものがない場合は、基本的なサンプルのみを返してください。

ファイル	内容
gettingstarted.md	NuGet パッケージの確認、XAML のセットアップ、名前空間、ワークブックの作成／オープン／保存、基本的なスプレッドシートコード
localization.md	対応言語、カルチャ設定、ローカライズされた UI 文字列、RTL サポート、数値／日付／通貨の書式設定、動的な言語切り替え
ribboncustomization.md	カスタムリボンタブの追加、既存のタブへの項目の追加、リボンタブと項目の削除、リボンのカスタマイズパターン
worksheetmanagement.md	シートの挿入／削除／名前変更／非表示／再表示、保護（シートとワークブック）、グリッド線、見出し、ズーム
editing.md	編集の有効化／無効化、プログラムによるセルの編集、セルのロック／ロック解除、編集イベント、データの検証（数値、日付、テキスト、リスト、カスタム数式）、ハイパーリンク
selection.md	選択の有効化／無効化、現在のセルへのアクセス、選択範囲の取得、選択範囲の追加／クリア、現在のセルの移動、GridRangeInfo と IRange の変換、選択イベント、キーボードナビゲーション
findandreplace.md	すべて検索、次を検索、条件付き書式の検索、定数の検索、数式の検索、データの検証の検索、すべて置換、置換操作
formulas.md	セルへの数式の追加、409 種類以上の組み込み関数（データベース、日付／時刻、数学、テキスト、論理、検索、統計、財務、情報）、名前付き範囲、数式計算エンジン
customformula.md	カスタム数式の登録、FormulaEngine へのカスタム数式の追加、カスタム数式ロジックの実装、セルでのカスタム数式の使用
formatting.md	セルの背景色、フォントの書式設定、セルの罫線、セルの配置、テキストの折り返し、セルの結合／結合解除、数値の書式設定、組み込みスタイル、テーブルとして書式設定、書式のクリア
rowsandcolumns.md	行と列の挿入／削除、行の高さと列の幅、行と列の非表示／表示、ペインの固定／固定解除、行と列の自動調整
conditionalformatting.md	セルの強調表示ルール（値、数式、テキスト、期間）、データバー、カラースケール、アイコンセット、比較演算子、書式の種類、期間の種類
interactivefeatures.md	クリップボード操作（切り取り、コピー、貼り付け、プログラムによる貼り付けオプション）、元に戻す／やり直し機能、コンテキストメニューのカスタマイズ、セルのコメント
outline.md	行と列のグループ化／グループ解除、グループの展開／折りたたみ、アウトライン設定、すべてのアウトラインのクリア
shapes.md	**⚠️ グラフィック要素では必須：**チャート（GraphicChartCellRenderer を登録）、スパークライン（SparklineCellRenderer を登録）、画像（実行時に追加）、テキストボックス、図形の選択、図形の選択解除
workingwithsfspreadsheet.md	ワークブック／ワークシートへのアクセス、SpreadsheetGrid へのアクセス、ワークブックの読み込み／アンロードイベント、アクティブシートの設定、セルと範囲へのアクセス、セル値の設定／クリア、表示の更新、スクロール、数式バーの表示設定、ワークブックの変更確認、アラートの抑制、数式計算の一時停止／再開、ポップアップの管理

---

ルール

1. リファレンスのスニペットのみを使用する

   • コードは、references/ 配下の Markdown ファイルのみを使って生成します
   • references/*.md に存在しないプロパティ、イベント、API メソッド、コンポーネント名、パラメーターを推測したり、追加したりしないでください

2. 許可なくファイルを変更しない

   • ユーザーが明示的に選択して確認しない限り、ユーザーのワークスペース内にファイルやフォルダーを作成または変更してはいけません。
   • ユーザーの許可なく、Spreadsheet 以外の StackPanel、ボタン、テキストブロック、ダイアログ、MessageBox、その他の UI 要素を作成してはいけません。

3. 未対応機能の扱い

   • ユーザーが、references/*.md に対応するスニペットがない機能をリクエストした場合は、次のように回答します。 その機能は現在、Syncfusion UWP Spreadsheet コンポーネントではサポートされていません。
   • 対応するスニペットがある場合に限り、最も近い対応機能を提案します
   • 未対応の項目を明示的に列挙し、それらのコードを作成しないでください

4. 書き込み前の検証

   • 書き込む前に、すべてのコードブロックが references/*.md ファイルに由来することを再検証します
   • 検証に失敗した場合は、処理を停止してユーザーに知らせます