AddAnnotationState

حاشیه‌نویسی و پیوندهای نقطه اتصال

توضیحات

این صفحه AddAnnotationState را در PDFlibPas در بخش "حاشیه‌نویسی و پیوندهای نقطه اتصال" توصیف می‌کند. نام‌های API، پارامترها، نام کلاس‌ها، نام فایل‌ها و مقادیر دقیقاً به همان صورتی که در کتابخانه دلفی و نقاط ورودی DLL ظاهر می‌شوند، حفظ شده‌اند

تابع AddAnnotationState یک تغییر وضعیت بازبینی برای یک حاشیه‌نویسی موجود در صفحه انتخاب‌شده ثبت می‌کند (ISO 32000-1 بخش 12.5.6.3). این کار را با ضمیمه کردن یک حاشیه‌نویسی متنی پنهان انجام می‌دهد که ورودی /IRT آن به حاشیه‌نویسی هدف اشاره دارد و ورودی‌های /State و /StateModel وضعیت بازبینی را منتقل می‌کنند و با گردش کار بازبینی مورد استفاده پنل نظرات Acrobat تطابق دارد

نحو (Syntax)

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 است؛ نسخه سند در صورت نیاز به‌طور خودکار افزایش می‌یابد