כיצד להוסיף הערות וטפסים ל‑PDF ב‑.NET

כיצד להוסיף הערות וטפסים ל‑PDF ב‑.NET

כיצד להוסיף הערות וטפסים ב‑.NET

מדריך זה מציג כיצד להוסיף הערות ושדות טופס אינטראקטיביים למסמכי PDF באמצעות Aspose.PDF FOSS עבור .NET.


דרישות קדם

דרישהפרטים
זמן ריצה.NET 8.0 או גרסה מאוחרת יותר
חבילהdotnet add package Aspose.Pdf.Foss
רישיוןMIT — אין צורך במפתח רישיון

שלב 1: הוסף הערת טקסט

הסברים טקסטואליים מופיעים כהערות דביקות על העמוד.
ספק ריבוע גבול, את תוכן ההערה, ואת כותרת המחבר.
הגדר open: true כדי להציג את ההערה מורחבת כאשר המסמך נפתח.

using var doc = Document.Open(File.ReadAllBytes("input.pdf"));
var page = doc.Pages[1];

page.Annotations.AddTextAnnotation(
    new Rectangle(72, 720, 200, 740),
    contents: "Review this section",
    title: "Editor",
    open: true);

doc.Save("annotated.pdf");

שלב 2: הוסף סימון קישור

הערות קישור יוצרות אזור מלבני שניתן ללחיצה. שלבו Rectangle עם PdfAction.CreateUri קריאה כדי לנווט את המשתמש לכתובת URL חיצונית כאשר נלחץ.

var action = PdfAction.CreateUri("https://aspose.com");
page.Annotations.AddLinkAnnotation(
    new Rectangle(50, 700, 200, 720), action);

שלב 3: הוסף סימוני הדגשה וצורה

הערות הדגשה מסמנות אזורי טקסט עם שכבת‑על שקופה. צורה הערות כגון ריבועים ועיגולים מציירות קווי מתאר גאומטריים על העמוד. שתיהן מקבלות מערכי צבעים ופרמטרים אופציונליים של עובי קו.

page.Annotations.AddHighlightAnnotation(
    new Rectangle(72, 680, 300, 700),
    quadPoints: null,
    color: new double[] { 1, 1, 0 });

page.Annotations.AddSquareAnnotation(
    new Rectangle(72, 640, 200, 680),
    borderColor: new double[] { 0, 0, 1 },
    fillColor: null,
    lineWidth: 1.5);

שלב 4: קריאת ערכי שדות הטופס

שדות AcroForm נגישים דרך Document.Form. חזור על Form.Fields כדי לקרוא את שם כל שדה ואת הערך הנוכחי שלו מבלי לשנות את המסמך.

using var doc = Document.Open(pdfBytes);
foreach (var field in doc.Form.Fields)
{
    Console.WriteLine($"{field.FullName}: {field.Value}");
}

שלב 5: שטח את ההערות

foreach (var annot in doc.Pages[1].Annotations)
{
    annot.Flatten();
}
doc.Save("flattened.pdf");

מחלקות מפתח

ClassPurpose
AnnotationCollectionהוספה וניהול של סימוני עמוד
LinkAnnotationסימון קישור
TextAnnotationסימון פתק דביק
Formגישה לשדה AcroForm
Fieldמחלקת בסיס לשדות טופס
PdfAction.CreateUriיצירת פעולה של קישור URI
AnnotationSelectorסינון סימונים לפי סוג

פתרון בעיות

בעיהפתרון
ההערה אינה נראיתבדוק שהקואורדינטות של המלבן נמצאות בתוך גבולות העמוד
כתובת ה‑URI של הקישור היא nullהקישור עשוי להשתמש בפעולת GoTo — בדוק ActionType
ערך שדה הטופס ריקהשדה עשוי שלא להכיל ערך /V — אמת שם השדה

ראה גם

 עברית