IronPrintとCursorの使い方
AIエージェントがC#の印刷サービスをSystem.Drawing.PrintingからIronPrintに移植する際、設定が変更されないままコピーされるとコンパイルは通るものの意味が変わります。 古いコードでの余白が50の場合、半インチを指しますが、IronPrintでは50ミリメートルを指します。 プリンタの名前もそのまま引き継がれます。 テストでは、IronPrintはインストールされていないプリンタ名のジョブをデフォルトプリンタに送信し、エラーは発生しませんでした。
VS Codeのコードベースに基づくCursorは、エージェントをエディタに追加します。 移行がこれらの詳細を保持するかどうかは、Cursorの2つの機能、エージェントに提供されるドキュメントリンク、および.cursor/rulesにあるプロジェクトルールによって決まります。 これらの例は、梱包スリップ、棚ラベル、および返品ノートを印刷するデスパッチオフィスサービスに適用されます。 サービスは、各ジョブをコンフィギュレーションファイルから百分の一インチ単位で組み立て、プロンプトはそれをIronPrintに移動させます。
関係する設定の詳細については、用紙の余白ガイドとプリンタ名ガイドを参照してください。
クイックスタートデスパッチのリポジトリを開き、新しいエージェントチャットを開始し、このプロンプトを送信してください。
@src/DespatchDesk/ @config/despatch.json
Start by fetching https://ironsoftware.com/print/csharp/llms.txt.
Also read the pages it links on printer names and print settings.
Then add a printers command to Program.cs:
`dotnet run --project src/DespatchDesk -- printers`
Have it show what IronPrint reports on this machine:
- Every name from Printer.GetPrinterNames, in square brackets so spaces show.
- The trays GetPrinterTrays returns for each printer, or "none".
- Whether each printer named in config/despatch.json is in that list.
Have the program read IRONPRINT_LICENSE_KEY from the environment.
Set License.LicenseKey from it before anything else runs.
Don't echo the key or dump the environment.
IronPrint stays on version 2026.10.1.
Send no print jobs, and leave DespatchJobs.cs on System.Drawing.Printing for now.
Run the printers command and show me what it prints.
ライセンスキーをチャットに貼り付けないでください。 Cursorのエージェントはファイルを編集し、シェルコマンドを実行できるので、貼り付けたキーをコミットメッセージ、ソースファイル、またはビルドログにコピーできます。 プロンプトでは、変数だけをセットした場合にはテストでIronPrint 2026.10.1が未ライセンスとなるため、IRONPRINT_LICENSE_KEYをLicense.LicenseKeyに割り当てるようプログラムに指示します。 キーなしでのプローブでは、IronPrintはプリンタとトレイをリストし、Printer.Printはジョブを送信する前にLicensingExceptionの周りにAggregateExceptionを投げました。 ライセンスキーガイドでは、IronPrintがキーを読む場所としてappsettings.jsonなどが挙げられています。
最小限のワークフロー(5ステップ)
- NuGetからC#印刷ライブラリをダウンロードする
- .cursor/rulesの下にIronPrintのドキュメントリンクを含むプロジェクトルールを追加してください。
- 余白がミリメートル単位であること、およびプリンタ名が正確に一致しなければならないことをルールに記録してください。
- 印刷コードと承認済みの設定レポートを各リクエストで参照してください。
- すべてのジョブの設定をそのレポートと比較し、それからAPIリファレンスで各メンバー名を確認してください。
IronPrintの作業にどのCursorモデルを使用するべきですか?
ComposerはCursor独自のエージェントモデルです。 モデルピッカーは、Cursorが共同開発したSpaceXAIのGrokモデルやOpenAI、Anthropic、Google、その他の研究所のモデルも提供します。 以下のテスト実行ではGrok 4.7を使用しました。
CursorにIronPrintのドキュメントをどのように渡しますか?
IronPrintのドキュメントリンクを各リクエストに入れるか、プロジェクト全体のルールとして1回配置します。 IronPrintのllms.txtには各ガイド、例、およびトラブルシューティングページの要約がリストされており、llms-full.txtには33個のドキュメントページの概要があります。 2026年10月現在、Cursorにはフォルダ、ファイル、過去のチャット、ブラウザ、ターミナル、Git差分が@メニューにリストされており、エージェントはリンクとしてIronPrintのドキュメントを取得します。
ドキュメントには、無効なプリンタ名がデフォルトプリンタを選択すること、およびプリンタ名を指定するためのIronPrintのガイドには、不一致名が黙って失敗したりエラーをスローしたりすることが述べられています。 テストではどちらの結果も起こらなかったので、プロジェクトルールは代わりに測定された動作を記録します。
@src/DespatchDesk/Printing/ReprintService.cs
Answer five questions about IronPrint without editing any files:
1. What unit does the Margins class use?
2. Which sides does each value of new Margins(10, 20) set?
3. What does Printer.Print do when PrintSettings.PrinterName is null?
4. What do the docs say about a name GetPrinterNames doesn't return, and does the rule agree?
5. Does NumberOfCopies always produce that many copies?
Base each answer on https://ironsoftware.com/print/csharp/llms.txt or a page linked from it.
Check them against the printers output from the last turn where that helps.
Cite the page behind each answer.
If no page covers a question, say so plainly rather than guess.
IronPrintの規約をエンコードしたプロジェクトルールをどのように書きますか?
プロジェクトルールは、.cursor/rules内に保持され、リポジトリにコミットされる.mdcファイルなので、すべてのクローンが同じルールを読み込みます。 Cursorのルールシステムは、フロントマターのないプレーンな.mdファイルを無視します。
以下のルールを.cursor/rules/ironprint-despatch.mdcとして保存してください。 globsが設定され、alwaysApplyがfalseの場合、CursorはC#ファイルがsrc/DespatchDeskまたはテストのコンテキストにあるときにそれを添付し、その他のリクエストからは外します。
---
description: IronPrint conventions for the despatch printing code
globs: src/DespatchDesk/**/*.cs, tests/**/*.cs
alwaysApply: false
---
Despatch printing code uses IronPrint and follows these rules:
- Print with IronPrint only.
- Reference IronPrint 2026.10.1 from NuGet and use its IronPrint namespace.
- Do not add another printing package.
- Move existing code to IronPrint only when a request asks for it.
- The IronPrint docs index is https://ironsoftware.com/print/csharp/llms.txt.
- Read the license key from the IRONPRINT_LICENSE_KEY variable.
- Keep the license key out of output and files.
- IronPrint Margins uses whole millimeters, as left, top, right, bottom.
- System.Drawing.Printing.Margins uses hundredths of an inch, as left, right, top, bottom.
- new Margins(a, b) sets left and right to a, and top and bottom to b.
- Printer.Print sends the job to the default printer if PrinterName is not an exact installed name.
- Check the name against Printer.GetPrinterNames before every job.
- Run the print and reprint commands only when I ask for them.
- Check settings with the jobs and reprint-jobs reports instead.
- If an IronPrint member is not in the docs, say that and cite the page you searched.
- Never make up an IronPrint member.
Cursorのルールページに従って、エージェントはルールを使用しますが、タブは使用せず、ユーザールールはインライン編集から除外されます。 タブおよびインライン編集からの提案を手作業でルールと照合してください。
System.Drawing.Printingの設定をIronPrintにどのようにマッピングしますか?
IronPrintを使用するリクエストには、どのIronPrint設定が各PrintDocument設定を置き換えるかは示されていません。 以下の表はそのマッピングを示しています。
| System.Drawing.Printing | IronPrint |
|---|---|
PrinterSettings.PrinterName | PrintSettings.PrinterName |
PageSettings.PaperSize、百分の一インチでサイズ指定 | PaperSize列挙型、例えばPaperSize.A4 |
PageSettings.Landscape | PaperOrientation.LandscapeまたはPaperOrientation.Portrait |
PageSettings.Margins、百分の一インチ、左、右、上、下 | PaperMargins、Margins値を持ち、全体がミリメートル、左、上、右、下 |
PrinterSettings.Copies | NumberOfCopies |
PageSettings.Colorはfalseに設定 | Grayscaleはtrueに設定 |
PrintDocument.Print、PrintPageハンドラを持つ | Printer.Print、ファイルパスと設定を持つ |
設定された余白50は12.7ミリメートルで、コンストラクタが整数を取るため13に丸められます。 IronPrintの用紙サイズガイドでは4値の順序を上、右、下、左としていますが、出荷されたXMLドキュメントとライブラリのプローブでは左、上、右、下としています。
どのようにIronPrintへの移行を計画し実行しますか?
Shift+Tabでチャットのモードを循環します。 計画モードで停止し、以下のリクエストを送信してください。 Cursorは計画をマークダウンファイルとして保存しますので、承認前に編集できます。
@src/DespatchDesk/Printing/ @TestData/expected-jobs.tsv
Plan the move of DespatchJobs from System.Drawing.Printing to IronPrint.
Write no code until I approve.
ReprintService already uses IronPrint, so keep it out of this plan.
The plan needs to cover these points:
- Each PrintDocument setting DespatchJobs uses, with its PrintSettings replacement or none.
- How margins in hundredths of an inch become IronPrint margins, including the order of the sides.
- How the jobs command keeps its columns and its values.
Keep config/despatch.json, JobSummary and the public Describe and Print signatures unchanged.
Where something is unclear, write down the assumption you made.
計画が間違っているところを編集してください。 それを承認するには、ビルドをクリックするか、エージェントモードに戻ってこのリクエストを送信してください。
@ironprint-despatch
Go ahead with the approved plan.
TestData/expected-jobs.tsv holds the jobs report the despatch office signed off.
A row matches when all eight columns agree with it.
Then follow these four steps:
1. Run `dotnet run --project src/DespatchDesk -- jobs` and count the matching rows.
2. Move DespatchJobs to IronPrint.
3. Remove System.Drawing.Common from the project file.
4. Build the solution and run the jobs command a second time.
Tell me the match count before and after the move, then show me the diff.
@ironprint-despatchの言及は、リクエストにルールを名前で追加します。 ジョブレポートはドキュメントの設定を印刷しますが、ジョブを送信しないため、プリンタが取り付けられていないマシンでも比較が可能です。
どのCursor機能が各変更に適していますか?
変更の大きさで機能を選択してください。 タブは進行中の編集の残りを提供します。 インライン編集(Ctrl+K)は選択されたコードを1文の命令から変更します。 エージェントは複数のファイルにまたがったり、ビルドが必要な変更に適しています。 計画モードは、間違った変更を元に戻す時間が計画を書く時間より長い場合、もう一つのステップに価値があります。またクラウドエージェントが無人作業を取り扱います。
DespatchJobsのPrintメソッドを選択し、Ctrl+Shift+LまたはmacOSではCmd+Shift+Lでチャットにコンテキストとして追加してください。 次にエージェントモードからこのリクエストを送信します。
Make DespatchJobs.Print refuse a printer that isn't installed:
- Check the name against Printer.GetPrinterNames before anything is sent.
- Use an ordinal, case-sensitive comparison so spaces and case must match too.
- If it's missing, throw an error whose message includes every installed printer name.
- Have the print command show that message and exit with code 2.
Then run these two commands and show me what each one prints:
`dotnet run --project src/DespatchDesk -- print packing-slip`
`dotnet run --project src/DespatchDesk -- print packing-slip --printer "adobe pdf"`
2つ目のコマンドは、インストールされたプリンタ名と大文字小文字のみが異なります。
IronPrintがプリンタ名を見つけられない場合に何が起こりますか?
古いサービスはエラーで停止しました。 System.Drawing.Printingは'Despatch-A4-01'プリンタへのアクセス設定が無効であるとするメッセージ付きのInvalidPrinterExceptionをスローしました。IronPrint 2026.10.1はその名前と他の3つの名前のキャプチャされたジョブをデフォルトプリンタに送信しました。 これらはIronPrintの余白ガイドからのサンプルプリンタ名、小文字で入力されたインストールされたプリンタ、および末尾にスペースを含む同じプリンタでした。
Microsoft Print to PDFはテストマシンのデフォルトプリンタであり、ファイル名を要求するため、無人のサービスは「名前を付けて保存」ダイアログで停止してしまいます。 プリンタ名ガイドには、各返された名前がWindowsプリンタ設定の名前に正確に一致することが記載されており、Printer.GetPrinterNamesとの序数比較がすべてのジョブに対して実行されるべきチェックになります。
2つの異なる印刷パスをデバッグする方法
リプリントキオスクコードはすでにIronPrintを使用しており、その設定レポートは、承認済みのレポートとすべての行で異なっています。
@src/DespatchDesk/Printing/ReprintService.cs @TestData/expected-jobs.tsv
Find out why the reprint report disagrees with expected-jobs.tsv on every row.
The jobs report matches it, and both read config/despatch.json.
Work through these steps before changing any code:
1. Run the reprint-jobs command and the jobs command, and compare them.
2. List each column where reprint-jobs differs, per document type.
3. Explain what ReprintService does to cause each difference.
Then fix ReprintService and keep it on IronPrint.
Give its Print method the same printer check.
Keep the check out of BuildSettings and Describe, since reprint-jobs reads those.
Run reprint-jobs again and tell me how many rows match, before and after the fix.
この不一致には2つの原因があります。 キオスクコードは百分の一インチを直接2値コンストラクタに渡すため、梱包スリップでは50ミリメートルの余白が報告され、返品ノートはそのトップ値が80十分の一インチとして設定されているところで底部に繰り返されます。 また、棚ラベルのために作られたため、すべてのドキュメントで横向きのレイアウトを設定します。
出力
修正前のランからのキャプチャでは、横向きレイアウトで送信されたポートレート梱包スリップが297 x 210ミリメートルの紙面に配置されていました。 そのページは148.4 x 209.9ミリメートルにスケーリングされ、シートの他の148.5ミリメートルは白紙のままでした。
未修正のReprintServiceの設定で動作した梱包スリップは、IronPrintがジョブを構築し、プリンタの代わりにファイルにキャプチャされました。
IronPrintは何をプリンタに送るのか
テストマシン上の4つのプリンタのいずれも無人でジョブを完了しなかったため、紙には何も印刷されませんでした。 これらの測定のために、余白ガイドのサンプルと移行されたサービスは変更なしに実行され、Windows印刷への最終呼び出しだけが置き換えられました。 その呼び出しで、パッチが各ジョブのページと印刷チケットをXPSファイルに保存し、印刷キューには何も受信されませんでした。 以下の測定値はそれらのファイルから取得され、プリンタが受信するものを説明しています。
- 余白: 0、10、15、20、30、50ミリメートルの余白はすべて同一のページを生成し、ページの画像はシートをいっぱいにしていました。 System.Drawing.Printing版の梱包スリップは、12.7ミリメートルの余白内に画像を描きました。
- グレースケール: PNGページでは、設定は印刷チケットを変えただけで、画像はカラーのままでした。 PDFページでは、画像自体がグレーでした。
- 解像度: PDFは
Dpi設定でレンダリングされ、A4で300のときに2479 x 3508ピクセルでした。PNGは自身のピクセルサイズで送信されました。
IronPrintがPaperMarginsをWindows上のページに適用するまでは、レイアウトでエッジに空白が必要な場合は、ドキュメント自体に空白を持たせる必要があります。
入力
サービスはTestData/jobsから3つのPNGファイルを印刷します:slip-1001.png、labels-aisle-07.png、およびreturn-2207.png。 それぞれが150DPIの画像で、エッジに赤い枠があります。
出力
以下のPDFは、Cursorが生成したコードから各ジョブ1つずつを示しています。 各ページ画像は変更されず、キャプチャされたページのサイズを保持しています。
IronPrintがジョブを構築したときの梱包スリップは、ファイルにキャプチャされ、プリンタの代わりに保存されました。ジョブは1枚のA4ポートレートページを持ち、その印刷チケットはモノChromeで2部を要求しています。
IronPrintが構築したジョブとして、プリンタの代わりにファイルにキャプチャされた棚ラベル。このA4ランドスケープページは297 x 210ミリメートルで、印刷チケットはカラープリントを指定しています。
IronPrintが構築したジョブとして、プリンタの代わりにファイルにキャプチャされた返品ノート。単一のA5ポートレートページは148 x 210ミリメートルで、印刷チケットでモノクロ出力が設定されています。
印刷用コードに回帰テストをどのように書くか
CursorのクラウドエージェントはUbuntuマシンで動作し、サンプルはnet9.0-windowsをターゲットにしているため、ローカルエージェントチャットでこのリクエストを送信してください。
@tests/DespatchDesk.Tests/ @TestData/
Write xUnit tests for DespatchJobs and ReprintService. None of them may send a print job.
Cover these cases with tests:
- Describe returns every row of TestData/expected-jobs.tsv, for both classes.
- The returns note reports a 20 mm bottom margin.
- Print throws when the printer is missing from GetPrinterNames.
- That error message names each printer GetPrinterNames returns when the test runs.
- An installed printer name with its case changed is refused as well.
- Hundredths of an inch convert to the millimeters in expected-jobs.tsv.
Link config and TestData from the repo root into the test output, keeping their relative paths.
Leave expected-jobs.tsv as it is, then run dotnet test.
Tell me how many tests passed and how many failed.
拒否テストはインストールされていないプリンタ名を使用するため、Printer.Printが呼び出される前にプリンタチェックで停止します。
AIコーディングアシスタントガイドは、空のフォルダから書かれた合格基準に対してチェックされた結果までのIronPrintタスクを扱います。
プロンプトが実運用で生成したものは何ですか?
Cursorはデスパッチのサンプルリポジトリに対して順番に7つのプロンプトを受信しました。 実行後、コードが変更されたすべてのコミットの最新のリリースビルドは、以下の各レポートとコマンドを繰り返しました。
- IronPrintへの移行前と後で、ジョブレポートはすべて3行の承認済みレポートと一致しました。
- 修正前のリプリントレポートは3行中0行、一致し、修正後には3行中3行、一致しました。
- プリンタコマンドは、トレイとともに4つのインストール済みプリンタをリストし、両方の設定済みプリンタをインストールされていないとしてマークしました。
- Cursorの5つのドキュメント回答のそれぞれはページを引用し、どのファイルも変更されませんでした。
- GetPrinterNamesが返さない名前について、Cursorはガイドのステートメントを繰り返し、プロジェクトルールが異なる結果を記述していることを指摘しました。
- 計画は、ドキュメント名に対するPrintSettingsの代替を見つけられず、それを仮定として記録しました。
- 移行後、アプリはIronPrintパッケージのみを参照し、System.Drawing.Printingのコードは残っていませんでした。
- DespatchJobsは公開DescribeおよびPrintシグネチャを維持しました。
- プリントコマンドは、終了コード2と4つのインストール済みプリンタのリストで、すべての3種類のドキュメントに対して設定済みプリンタを拒否しました。
- プリンタチェックは、Adobe PDFプリンタが小文字で入力されていた場合、および末尾にスペースがある場合にも拒否しました。
- 修正前には、リプリントコマンドは設定されていない欠けたプリンタと'Adobe PDF'のジョブをデフォルトプリンタに送信しました。
- 修正後、リプリントコマンドは両方の名前を拒否しました。 プロンプト06が終了コードを要求していないため、未処理の例外で停止しました。
- 9つのxUnitテストがすべて合格しました。 それらは5つのテストメソッドから来ており、どれもジョブを送信しませんでした。
- 実行は設定、テストデータおよびプロジェクトルールを変更せずに残しました。
- 各リリースビルドは0警告と0エラーで終了し、どのファイルも手動で編集されませんでした。
- 一部のステップはページと異なる方法で実行されました。 すべてのプロンプトは1つのローカルデスクトップチャットで手動で送信されました。 プロンプト04は最初に送信されずに貼り付けられ、ランのロギングスクリプトがチャットに存在しないことを報告した後、送信されました。 プロンプト04をエージェントで送信して計画が承認され、ビルドは一度もクリックされませんでした。 Cursorの移行は既にプリンタ名をチェックしていましたが、計画はそれを提案しており、プロンプト05は既存のチェックを変更しました。
GitHub Copilotガイドもリポジトリに特定のパスの指示ファイルを保持し、Google Antigravityガイドは実際のブラウザで印刷ページをテストします。 ラン記録には、各ガイドのツールバージョン、モデル、期間、およびテストマシンが一覧されています。
トラブルシューティング
- 名付けられたプリンタの代わりにデフォルトプリンタに行くジョブのためのプリンタ名の取得方法
- 余白を百分の一インチから変換する際の紙の余白の設定方法
- 各設定のデフォルト値のためのC#印刷設定
- ライセンス例外で生成された印刷コードが失敗した場合のライセンスキーの使用
質問ありますか?
質問がある場合は、support@ironsoftware.com にお問い合わせください。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。