AddPolygonAnnotation

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

תיאור

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

תחביר

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

פרמטרים

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

BorderWidth — רוחב הקו של מיתאר הפוליגון, ביחידות הנוכחיות

BorderRed, BorderGreen, BorderBlue — רכיבי RGB (0–1) של צבע המיתאר, נכתבים אל /C

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 — /BE (אפקט גבול, כולל סגנון המיתאר המעונן), /IT (intent, כולל PolygonCloud ו-PolygonDimension) ו-/Measure — אינם נפלטים על ידי נקודת כניסה זו; ניתן לצרפם אחרי היצירה על ידי כתיבתם ישירות אל מילון ההערה

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