syncfusion-winforms-spreadsheet-editor

Syncfusion Windows Forms スプレッドシートエディター

概要

Syncfusion Spreadsheet コントロールを使用して、Windows Forms で Excel のようなビューアー／エディター UI を作成します。このスキルでは、インタラクティブなスプレッドシート機能を実現する C# Windows Forms コードを生成します。

主な機能

• 作成と編集： ワークブック（.xlsx、.xls、.xlsm）、ワークシート、セル編集、書式設定、スタイル
• 高度な機能： 400 種類以上の数式、名前付き範囲、データの入力規則、ドロップダウンリスト、セルのロック、ワークシートの保護
• UI コンポーネント： SpreadsheetRibbon（ファイル、ホーム、挿入、数式の各タブ）、インタラクティブな編集
• 視覚要素： グラフ（縦棒、折れ線、円、横棒、面、散布図など）、スパークライン（折れ線、縦棒、勝敗）
• ナビゲーション： ハイパーリンク（Web URL、メール、ファイル、ワークブック内の移動）

クイックスタートの例

例 1

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

結果： ワークブックを作成し、セルの値を設定して数式を追加する C# コードを生成します

例 2

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

結果： スプレッドシートコントロールの入力規則とカスタムルール用の C# コードを生成します

---

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

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

STEP 1 — ユーザーのリクエストを分析する

