AddCircleAnnotation

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

תיאור

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

תחביר

Delphi

Function TPDFlib.AddCircleAnnotation(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 /Circle, /Rect, /C, /IC (כשהיא ממולאת), /BS, /Border, /CA, ‏/F = 4 (ניתן להדפסה), /M, /CreationDate, /NM, /T, /Contents, ‏/Subj = "Ellipse" ו-/P. זה תואם את מה ש-Adobe Acrobat ו-Foxit מייצרים עבור כלי הסקירה שלהם לאליפסות, כך שזרימות סקירה חיצוניות יכולות לאתר, לערוך, להגיב ולהשיב על ההערה שנוצרה

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