AddLinkToNamedAction
Аннотации и активные ссылки, свойства страницы
Описание
Добавляет на выбранную страницу кликабельный прямоугольник активной области, запускающий именованное PDF-действие. Именованные действия — команды навигации под управлением просмотрщика из ISO 32000-1 §12.6.4.11, Table 194; поддерживаются четыре стандартных имени: NextPage, PrevPage, FirstPage и LastPage. В отличие от AddLinkToPage явный номер целевой страницы не нужен — просмотрщик интерпретирует команду во время выполнения
Типичное применение: кнопки навигации (Next / Previous / Home / End) в колонтитуле, когда цель относительна страницы, которую просмотрщик показывает сейчас
Цвет границы активной области изменяется функцией SetAnnotBorderColor
Синтаксис
Delphi
Function TPDFlib.AddLinkToNamedAction(Left, Top, Width, Height: Double; NamedActionType: Integer; Options: Integer): Integer;DLL
int DLAddLinkToNamedAction(int InstanceID, double Left, double Top, double Width, double Height, int NamedActionType, int Options);Параметры
| Left | Горизонтальная координата левого края интерактивного прямоугольника |
|---|---|
| Top | Вертикальная координата верхнего края интерактивного прямоугольника |
| Width | Ширина интерактивного прямоугольника |
| Height | Высота интерактивного прямоугольника |
| NamedActionType | Выбирает запускаемое именованное действие: 0 = NextPage, 1 = PrevPage, 2 = FirstPage, 3 = LastPage; значения вне диапазона откатываются к NextPage, чтобы писатель всегда выдавал соответствующее спецификации имя /N |
| Options | Битовая маска, управляющая внешним видом ссылки. Бит 0 (значение 1): рисует рамку вокруг прямоугольника активной области. Биты 1–3 задают режим подсветки при щелчке (2 = Invert, 4 = Outline, 8 = Push); если бит подсветки не задан, по умолчанию используется Invert. То же соглашение, что у AddLinkToWeb / AddLinkToPage. |
Примечания
Аннотация совместима с PDF/A — внешние ресурсы не упоминаются; требуется PDF 1.1 или новее