1. ユーザーのリクエストを読み、機能に関するキーワードを抽出します。
2. 関連する reference/*.md ファイルがある場合は、コード生成の唯一の情報源として使用します。
3. 該当する reference ファイルがない場合は、references/getting-started.md のサンプルを使用してコードを生成します。

STEP 2 — 同意と保存先の確認（ファイル操作の前に必ず質問する）

生成または書き込みを行う前に、ユーザーに次の質問をします。

I'm ready to generate your Syncfusion Windows Forms Spreadsheet sample.

Where should I place it?
1) Create a new Form file in the skill's "output" folder (recommended for quick tryout)
2) Add or modify an existing file in your project (please provide the full file path; choose append or replace)
3) Say "Just show me the code" to get the snippet here without modifying any files.

ルール

• ユーザーが選択肢を選ぶか、「コードだけ見せてください」と言うまで、処理を進めないでください。
• ユーザーがファイルの変更を拒否した場合：
  • C# コードをチャットに表示するだけにします
  • ファイルの作成や変更は行いません
• オプション 2 の場合のみ： コードを生成する前に、プロジェクトに references/getting-started.md の前提条件（前提条件とセットアップ要件のセクション）が揃っているか確認します。不足している場合は、ユーザーの同意を得て追加します。

STEP 3 — コードを生成する（参照資料のみに基づく厳格なルール）

• スプレッドシートを作成する際の基本テンプレートとして、必ず getting-started.md の「最小コード」セクションにあるサンプルコードの構造を使用します。
• references/*.md（例：getting-started.md、formulas.md）に記載された API をそのまま使用します。
• API を独自に考案したり、動作を推測したりしないでください。
• いずれの参照ファイルにも記載されていない機能については、利用できないことをユーザーに伝えます。

STEP 4 — 変更を適用する（同意を得た後のみ）

オプション A — スキルのフォルダーに新しいファイルを作成する

• スキルのルートに output/ フォルダーを作成します（まだ存在しない場合）。
• 既定のファイル名：SpreadsheetSample.cs
• ファイルがすでに存在する場合は、次のように質問します。 「SpreadsheetSample.cs という名前のファイルがすでに存在します。上書き、追記、または別の名前を使用しますか？」
• 書き込みを行う前に、ユーザーの判断を待ちます。
• 生成した C# の内容を書き込みます。

オプション B — ユーザーのプロジェクト内のファイルを変更する

1. 次のように質問します。 「変更するファイルを指定してください。完全なファイルパスを入力してください（例：D:\Project\Form1.cs）」
2. 明示的な確認を待ちます。
3. ユーザーがパスを指定せずに「2」（オプション番号）のみを返答した場合は、もう一度質問します。
4. ファイルパスを推測または類推してはいけません。
5. 確認後、要求された変更（上書きまたは追記）を適用します。

オプション C — コードのみを表示する

• 生成した C# コードをチャットに表示します。
• ファイルの作成や変更は行わないでください。

---

対象外のリクエスト

ユーザーからスキルの対象領域に該当しない質問（Windows Forms スプレッドシート、Excel 処理、Syncfusion スプレッドシートコントロールに関連しない質問）があった場合は、次のように応答してください。

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

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

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

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

---

コードの参照（references/ フォルダー内）

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

フロー：必ず references/getting-started.md（Prerequisites and Setup Requirements セクション）から開始し、その後、一致する機能のスニペットを組み合わせてください。機能キーワードが一致しない場合は、基本サンプルのみを返してください。

ファイル	内容
getting-started.md	セットアップ、アセンブリ（必須／任意）、Spreadsheet／SpreadsheetRibbon のインスタンス化、ワークブックの作成／開く／保存、チャート／スパークラインの表示、レンダラーの登録
formulas.md	SetCellValue、名前付き範囲（追加／編集／削除）、409 個の数式関数（データベース、日付／時刻、エンジニアリング、財務、情報、論理、検索、数学、統計、テキスト、Web）
editing.md	編集の有効化／無効化、BeginEdit／EndEdit／ValidateAndEndEdit、セルのロック（Locked プロパティ）、プロパティ、メソッド、イベント（CurrentCellBeginEdit、CurrentCellValueChanged など）
data-management.md	DataTable／DataView／ビジネスオブジェクト／配列からのインポート、DataTable へのエクスポート（ImportDataTable、ExportDataTable、ExcelExportDataTableOptions）、表示の更新（InvalidateCells）
data-validation.md	数値／日付／時刻／テキスト長の検証、リスト検証（ドロップダウン）、カスタム数式による検証、IDataValidation インターフェイス、比較演算子、エラーメッセージ
hyperlinks.md	ハイパーリンクの作成（URL、メール、ファイル、ワークブックのセル参照）、追加／編集／削除、ExcelHyperLinkType 列挙型、IHyperLink インターフェイスのプロパティ
clipboard-operations.md	切り取り／コピー／貼り付け、形式を選択して貼り付け（ExcelPasteType、ExcelPasteOptions）、連続データの入力（下／右／上／左）
conditional-formatting.md	セルの強調表示ルール（値、数式、テキスト、期間）、データバー、カラースケール、アイコンセット、IConditionalFormat インターフェイス
conversion.md	画像（Bitmap／Metafile）、PDF（ExcelToPdfConverter、設定）、HTML（SaveAsHtml）への変換、必須アセンブリ
formatting.md	セルの背景、フォント、罫線、配置（水平／垂直／方向／インデント）、テキストの折り返し、数値形式、組み込みスタイル、テーブルとして書式設定、書式のクリア
freeze-panes.md	FreezeRows、FreezeColumns、FreezePanes、UnfreezePanes、XlsIO の SetFreezePanes／RemoveFreezePanes
localization.md	CurrentUICulture の設定、リソースファイル（.resx）、カルチャ固有のローカライズ、既定の文字列の変更
merge-cells.md	セルの結合／結合解除、CoveredCellInfo、IRange.Merge／UnMerge メソッド、InvalidateCell
overview.md	機能の概要（リボン、編集、数式、データ検証、条件付き書式、チャート、スパークライン、保護、変換、対応ファイル形式）
outline.md	行と列のグループ化／グループ解除、グループの折りたたみ／展開、アウトライン設定（集計行／列の位置）、アウトラインのクリア、OutlineLocation 列挙型
protection.md	ワークシートの保護（Protect／Unprotect、ExcelSheetProtection オプション）、ワークブックの保護、セルのロック／ロック解除、保護状態の確認
rows-columns-operations.md	行と列の挿入／削除、行の高さ／列の幅の設定、行と列の表示／非表示、行／列のサイズ調整
worksheet.md	ワークシートの追加／削除／名前変更、ワークシート間の移動、ワークシートへのアクセス、ワークシートの移動／コピー、ワークシートの表示／非表示、シートタブの表示／非表示、ワークシートのイベント
filtering-and-sorting.md	オートフィルターの有効化／無効化、データのフィルター（数値、テキスト、日付、カスタム）、データの並べ替え（昇順／降順、カスタム並べ替え）、フィルター／並べ替えのクリア
find-and-replace.md	セルの検索（FindAll、FindNext）、置換機能、検索オプション（大文字と小文字を区別、単語単位）、条件による検索、検索結果の移動
selection.md	範囲の選択（単一セル、複数セル、行全体／列全体）、アクティブセルの取得、名前付き範囲の選択、選択変更イベント、選択のクリア
shapes.md	チャート、スパークライン、画像、テキストボックスのインポート、図形の追加／サイズ変更／位置変更、選択した図形へのアクセス、図形の選択／選択解除、GraphicChartCellRenderer、SparklineCellRenderer

---

ルール

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

   • コードは、references/ 配下の Markdown ファイルのみを基に生成してください。
   • references/*.md に記載されていないプロパティ、イベント、API メソッド、コンポーネント名、パラメーターを創作・推測・追加しないでください。

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

• ユーザーが明示的に選択して確認しない限り、ユーザーのワークスペース内にファイルやフォルダーを作成または変更しないでください。
• ユーザーの許可なく、Spreadsheet 以外のボタン、フォーム、ダイアログ、MessageBox、または UI 要素を作成することはできません。

3. 未対応機能の取り扱い

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

4. 書き込み前の検証

   • 書き込む前に、すべてのコードブロックが references/*.md ファイルに由来することを再検証してください。
   • 検証に失敗した場合は、処理を中止してユーザーに伝えてください。