AddPolyLineAnnotation

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

תיאור

מוסיף הערת סימון polyline פתוחה (PDF /Subtype /PolyLine) לדף הנבחר עם רשימת הקודקודים הנתונה. ה-polyline פתוחה — הקוראים אינם מחברים את הקודקוד האחרון בחזרה לראשון — ויכולה לשאת סגנונות קו-סיום שונים בכל נקודת קצה. קישוטי קצה שיש להם פנים (ClosedArrow, Square, Circle, Diamond) אפשר באופן אופציונלי למלא. רכיבי הצבע והאטימות מבוטאים בסקאלה של 0–1; Transparency ניתנת בסקאלה של 0–100 (0 = אטום לחלוטין, 100 = שקוף לחלוטין). הספרייה מעלה את גרסת המסמך ל-PDF 1.5 כאשר הערת PolyLine נפלטת תחת נעילת גרסה-מינימום נמוכה יותר. מוגדר ב-ISO 32000-1 §12.5.6.9.

תחביר

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

פרמטרים

VertexCoords — קואורדינטות הקודקודים כמחרוזת אחת של ערכי x/y לסירוגין, מופרדים ברווחים, פסיקים, נקודות-פסיק או טאבים. למשל: "100 100 200 150 300 100" מגדיר צורת V. דורש לפחות שני זוגות (ארבעה מספרים) ומספר כולל זוגי של מספרים, אחרת הקריאה מחזירה 0.

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

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 אם לא נבחר מסמך, מחרוזת ה-vertex נכשלת בניתוח, או שלא ניתן היה ליצור את ההערה

הערות

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

שדות מתקדמים אופציונליים המתוארים במפרט ה-PDF — /IT (intent, כולל PolyLineDimension) ו-/Measure — אינם נפלטים על ידי נקודת כניסה זו; ניתן לצרפם אחרי היצירה על ידי כתיבתם ישירות אל מילון ההערה

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