AddAnnotationState

Аннотации и активные ссылки

Описание

Эта страница описывает AddAnnotationState в PDF Library for Delphi в разделе "Аннотации и активные ссылки". Имена API, параметры, имена классов, имена файлов и литералы сохранены ровно в том виде, в каком они приведены в библиотеке Delphi и точках входа DLL.

AddAnnotationState записывает изменение статуса проверки для существующей аннотации на выбранной странице (ISO 32000-1 §12.5.6.3). Он добавляет скрытую текстовую аннотацию (Text annotation), запись /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; версия документа повышается автоматически при необходимости.