Comment utiliser IronPrint avec Cursor
Lorsqu'un agent IA porte un service d'impression C# de System.Drawing.Printing à IronPrint, un paramètre copié inchangé se compile toujours mais change de signification. Une marge de 50 dans l'ancien code signifie un demi-pouce, tandis que ce même 50 dans IronPrint signifie 50 millimètres. Les noms des imprimantes restent également inchangés. Dans nos tests, IronPrint a envoyé une tâche pour un nom d'imprimante qui n'était pas installé à l'imprimante par défaut sans générer d'erreur.
Cursor, qui est basé sur le code source de VS Code, ajoute un agent à l'éditeur. Que la migration conserve ces détails dépend de deux fonctionnalités de Cursor, les liens de documentation fournis à l'agent et les règles de projet engagées dans .cursor/rules. Les exemples s'appliquent aussi bien à un service de bureau de dispatch qui imprime des bordereaux de colis, des étiquettes d'étagère et des avis de retour. Le service construit chaque tâche à partir d'un fichier de configuration en centièmes de pouce, et les invites le déplacent vers IronPrint.
Pour les détails des paramètres impliqués, voir le guide des marges de papier et le guide des noms d'imprimante.
Démarrage rapideOuvrez le dépôt de dispatch, démarrez un nouveau chat Agent et envoyez cette invite.
@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.
Ne collez jamais la clé de licence dans le chat. L'agent de Cursor peut éditer des fichiers et exécuter des commandes shell, il peut donc copier une clé collée dans un message de commit, un fichier source ou un journal de construction. L'invite assigne le programme IRONPRINT_LICENSE_KEY à License.LicenseKey car le seul réglage de la variable laissait IronPrint 2026.10.1 sans licence lors des tests. Dans une sonde sans clé, IronPrint listait les imprimantes et les bacs, et Printer.Print lançait une AggregateException autour d'une LicensingException avant l'envoi d'une quelconque tâche. Le guide de la clé de licence nomme les endroits d'où IronPrint lit effectivement une clé, comme appsettings.json.
Flux de travail minimal (5 étapes)
- Téléchargez la bibliothèque d'impression C# depuis NuGet
- Ajoutez une règle du projet sous .cursor/rules qui contient le lien vers la documentation d'IronPrint
- Consignez dans la règle que les marges sont en millimètres et que les noms d'imprimantes doivent correspondre exactement
- Référencez le code d'impression et le rapport des paramètres validés dans chaque demande
- Comparez les paramètres de chaque tâche avec ce rapport, puis confirmez chaque nom de membre dans la référence d'API
Quel modèle Cursor devriez-vous utiliser pour le travail IronPrint ?
Composer est le propre modèle agentique de Cursor. Le sélecteur de modèle offre également les modèles Grok de SpaceXAI, que Cursor a co-développés, ainsi que des modèles d'OpenAI, Anthropic, Google et d'autres laboratoires. Le test réalisé ci-dessous a utilisé Grok 4.7.
Comment donner à Cursor la documentation IronPrint ?
Mettez le lien de la documentation d'IronPrint dans chaque demande, ou une seule fois dans une règle de projet pour l'ensemble de l'équipe. Le llms.txt d'IronPrint liste chaque guide, exemple et page de dépannage avec un résumé, et llms-full.txt contient des résumés de 33 pages de documentation. En octobre 2026, Cursor liste les dossiers, fichiers, chats passés, le navigateur, les terminaux et les différences Git dans son menu @, de sorte que l'agent reçoit la documentation d'IronPrint sous forme de lien.
La documentation indique qu'un nom d'imprimante nul sélectionne l'imprimante par défaut, et le guide d'IronPrint sur la spécification d'un nom d'imprimante indique qu'un nom non correspondant échoue silencieusement ou génère une erreur. Aucun de ces résultats n'a eu lieu lors des tests, donc la règle du projet enregistre le comportement mesuré à la place.
@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.
Comment écrire des règles de projet qui encodent vos conventions IronPrint ?
Les règles de projet sont des fichiers .mdc conservés dans .cursor/rules et engagés dans le dépôt, de sorte que chaque clone charge les mêmes règles. Le système de règles de Cursor ignore un fichier .md simple là-bas, car il ne contient pas de frontmatter.
Enregistrez la règle suivante sous .cursor/rules/ironprint-despatch.mdc. Avec globs défini et alwaysApply faux, Cursor l'attache lorsqu'un fichier C# sous src/DespatchDesk ou tests est dans le contexte de la demande, et l'exclut des autres demandes.
---
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.
Selon la page des règles de Cursor, l'Agent utilise des règles mais Tab ne le fait pas, et les règles utilisateur sont exclues de l'édition en ligne. Vérifiez les suggestions de Tab et de l'édition en ligne par rapport à la règle à la main.
Comment mappez-vous les paramètres de System.Drawing.Printing vers IronPrint ?
Une demande d'utilisation d'IronPrint ne dit pas quel paramètre IronPrint remplace chaque paramètre PrintDocument. Le tableau ci-dessous donne cette correspondance.
| System.Drawing.Printing | IronPrint |
|---|---|
PrinterSettings.PrinterName | PrintSettings.PrinterName |
PageSettings.PaperSize, dimensionné en centièmes de pouce | L'énum PaperSize, tel que PaperSize.A4 |
PageSettings.Landscape | PaperOrientation.Landscape ou PaperOrientation.Portrait |
PageSettings.Margins, centièmes de pouce, gauche, droite, haut, bas | PaperMargins avec une valeur Margins, millimètres entiers, gauche, haut, droite, bas |
PrinterSettings.Copies | NumberOfCopies |
PageSettings.Color défini sur faux | Grayscale défini sur vrai |
PrintDocument.Print avec un gestionnaire PrintPage | Printer.Print avec un chemin de fichier et les paramètres |
Une marge configurée de 50 est de 12.7 millimètres, qui est arrondie à 13 car le constructeur prend des nombres entiers. Le guide des dimensions de papier d'IronPrint liste l'ordre à quatre valeurs comme haut, droite, bas, gauche, tandis que la documentation XML livrée et une sonde de la bibliothèque donnent toutes deux gauche, haut, droite, bas.
Comment planifier et réaliser une migration vers IronPrint ?
Shift+Tab parcourt les modes du chat. Arrêtez-vous en Mode de planification et envoyez la demande ci-dessous. Cursor sauvegarde le plan dans un fichier markdown, qui peut être édité avant approbation.
@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.
Éditez le plan là où il est erroné. Pour l'approuver, cliquez sur Construire, ou revenez en mode Agent et envoyez cette demande.
@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.
La mention @ironprint-despatch ajoute la règle à la demande par son nom. Le rapport de tâches imprime les paramètres de chaque document sans envoyer de tâche, donc la comparaison fonctionne sur une machine sans imprimante connectée.
Quel élément de Cursor convient à chaque changement ?
Choisissez la fonctionnalité selon l'ampleur du changement. Tab propose le reste d'une édition déjà en cours. L'édition en ligne (Ctrl+K) change le code sélectionné à partir d'une instruction en une phrase. Agent convient à un changement qui s'étend sur plusieurs fichiers ou nécessite une construction. Le Mode de planification vaut l'étape supplémentaire lorsque annuler une mauvaise modification prend plus de temps qu'écrire un plan, et un Agent Cloud gère le travail non supervisé.
Sélectionnez la méthode Print de DespatchJobs et ajoutez-la au chat comme contexte avec Ctrl+Shift+L, ou Cmd+Shift+L sur macOS. Ensuite, envoyez cette demande depuis le mode Agent.
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"`
La seconde commande ne diffère d'un nom d'imprimante installée que par la casse.
Que se passe-t-il lorsque IronPrint ne trouve pas le nom de l'imprimante ?
L'ancien service s'arrêtait avec une erreur. System.Drawing.Printing lançait une InvalidPrinterException avec le message "Les paramètres pour accéder à l'imprimante 'Despatch-A4-01' ne sont pas valides." IronPrint 2026.10.1 adressait la tâche capturée pour ce nom, ainsi que pour trois autres noms, à l'imprimante par défaut. Il s'agissait du nom d'imprimante échantillon du guide des marges d'IronPrint, d'une imprimante installée saisie en minuscules, et de la même imprimante avec un espace final.
Microsoft Print to PDF, qui était l'imprimante par défaut de la machine de test, demande un nom de fichier, donc un service non supervisé se serait arrêté à une boîte de dialogue Enregistrer sous. Le guide des noms d'imprimante indique que chaque nom retourné correspond exactement au nom dans les paramètres de l'imprimante Windows, ce qui fait d'une comparaison ordinale avec Printer.GetPrinterNames le test à effectuer avant chaque tâche.
Comment déboguer deux chemins d'impression qui sont en désaccord ?
Le code du kiosque pour réimpression utilisait déjà IronPrint, et son rapport de paramètres n'est pas d'accord avec le rapport validé sur chaque ligne.
@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.
Le désaccord a deux causes. Le code du kiosque transmet les centièmes directement au constructeur à deux valeurs, de sorte qu'un bordereau de colis rapporte des marges de 50 millimètres, et l'avis de retour répète sa valeur du haut en bas, où la configuration règle 80 centièmes. Il règle également l'orientation paysage pour chaque document car il a été écrit pour des étiquettes d'étagère.
Sortie
Dans une capture de l'exécution avant la correction, le bordereau de colis en portrait envoyé avec une orientation paysage était disposé sur une feuille de 297 par 210 millimètres. Sa page a été mise à l'échelle à 148.4 par 209.9 millimètres, et les autres 148.5 millimètres de la feuille sont restés vides.
Bordereau de colis avec les paramètres du ReprintService non corrigé, tel qu'IronPrint a construit la tâche, capturé dans un fichier à la place d'une imprimante.
Qu'est-ce qu'IronPrint envoie à l'imprimante ?
Aucune des quatre imprimantes sur la machine de test ne termine une tâche non supervisée, donc rien n'a été imprimé sur papier. Pour ces mesures, les exemples du guide des marges et le service migré ont fonctionné inchangés, et seul l'appel final à l'impression Windows a été remplacé. À cet appel, un patch a sauvegardé les pages de chaque tâche et le billet d'impression en tant que fichier XPS, et la file d'attente d'impression n'a rien reçu. Les mesures ci-dessous proviennent de ces fichiers et décrivent ce qu'une imprimante recevrait.
- Marges : des marges de 0, 10, 15, 20, 30 et 50 millimètres ont produit des pages identiques, avec l'image de page remplissant la feuille. La version du bordereau de colis de System.Drawing.Printing a dessiné son image à l'intérieur de marges de 12.7 millimètres.
- Niveaux de gris : pour une page PNG, le paramètre a uniquement changé le billet d'impression et l'image est restée en couleur. Pour une page PDF, l'image elle-même était en niveaux de gris.
- Résolution : un PDF a été rendu selon le paramètre
Dpi, 2479 par 3508 pixels pour A4 à 300. Un PNG a été envoyé à sa propre taille de pixel.
Jusqu'à ce qu'IronPrint applique PaperMargins à la page sous Windows, une mise en page qui a besoin d'un espace blanc sur les bords doit le porter dans le document lui-même.
Entrée
Le service imprime trois fichiers PNG depuis TestData/jobs, slip-1001.png, labels-aisle-07.png et return-2207.png. Chacun est une image à 150 DPI avec une bordure rouge à ses bords.
Sortie
Les PDF ci-dessous montrent une tâche chacun à partir du code écrit par Cursor. Chaque image de page est inchangée et garde la taille de la page capturée.
Bordereau de colis tel qu'IronPrint a construit la tâche, capturé dans un fichier en lieu et place d'une imprimante. La tâche comporte une page A4 en portrait, et son billet d'impression demande deux copies en monochrome.
Étiquettes d'étagère telles qu'IronPrint a construit la tâche, capturé dans un fichier en lieu et place d'une imprimante. Cette page A4 en paysage mesure 297 par 210 millimètres, et le billet d'impression spécifie une sortie en couleur.
Avis de retour tel qu'IronPrint a construit la tâche, capturé dans un fichier en lieu et place d'une imprimante. Sa seule page A5 en portrait mesure 148 par 210 millimètres, et une sortie monochrome est définie dans le billet d'impression.
Comment écrire des tests de régression pour le code d'impression ?
Les Cloud Agents de Cursor fonctionnent sur des machines Ubuntu et l'exemple cible net9.0-windows, donc envoyez cette demande dans un chat Agent local.
@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.
Les tests de refus utilisent des noms d'imprimantes qui ne sont pas installés, donc ils s'arrêtent à la vérification de l'imprimante avant que Printer.Print ne soit appelé.
Le guide des assistants de codage IA prend une tâche IronPrint d'un dossier vide à un résultat vérifié par rapport aux critères de passage écrits.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Cursor a reçu les sept invites dans l'ordre contre le dépôt d'exemple de dispatch. Après l'exécution, de nouvelles constructions Release de chaque commit qui changeait le code ont répété chaque rapport et commande ci-dessous.
- Avant le passage à IronPrint et après, le rapport des tâches a correspondu aux 3 lignes du rapport validé.
- Le rapport de réimpression a correspondu à 0 des 3 lignes avant la correction et 3 des 3 après.
- La commande des imprimantes a listé les quatre imprimantes installées avec leurs bacs et a marqué les deux imprimantes configurées comme non installées.
- Chacune des cinq réponses de documentation de Cursor a cité une page, et aucun fichier n'a été modifié.
- Pour un nom que GetPrinterNames ne renvoie pas, Cursor a répété l'énoncé du guide et a noté que la règle du projet décrit un résultat différent.
- Le plan n'a trouvé aucun remplacement de PrintSettings pour le nom du document et l'a enregistré comme une hypothèse.
- Après le passage, l'application renvoyait uniquement le package IronPrint, et aucun code System.Drawing.Printing ne restait.
- DespatchJobs a conservé ses signatures publiques Describe et Print.
- La commande d'impression a refusé l'imprimante configurée pour les trois types de documents avec le code de sortie 2 et une liste des quatre imprimantes installées.
- La vérification de l'imprimante a également refusé l'imprimante Adobe PDF installée saisie en minuscules ou avec un espace final.
- Avant sa correction, la commande de réimpression envoyait des tâches pour une imprimante configurée manquante et pour "adobe pdf" à l'imprimante par défaut.
- Après la correction, la commande de réimpression a refusé les deux noms. Elle s'est arrêtée avec une exception non gérée, car l'invite 06 ne demandait aucun code de sortie.
- Tous les 9 tests xUnit ont été réussis. Ils provenaient de cinq méthodes de test, et aucun n'a envoyé de tâche.
- L'exécution a laissé la configuration, les données de test et la règle du projet inchangés.
- Chaque construction Release s'est terminée avec 0 avertissement et 0 erreur, et aucun fichier n'a été édité à la main.
- Certaines étapes ont été exécutées différemment de la page. Chaque invite a été envoyée à la main dans un chat de bureau local. L'invite 04 a d'abord été collée sans être envoyée, et a été envoyée après que le script de journalisation de l'exécution a rapporté qu'elle manquait dans le chat. Le plan a été approuvé en envoyant l'invite 04 en Agent, et Build n'a jamais été cliqué. La migration de Cursor avait déjà vérifié le nom de l'imprimante, comme son plan l'avait proposé, donc l'invite 05 a modifié une vérification existante.
Le guide GitHub Copilot conserve également des fichiers d'instructions spécifiques au chemin dans le dépôt, et le guide Google Antigravity teste la page d'impression dans un véritable navigateur. Le registre d'exécution liste la version de l'outil, le modèle, la durée et la machine de test pour chaque guide.
Dépannage
- Comment obtenir les noms d'imprimantes pour une tâche qui va à l'imprimante par défaut au lieu de celle nommée
- Comment ajuster les marges papier lors de la conversion de marges à partir de centièmes de pouce
- Paramètres d'impression C# pour la valeur par défaut de chaque réglage
- Utilisation des clés de licence lorsque le code d'impression généré échoue avec une exception de licence
Des questions ?
Si vous avez des questions, contactez support@ironsoftware.com
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.