AddLineAnnotation

הערות וקישורים חמים (hotspot links)

תיאור

מוסיפה הערת סימון מסוג קו (PDF /Subtype /Line) בין שתי נקודות קצה בדף שנבחר. לכל קצה אפשר להגדיר סגנון קצה שונה (חץ, ריבוע, עיגול, מעוין, …), ואת גוף הקו אפשר לצייר בכל צבע RGB עם אטימות ניתנת להגדרה. אפשר למלא לפי הצורך עיטורי קצה שיש להם פנים (ClosedArrow, Square, Circle, Diamond). מכיוון שנקודת הכניסה הזו כותבת את מפתח האטימות /CA של הערת PDF 1.4, הספרייה מעלה מסמכים פתוחים בגרסה נמוכה יותר ל-PDF 1.4 לפני השמירה; יעדים נעולים בגרסה נמוכה יותר נדחים בשער התאימות. מוגדר ב-ISO 32000-1 §12.5.6.7

תחביר

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

פרמטרים

StartLeft, StartTop — קואורדינטות נקודת הקצה של תחילת הקו, ביחידות הנוכחיות

EndLeft, EndTop — קואורדינטות נקודת הקצה בסוף הקו, ביחידות הנוכחיות

BorderWidth — רוחב הקו של הקו וקישוטי קצוותיו, ביחידות הנוכחיות

LineRed, LineGreen, LineBlue — רכיבי RGB (0–1) של צבע הקו, נכתבים אל /C

StartStyle, EndStyle — סגנונות קו קצה עבור נקודות הקצה בהתחלה ובסוף בהתאמה; השתמשו באחד מ:

0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash.

ערכים מחוץ לטווח מוצמדים אל 0 (None).

Filled — 1 לפליטת צבע מילוי פנימי (/IC) לקישוטי הקצה, 0 להשארתם ללא מילוי

FillRed, FillGreen, FillBlue — רכיבי RGB (0–1) של צבע המילוי הפנימי של קישוטי הקצה; מתעלמים כאשר Filled הוא 0

Title — שם המחבר הנכתב אל רשומת ה-/T של ההערה; העבירו מחרוזת ריקה כדי לדלג

Contents — גוף ה-popup המשויך להערה; העבירו מחרוזת ריקה כדי לדלג

Transparency — אטימות מבוטאת באחוזי שקיפות (0–100); הספרייה ממירה זאת אל PDF /CA = 1 - Transparency/100 ומצמצמת לטווח

ערך החזרה

1 בהצלחה, 0 אם לא נבחר מסמך או שלא ניתן היה ליצור את ההערה

הערות

את ה-/Rect של ההערה מחשבים אוטומטית משתי נקודות הקצה בתוספת ריפוד יחסי לרוחב הגבול, כך שקישוטי הקצה נשארים בתוך התיבה התוחמת של ההערה. מציגי PDF דורשים שה-/Rect התוחם יכיל את כל הציור הגלוי, אחרת קישוטי הקצה עשויים להיחתך

שדות מתקדמים אופציונליים המתוארים במפרט ה-PDF — /LL (אורך המנהיג), /LLE, /LLO, /Cap, /CP, /CO ו-/Measure — אינם נפלטים על ידי נקודת כניסה זו; ניתן לצרפם אחרי היצירה על ידי כתיבתם ישירות אל מילון ההערה

כדי לדרוס את צבע הקו, הגבול, התוכן או המלבן אחרי היצירה, השתמשו ב-SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents וב-SetAnnotRect