AddAnnotationState

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

תיאור

דף זה מתאר את AddAnnotationState ב-PDFlibPas תחת הנושא "Annotations and hotspot links"; שמות API, פרמטרים, שמות מחלקות, שמות קבצים ומילוליים (literals) נשמרים בדיוק כפי שהם מופיעים בספריית Delphi ובנקודות הכניסה של ה-DLL

AddAnnotationState רושם שינוי בסטטוס הסקירה עבור הערה קיימת בעמוד הנבחר (ISO 32000-1 §12.5.6.3). הוא מצרף הערת טקסט מוסתרת שרשומת ה-/IRT שלה מפנה להערת היעד ושרישומי ה-/State וה-/StateModel שלה נושאים את סטטוס הסקירה, בדומה לתהליך העבודה של הסקירה המשמש בחלונית ההערות של Acrobat.

תחביר

Delphi

Function TPDFlib.AddAnnotationState(TargetAnnot: Integer; Const Author: WideString; State, StateModel: Integer): Integer;

פרמטרים

TargetAnnot הוא האינדקס המבוסס-1 של ההערה בעמוד הנבחר שאת הסטטוס שלה מגדירים. Author הוא שם הסוקר השמור ברשומת ה-/T. StateModel בוחר את מודל הסטטוס: 0 = Review, 1 = Marked. State בוחר את הסטטוס בתוך המודל. עבור מודל Review: 0 = None, 1 = Accepted, 2 = Rejected, 3 = Cancelled, 4 = Completed. עבור מודל Marked: 0 = Unmarked, 1 = Marked.

ערכי החזרה

מחזיר את האינדקס המבוסס-1 של הערת הסטטוס החדשה שצורפה ברשימת ההערות של העמוד, או 0 כאשר בוחר הסטטוס או המודל אינו ידוע, כאשר TargetAnnot אינו קיים, או כאשר הערת היעד אינה שמורה כאובייקט עקיף

הערות

הערת הסטטוס נכתבת עם הדגל Hidden מוגדר, כך שהיא אינה מוצגת על העמוד; תוכנות צפייה ב-PDF עם תמיכה בסקירה מציגות אותה בחלונית ההערות במקום זאת. השתמש ב-GetAnnotState וב-GetAnnotStateModel כדי לקרוא בחזרה את הסטטוס שנרשם. דורש PDF 1.5; גרסת המסמך מועלית אוטומטית בעת הצורך