Метод THPDFPage.AddStructureDestinationLink
Добавляет аннотацию ссылки, действие GoTo которой несёт обязательное резервное назначение /D в координатах страницы и массив PDF 2.0 /SD, называющий целевой StructElem по косвенной ссылке, поэтому просмотрщики PDF 2.0 переходят к структурному содержимому, а старые просмотрщики откатываются к указанной странице
Объявление
procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');Модуль
HPDFDoc
Параметры
| Имя | Назначение |
|---|---|
Rectangle | Прямоугольник в единицах страницы, задающий активную область ссылки |
StructElem | Целевой косвенный словарь StructElem (не nil), обычно полученный из AddStructureElement или FindStructureElementForMCID |
FallbackPageIndex | Обязательный индекс страницы, используемый явным назначением /D для просмотрщиков без поддержки PDF 2.0 |
YPos | Необязательная вертикальная позиция для fit-типа /XYZ; передайте отрицательное значение, чтобы оставить её незаданной |
Description | Альтернативное описание, сохраняемое в /Contents аннотации; обязательно при PDFUACompliance |
Возвращаемое значение
Этот метод не возвращает значения
Поведение
- Требует PDF 2.0 (ISO 32000-2) и подчиняется поведению
StrictVersionLock, поскольку/SD— это запись действия из PDF 2.0 - Записывает действие GoTo с
/Dв том же виде[page /XYZ null y null], что иAddGoToLink, плюс одноэлементный массив/SDс косвенной ссылкой на StructElem nilвместо StructElem или выходящий за диапазонFallbackPageIndexприводят к исключению до того, как будет записана какая-либо аннотация или повышена версия- При
PDFUAComplianceпустойDescriptionвызывает исключение согласно PDF/UA-1 §7.18.5