AddSquareAnnotation

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

תיאור

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

תחביר

Delphi

Function TPDFlib.AddSquareAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

פרמטרים

Left — קואורדינטה אופקית של הפינה התחתית השמאלית של מלבן ההערה, ביחידות הנוכחיות

Top — קואורדינטה אנכית של הפינה התחתית השמאלית של מלבן ההערה, ביחידות הנוכחיות

רוחב — רוחב מלבן ההערה

גובה — גובה מלבן ההערה

BorderWidth — רוחב הקו של גבול המלבן, ביחידות הנוכחיות; נכתב גם אל שדה ה-/Border המיושן וגם אל מילון סגנון הגבול /BS

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

הערות

ההערה נפלטת עם קבוצת שדות markup סטנדרטית: ‏/Type /Annot, /Subtype /Square, /Rect, /C, /IC (כשהיא ממולאת), /BS, /Border, /CA, ‏/F = 4 (ניתן להדפסה), /M, /CreationDate, /NM, /T, /Contents, ‏/Subj = "Rectangle" ו-/P. זה תואם את מה ש-Adobe Acrobat ו-Foxit מייצרים עבור כלי הסקירה שלהם למלבנים, כך שזרימות סקירה חיצוניות יכולות לאתר, לערוך, להגיב ולהשיב על ההערה שנוצרה

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