AddAnnotationState

التعليقات التوضيحية وروابط النقاط الفعالة

الوصف

تصف هذه الصفحة AddAnnotationState في PDFlibPas تحت موضوع "التعليقات التوضيحية وروابط النقاط الفعالة". يتم الاحتفاظ بأسماء API والمعلمات وأسماء الفئات وأسماء الملفات والقيم الحرفية تمامًا كما تظهر في مكتبة Delphi ونقاط دخول DLL.

AddAnnotationState records a review status change for an existing annotation on the selected page (ISO 32000-1 §12.5.6.3). It appends a hidden Text annotation whose /IRT إدخال يشير إلى التعليق التوضيحي المستهدف والذي /State و /StateModel تحمل الإدخالات حالة المراجعة، بما يتطابق مع سير عمل المراجعة الذي تستخدمه لوحة تعليقات Acrobat.

البنية (Syntax)

Delphi

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

المعلمات (Parameters)

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؛ يتم رفع إصدار المستند تلقائيًا عند الحاجة.