Метод THPDFPage.AddGoToRStructureDestinationLink
Добавляет аннотацию ссылки, действие GoToR которой указывает на структурный элемент во внешнем PDF по его байтовой строке /ID, сохраняя при этом обязательное резервное назначение страницы /D в удалённом файле
Объявление
procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
YPos: Single= - 1; NewWindow: boolean= false; const Description: AnsiString= '');
Модуль
HPDFDoc
Параметры
| Имя | Назначение |
|---|---|
Rectangle | Прямоугольник в единицах страницы, задающий активную область ссылки |
FileName | Непустой путь к внешнему PDF; обратные слэши нормализуются в прямые |
RemoteStructElemID | Непустая байтовая строка /ID целевого StructElem в FileName; должна совпадать с /ID, проставленным на этом элементе через перегрузку IDStr метода AddStructureElement |
FallbackTargetPageIndex | Обязательный индекс страницы в удалённом файле (с нуля), используемый резервным назначением /D; должен быть >= 0 |
YPos | Необязательная вертикальная позиция для fit-типа /XYZ; передайте отрицательное значение, чтобы оставить её незаданной |
NewWindow | При true записывает /NewWindow true, чтобы просмотрщик открыл цель в новом окне |
Description | Альтернативное описание, сохраняемое в /Contents аннотации; обязательно при PDFUACompliance |
Возвращаемое значение
Этот метод не возвращает значения
Поведение
- Требует PDF 2.0 (ISO 32000-2) и подчиняется поведению
StrictVersionLock - Удалённые структурные цели не могут ссылаться на чужой StructElem по указателю, поэтому ISO 32000-2 §12.3.2.3 требует, чтобы первый элемент
/SDбыл байтовой строкой/IDцелевого элемента; записываемая форма literal string совпадает с формой/ID, которуюAddStructureElementсоздаёт для того жеIDStr - Записывает действие GoToR с
/F, обязательным резервным назначением/Dи массивом байтовых строк/SD - Пустой
FileName, пустойRemoteStructElemIDили отрицательныйFallbackTargetPageIndexприводят к исключению до того, как будет записана какая-либо аннотация или повышена версия