AddAnnotationState

Анотації та hotspot-посилання

Опис

На цій сторінці описано AddAnnotationState у PDFlibPas у розділі "Анотації та hotspot-посилання". Імена API, параметри, імена класів, імена файлів та літерали збережені точно так, як вони з'являються в бібліотеці Delphi та точках входу DLL.

AddAnnotationState записує зміну статусу перевірки для існуючої анотації на вибраній сторінці (ISO 32000-1 §12.5.6.3). Він додає приховану текстову анотацію (Text), чий запис /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 не існує, або коли цільова анотація не збережена як непрямий об'єкт (indirect object).

Примітки

Анотація стану записується з встановленим прапорцем Hidden, тому вона не відображається на сторінці; натомість засоби перегляду PDF із підтримкою перевірки виводять її на панелі коментарів. Використовуйте GetAnnotState та GetAnnotStateModel, щоб прочитати записаний статус назад. Вимагає PDF 1.5; версія документа підвищується автоматично, коли це необхідно.